Como enviar projetos do Home Planner para o seu CRM

Home PlannerEquipe do aplicativo · October 13, 2026

Conecte o HubSpot, Pipedrive, Bitrix24, Salesforce, Google Planilhas ou seu sistema próprio e envie o projeto completo com ambientes, produtos, preços e planta baixa de uma só vez.

Cada projeto enviado chega ao CRM como um registro único: link do projeto, ambientes, produtos com SKU, quantidades, preços, o valor total e a planta baixa em PDF. Sem copiar capturas de tela nem digitar orçamentos manualmente.

Este guia explica como conectar o HubSpot, Pipedrive, Bitrix24, Salesforce ou Google Planilhas por meio do Zapier e como vincular qualquer outro sistema utilizando a própria URL.

Como funciona

1. Conexão única. Adicione uma conexão no aplicativo: escolha o CRM ou cole a URL do seu sistema próprio.
2. Criação. Planeje os ambientes junto ao cliente e adicione os produtos com os respectivos preços.
3. Envio. Com o projeto aberto, selecione Compartilhar → Enviar para…. O projeto chega ao CRM em poucos segundos.

Antes de começar

Como conectar o CRM usando o Zapier

As etapas são idênticas para qualquer sistema. Apenas a ação do CRM na etapa 5 dentro do Zapier muda — confira a tabela a seguir.

No Home Planner

1. Acesse Configurações → Para empresas → CRM e planilhas. Ou abra qualquer projeto e selecione Compartilhar → CRM e planilhas.
2. Selecione Adicionar conexão e escolha o sistema desejado.
3. Selecione Copiar chave. Essa chave vincula o Zapier à sua conta do Home Planner. Se você não tiver o plano PRO++, isso dará início ao período de teste gratuito de 14 dias.

No Zapier

1. Adicione o Home Planner à conta do Zapier. O aplicativo do Home Planner está em fase de análise no Zapier neste momento. Enquanto a listagem oficial não for concluída, envie um e-mail solicitando um convite — responderemos com o link de acesso. Caso o aplicativo exiba Abrir o Zap pronto, selecione essa opção: o gatilho e a etapa do CRM já estarão configurados.
2. Crie um Zap definindo o gatilho como Home Planner → Project Sent.
3. Conecte uma nova conta e cole a chave no campo Chave de conexão. O Zapier exibirá o nome da conexão exatamente como consta no aplicativo.
4. Teste o gatilho. O Zapier carregará um projeto de exemplo para permitir o mapeamento dos campos antes do primeiro envio real.
5. Adicione a ação do CRM e faça o mapeamento dos campos (consulte a tabela).
6. Ative o Zap. De volta ao aplicativo, o status da conexão mudará para Em funcionamento. Se ainda constar "O Zap ainda não está ativado", desative e ative o Zap novamente.

Como enviar um projeto

1. Abra o projeto e confirme se o orçamento está finalizado: produtos, quantidades e preços devem corresponder ao que o cliente verá.
2. Selecione Compartilhar → Enviar para…. Cada conexão ativa terá a própria linha, como Enviar para o HubSpot.
3. Verifique o resultado. O aplicativo exibirá a mensagem Projeto enviado para o HubSpot detalhando o número de ambientes e produtos. Se o sistema não responder, o aplicativo indicará Tentaremos novamente de forma automática: o Home Planner fará novas tentativas após 1 minuto, 10 minutos e 1 hora.

Envio duplicado do mesmo projeto? Reenviar um projeto sem alterações dentro de um período de 24 horas não gera registros duplicados. Se qualquer elemento for alterado — preço, quantidade ou a planta baixa —, o próximo envio criará um novo registro.

O que consta em cada registro

Os mesmos campos são transmitidos para o Zapier ou para a sua URL própria. Os preços e totais correspondem exatamente ao orçamento do projeto no aplicativo.

Exemplo do campo productsText:

Living room:
- Sofa Oslo (SOFA-1042): 1 × 899.00 = 899.00 USD
  - Cushion (CUSH-17): 2 × 25.00 = 50.00 USD
- Oak flooring (Floor_Oak_01): 1 × 540.00 = 540.00 USD

Total: 1489.00 USD

Como conectar um sistema próprio via URL (webhook)

