Como enviar projetos do Home Planner para o CRM

Home PlannerEquipe do aplicativo · October 13, 2026

Conecte HubSpot, Pipedrive, Bitrix24, Salesforce, Google Sheets ou o seu próprio sistema para enviar projetos com ambientes, produtos, preços e planta baixa em um único passo.

Cada projeto enviado chega ao CRM em um único registro: o link do projeto, os ambientes, os produtos com SKU, as quantidades, os preços, o total e o PDF da planta baixa. Sem copiar capturas de tela e sem redigitar orçamentos.

Este guia mostra como conectar HubSpot, Pipedrive, Bitrix24, Salesforce ou Google Sheets pelo Zapier e como conectar qualquer outro sistema por URL.

Como funciona

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

Antes de começar

Conectar o CRM via Zapier

As etapas são idênticas para qualquer sistema. Apenas a ação do CRM no passo 5 do Zapier varia — consulte a tabela abaixo.

No Home Planner

1. Acesse Ajustes → Negócios → CRM e planilhas. Ou abra qualquer projeto e selecione Compartilhar → CRM e planilhas.
2. Selecione Adicionar conexão e escolha o seu sistema.
3. Selecione Copiar chave. A chave conecta o Zapier à sua conta do Home Planner. Se não tiver o plano PRO++, esta ação inicia o período de teste gratuito de 14 dias.

No Zapier

1. Adicione o Home Planner à sua conta do Zapier. O aplicativo do Home Planner está em análise pelo Zapier no momento. Enquanto a listagem não for concluída, envie um e-mail para solicitar um convite — responderemos com o link. Se o aplicativo exibir Abrir o Zap pronto, selecione essa opção: o gatilho e a etapa do CRM já estarão configurados.
2. Crie um Zap com o gatilho Home Planner → Project Sent.
3. Conecte uma nova conta e cole o código em Chave de conexão. O Zapier exibirá o nome da conexão do aplicativo.
4. Teste o gatilho. O Zapier carrega um projeto de exemplo para mapear os campos antes do primeiro envio real.
5. Adicione a ação referente ao CRM e mapeie os campos (consulte a tabela).
6. Ative o Zap. De volta ao aplicativo, o status da conexão muda para Em funcionamento. Se a mensagem "O Zap ainda não está ativado" continuar aparecendo, desative e ative o Zap novamente.

Enviar um projeto

1. Abra o projeto. Certifique-se de que o orçamento esteja completo: produtos, quantidades e preços devem ser exatamente os que o cliente verá.
2. Selecione Compartilhar → Enviar para…. Cada conexão ativa possui sua própria linha, por exemplo, Enviar para o HubSpot.
3. Verifique o resultado. O aplicativo exibe Projeto enviado para o HubSpot junto com o número de ambientes e produtos. Caso o sistema não responda, o aplicativo exibe Tentaremos novamente de forma automática: o Home Planner faz novas tentativas após 1 minuto, 10 minutos e 1 hora.

O mesmo projeto foi enviado duas vezes? Um projeto reenviado sem alterações dentro de 24 horas não gera duplicatas. Qualquer modificação realizada — preço, quantidade ou planta baixa — fará com que o próximo envio gere um novo registro.

Conteúdo do registro

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

Exemplo de 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 sistema próprio por URL (webhook)

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

1. Selecione Adicionar conexão → Outro sistema (sua URL). Informe o nome do botão (até 24 caracteres) e a URL. O endereço deve começar com https://.
2. O aplicativo envia uma requisição de teste e exibe, por exemplo, Verificado: resposta 200 em 0.4 s.
3. Recomendado: copie a Chave de assinatura e valide todas as requisições no seu servidor.

A requisição

Verifique a assinatura utilizando o corpo bruto da requisição, exatamente como foi recebido, antes de qualquer conversão para JSON. O corpo processado e serializado novamente não corresponderá à assinatura.

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);
}

A resposta

• Qualquer código 2xx retornado dentro de 15 segundos confirma a entrega.
• Ausência de resposta, código 5xx, 408 ou 429: o Home Planner tenta novamente após 1 min, 10 min e 1 h, interrompendo os envios após 2 horas.
• Qualquer outro código 4xx, redirecionamento ou erro de certificado é definitivo: a conexão muda para 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 Sheets sem o Zapier. Um aplicativo Web do Google Apps Script pode ser utilizado como URL. A resposta 302 habitual para script.googleusercontent.com é considerada uma entrega concluída.

Status e erros

Perguntas frequentes

Quanto custa este recurso?

O envio de projetos para CRM está incluído no plano PRO++. A primeira conexão inicia um teste gratuito de 14 dias para quem nunca usou o PRO++. O Zapier possui planos gratuitos e pagos. A partir de outubro de 2026, a integração com a Salesforce exige um plano pago do Zapier: consulte os preços do Zapier.

O que acontece ao fim do período de teste ou do plano PRO++?

As opções Enviar para… desaparecem do menu Compartilhar. As conexões continuam salvas e podem ser desativadas ou excluídas. Ao assinar o PRO++, elas voltam a funcionar sem necessidade de reconfiguração.

Quantas conexões podem ser criadas?

Até 3 conexões, por exemplo, HubSpot para negociações e Google Sheets para histórico de preços.

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

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

Alguns produtos não têm SKU. O que é enviado?

Eles são enviados com os códigos de produto do próprio Home Planner. O aplicativo informa a quantidade desses itens após o envio.

O cliente visualiza alguma dessas informações?

Não. O registro é enviado exclusivamente para a conexão configurada (Zapier ou sua URL). O cliente só acessa o projeto se o link for compartilhado diretamente com ele.

Os dados do meu CRM ficam seguros?

O Home Planner apenas envia dados — ele nunca acessa ou lê as informações do CRM. É possível substituir a chave ou a chave de assinatura a qualquer momento usando Nova chave ou Nova chave de assinatura.

Aviso de marca registrada. O Home Planner é um aplicativo independente da HubSpot, Inc. e não possui vínculo, patrocínio ou endosso por parte da HubSpot, Inc. O Home Planner é independente de todas as outras marcas citadas nesta página e não possui vínculo, patrocínio ou endosso por parte delas.