A conexão com o HubSpot fica na tela Integrações, no menu lateral, grupo Conta
(endereço /integracoes), dentro da seção CRM.
Cria ou atualiza o contato no HubSpot pelo e-mail, com a empresa e uma nota com o resumo da conversa.
Duas regras valem para todos os CRMs:
- Uma conexão por CRM (um RD Station, um HubSpot, um Pipedrive), valendo para todos os sites da conta. Se você conectar mais de um, o lead qualificado é enviado a todos eles — ao migrar de CRM, desconecte o antigo antes de conectar o novo para não duplicar leads.
- A integração com CRM está disponível nos planos Pro e Full. No plano Grátis o cartão nasce desabilitado, com "O plano Grátis não inclui a integração com CRM" e um botão Solicitar upgrade que abre um e-mail para a Data Stone com o plano atual e o recurso pedido já preenchidos. Se o plano mudar com a tela aberta, o servidor ainda recusa com "Integração com CRM está disponível nos planos Pro e Full."
Só o dono e os administradores da conta conectam integrações.
Conectar
- Na seção CRM, encontre o cartão HubSpot.
- Clique em Conectar HubSpot. Você é levado à tela de autorização do HubSpot.
- Escolha a conta do HubSpot que deve receber os leads e autorize.
- Você volta para
/integracoescom a mensagem HubSpot conectado.
A autorização pede permissão para ler e gravar contatos e gravar empresas.
Se o botão aparecer desabilitado com "Conexão indisponível: o Data Lead ainda não está configurado para o HubSpot. Fale com o suporte.", esta instalação do Data Lead não tem as credenciais do HubSpot — não é um problema da sua conta.
O que é criado na primeira sincronização
O HubSpot identifica o contato pelo e-mail e recusa o envio sem ele. Com o e-mail em mãos:
| Objeto | Quando é criado | Detalhes |
|---|---|---|
| Contato | Sempre | Criado ou atualizado pelo e-mail, nunca duplicado |
| Empresa | Só na primeira sincronização, e só se o lead tiver empresa | Já associada ao contato |
| Nota | Só na primeira sincronização | Resumo da conversa, score com a explicação e o link da conversa |
Nas sincronizações seguintes o contato é atualizado e nada mais é criado — sem isso, cada degrau do funil empilharia uma nota e uma empresa repetidas na sua base.
Uma falha ao criar a empresa ou a nota não derruba o contato: o contato entra do mesmo jeito e a falha vira apenas um aviso no registro interno.
Mapeamento de campos
Clique em Editar mapeamento. Os padrões são:
| Campo do Data Lead | Campo no HubSpot |
|---|---|
| Nome | firstname |
email |
|
| Telefone | phone |
| CPF | datalead_cpf |
| CNPJ | datalead_cnpj |
| Empresa | company |
| Porte | datalead_porte |
| CNAE | datalead_cnae |
| Setor | industry |
| UF | state |
| Score | datalead_score |
| Explicação do score | datalead_explicacao |
| Playbook | datalead_playbook |
| Origem | datalead_origem |
| Mídia | datalead_midia |
| Campanha | datalead_campanha |
| Link da conversa | datalead_conversa |
| Resumo da conversa | datalead_resumo |
Os campos datalead_* são propriedades customizadas: crie-as uma vez no HubSpot ou reaponte
o mapeamento para propriedades que você já usa. Deixe em branco para não enviar o campo.
Abaixo da lista ficam Dono do registro (id do usuário responsável no HubSpot), Funil e Etapa. O HubSpot usa o dono; funil e etapa se aplicam a CRMs que criam negócio.
Restaurar padrões só preenche a tela — nada muda no HubSpot antes de Salvar mapeamento.
Limitação conhecida: o mapeamento vale para o contato. A empresa criada na primeira
sincronização usa campos fixos (datalead_cnpj, industry, state); reapontar UF ou setor no
editor muda só o contato.
Testar a conexão
Testar envia um lead de verdade, com o mesmo mapeamento do envio automático. Procure por
Teste Data Lead (e-mail teste@datalead.datastone.com.br) no HubSpot e apague o registro
depois. O intervalo mínimo entre dois testes é de 30 segundos.
Erros comuns
| Mensagem na tela | O que significa | O que fazer |
|---|---|---|
| A conexão expirou. Conecte novamente. | A autorização não vale mais | Clicar em Reconectar |
| Faltam dados na configuração. | Lead sem e-mail, por exemplo | Rever o playbook para pedir o e-mail |
| O CRM recusou os dados enviados. Confira o mapeamento dos campos. | Uma propriedade apontada não existe ou não aceita o valor | Abrir Editar mapeamento |
| O CRM respondeu num formato que não reconhecemos. Fale com o suporte. | O HubSpot não devolveu o id do contato | Falar com o suporte |
| O CRM recusou por excesso de chamadas; vamos tentar de novo sozinhos. | Limite do provedor | Nada — a fila reenvia |
| O CRM não respondeu. Tente de novo em instantes. | Indisponibilidade momentânea | Tentar mais tarde |
A fila tenta de novo automaticamente só quando o problema é do provedor (limite de chamadas, indisponibilidade ou tempo esgotado): até 14 tentativas, por cerca de 82 horas. Erros de configuração, mapeamento ou autenticação falham já na primeira tentativa e ficam visíveis no cartão.
Desconectar
Desconectar apaga a conexão e a credencial: "Desconectar o HubSpot? Os leads qualificados param de ser enviados para lá." Não há como desfazer — para voltar, é preciso autorizar de novo.
Veja também
Precisa de ajuda?
Fale com o suporte da Data Stone pelo canal combinado com a sua conta. Tenha à mão o estado exibido no cartão do HubSpot e a mensagem de erro completa.