Para sistemas ausentes na lista ou servidores próprios, o Home Planner envia o registro no formato JSON para um endereço HTTPS.

1. Selecione Adicionar conexão → Outro sistema (sua URL). Defina um nome para o botão (máximo de 24 caracteres) e informe a URL, que deve começar obrigatoriamente com https://.
2. O aplicativo fará um teste de requisição e exibirá, por exemplo: Verificado: resposta 200 em 0,4 s.
3. Recomendado: copie a Chave de assinatura para validar todas as requisições recebidas no seu servidor.

Estrutura da requisição

Valide a assinatura utilizando o corpo bruto da requisição (raw request body), exatamente como foi recebido, antes de qualquer conversão para JSON. Se o corpo for convertido e serializado novamente, a assinatura não corresponderá.

const crypto = require('crypto');

// rawBody: the request body exactly as received (Buffer or string), before JSON parsing.
// Express: app.post('/home-planner', express.raw({ type: 'application/json' }), handler)
function isFromHomePlanner(rawBody, header, secret) {
  if (!header) return false;
  const parts = Object.fromEntries(header.split(',').map(p => p.split('=', 2)));
  if (!parts.t || !parts.v1) return false;
  if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
  const expected = Buffer.from(
    crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex'), 'hex');
  const received = Buffer.from(parts.v1, 'hex');
  return expected.length === received.length && crypto.timingSafeEqual(expected, received);
}

Resposta esperada do servidor

• Qualquer código de status 2xx retornado em até 15 segundos confirma a entrega.
• Ausência de resposta, códigos 5xx, 408 ou 429: o Home Planner tentará novamente após 1 min, 10 min e 1 h, interrompendo o envio ao fim de 2 horas.
• Qualquer outro código 4xx, redirecionamentos ou erros de certificado encerram o processo: a conexão passa para o status de Erro. Redirecionamentos não são seguidos.
• Endereços de redes privadas ou locais não são permitidos, como localhost, 127.*, 10.*, 172.16–31.*, 192.168.* e 169.254.*.

Google Planilhas sem Zapier. É possível usar uma aplicação web do Google Apps Script como URL. A resposta 302 comum para script.googleusercontent.com é considerada como entregue.

Status e erros

Perguntas frequentes

Quanto custa este recurso?

O envio de projetos para CRMs faz parte do plano PRO++. A primeira conexão ativa um período de teste gratuito de 14 dias para quem nunca teve o PRO++. O Zapier possui opções de planos gratuitos e pagos. Desde outubro de 2026, a integração com o Salesforce exige um plano pago do Zapier: consulte as tarifas do Zapier.

O que ocorre quando o teste ou o plano PRO++ expira?

As opções de Enviar para… deixam de aparecer no menu Compartilhar. As conexões criadas permanecem salvas, permitindo que sejam desativadas ou excluídas. Ao assinar o PRO++, elas voltam a funcionar sem necessidade de reconfiguração.

Quantas conexões podem ser criadas?

É possível configurar até 3 conexões, como o HubSpot para gerenciar negócios e o Google Planilhas para registro de preços.

Uma nova chave foi gerada. Por que os projetos pararam de chegar?

A criação de uma nova chave invalida a anterior imediatamente. Cole a chave atualizada no Zapier, desative e ative o Zap novamente.

Alguns produtos não possuem SKU. O que acontece nesses casos?

Eles são enviados acompanhados dos códigos de produto nativos do Home Planner. O aplicativo exibe a quantidade desses itens ao concluir o envio.

O cliente tem acesso a alguma informação?

Não. O registro é transmitido exclusivamente para a conexão configurada (Zapier ou URL própria). O cliente só visualiza o projeto se você compartilhar o link diretamente com ele.

Os dados do meu CRM ficam seguros?

O Home Planner apenas envia informações, sem jamais ler dados do seu CRM. A chave de conexão ou de assinatura pode ser substituída a qualquer momento usando as opções Nova chave ou Nova chave de assinatura.

Aviso sobre marcas registradas. O Home Planner é um software independente e não possui vínculo, patrocínio ou endosso por parte da HubSpot, Inc. O Home Planner também não tem vínculo, patrocínio nem endosso das demais marcas citadas nesta página.