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 próprio sistema para enviar projetos com ambientes, produtos, orçamentos e planta baixa em uma única etapa.

Cada projeto enviado chega ao CRM como um registro único: link do projeto, ambientes, produtos com código de referência (SKU), quantidades, preços, o valor total e o arquivo PDF da planta baixa. Sem copiar de capturas de tela e sem digitar orçamentos manualmente.

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

Como funciona

1. Conecte uma única vez. Adicione uma conexão no aplicativo: escolha o CRM ou cole a URL do seu próprio sistema.
2. Crie o projeto. Planeje os ambientes com o cliente e inclua os produtos com os preços.
3. Envie. No projeto aberto, acesse Compartilhar → Enviar para…. O projeto estará disponível no CRM em instantes.

Antes de começar

Conectar o CRM através do Zapier

As etapas de configuração são idênticas para todos os sistemas. Apenas a ação do CRM na etapa 5 do Zapier apresenta variações — consulte a tabela a seguir.

No aplicativo Home Planner

1. Acesse Ajustes → Negócios → CRM e planilhas. Outra opção é abrir qualquer projeto e selecionar Compartilhar → CRM e planilhas.
2. Selecione Adicionar conexão e escolha o sistema desejado.
3. Toque em Copiar chave. Essa chave vincula o Zapier à conta do Home Planner. Sem a assinatura PRO++, essa ação ativa o período de teste gratuito de 14 dias.

No Zapier

1. Adicione o aplicativo Home Planner à conta do Zapier. O Home Planner está em processo de homologação pelo Zapier. Enquanto o aplicativo não for listado oficialmente, solicite o convite por e-mail para receber o link de acesso. Se a opção Abrir o Zap pronto estiver visível no aplicativo, selecione-a para usar o gatilho e a etapa do CRM pré-configurados.
2. Crie um Zap com o gatilho 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 configurada no aplicativo.
4. Realize o teste do gatilho. O Zapier carregará um projeto de exemplo para permitir o mapeamento dos campos antes do primeiro envio real.
5. Inclua a ação referente ao CRM desejado e faça o mapeamento dos campos (consulte a tabela de referência).
6. Ative o Zap. No aplicativo Home Planner, o status da conexão mudará para Em funcionamento. Se o aviso "O Zap ainda não está ativado" continuar sendo exibido, desative e reative o Zap no Zapier.

Enviar um projeto

1. Abra o projeto. Certifique-se de que o orçamento esteja concluído com todos os produtos, quantidades e preços visíveis ao cliente.
2. Selecione Compartilhar → Enviar para…. Cada conexão ativa será listada em uma linha própria, como Enviar para o HubSpot.
3. Confirme o envio. O aplicativo exibirá a mensagem Projeto enviado para o HubSpot indicando a quantidade de ambientes e produtos. Se o sistema não responder, o aviso Tentaremos novamente de forma automática será mostrado: o Home Planner faz novas tentativas após 1 minuto, 10 minutos e 1 hora.

Envio duplicado do mesmo projeto? Se um projeto não alterado for reenviado em até 24 horas, o sistema não criará um registro duplicado. Qualquer modificação no orçamento — preço, quantidade ou estrutura da planta — fará com que o próximo envio gere um novo registro.

Conteúdo de um registro

Os mesmos campos são transmitidos tanto para o Zapier quanto para uma URL própria. Os preços e totais correspondem 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

Conectar um sistema próprio via URL (webhook)

Opção destinada a servidores próprios ou sistemas fora da lista padrão. O Home Planner envia o registro no formato JSON para o endereço HTTPS informado.

1. Acesse Adicionar conexão → Outro sistema (sua URL). Defina o nome do botão (até 24 caracteres) e informe a URL, que deve obrigatoriamente iniciar com https://.
2. O aplicativo faz um teste de envio e exibe o resultado, como Verificado: resposta 200 em 0.4 s.
3. Recomendação: copie a Chave de assinatura e valide todas as requisições no seu servidor.

Estrutura da requisição

Valide a assinatura utilizando o corpo bruto da requisição exatamente como recebido, antes de qualquer conversão para JSON. O corpo processado e reformatado não corresponde à assinatura original.

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 da classe 2xx retornado em até 15 segundos confirma a entrega.
• Caso ocorra tempo limite, código 5xx, 408 ou 429: o Home Planner tenta o reenvio após 1 min, 10 min e 1 h, interrompendo as tentativas após 2 horas.
• Qualquer outro código 4xx, redirecionamento ou falha de certificado interrompe o processo e define o status como Erro. Redirecionamentos de URL não são seguidos.
• Endereços IP privados ou de redes locais não são aceitos (exemplos: localhost, 127.*, 10.*, 172.16–31.*, 192.168.* e 169.254.*).

Google Planilhas sem usar o Zapier. É possível utilizar uma aplicação web do Google Apps Script como URL de destino. A resposta habitual 302 com redirecionamento para script.googleusercontent.com é considerada uma entrega válida.

Status e mensagens de erro

Perguntas frequentes

Qual é o valor do serviço?

A funcionalidade de envio para CRM está incluída no plano PRO++. Para quem nunca utilizou o plano PRO++, a criação da primeira conexão ativa um período de teste gratuito de 14 dias. O Zapier possui opções de planos gratuitos e pagos. A integração com o Salesforce exige um plano pago no Zapier desde outubro de 2026: consulte os preços do Zapier.

O que ocorre quando o período de teste ou a assinatura PRO++ expira?

As opções de envio somem do menu Compartilhar. As conexões criadas permanecem salvas, permitindo a desativação ou exclusão. Ao assinar o plano PRO++, o serviço volta a funcionar mantendo as configurações anteriores.

Existe limite de conexões cadastradas?

É possível criar até 3 conexões (por exemplo: HubSpot para gestão de vendas e Google Planilhas para histórico de orçamentos).

Após gerar uma nova chave, os projetos pararam de chegar. Como resolver?

A criação de uma nova chave invalida a chave anterior imediatamente. Cole a nova chave nas configurações do Zapier e reinicie o Zap (desative e ative novamente).

Como são enviados os produtos que não possuem código SKU?

Esses itens são identificados com códigos de produto do próprio Home Planner. O aplicativo exibe o resumo da quantidade de itens ao concluir o envio.

O cliente tem acesso a esses dados?

Não. As informações são enviadas exclusivamente para o destino configurado (Zapier ou URL própria). O cliente só visualiza o projeto se o link direto for compartilhado com ele.

Os dados do meu CRM ficam seguros?

O Home Planner realiza apenas a transmissão dos projetos, sem fazer a leitura das informações do seu CRM. As chaves de conexão e de assinatura podem ser atualizadas a qualquer momento pelas opções Nova chave ou Nova chave de assinatura.

Aviso de marcas registradas. O aplicativo Home Planner é um produto independente, sem vínculo, patrocínio, endosso ou afiliação com a HubSpot, Inc. O Home Planner também não possui vínculo, patrocínio, endosso ou afiliação com as demais marcas citadas nesta página.