Integrar o HubSpot com agente de IA no WhatsApp: passo a passo
Passo a passo para integrar o HubSpot a um agente de IA no WhatsApp: o que preparar, como mapear propriedades por agente, o que a IA não preenche e como testar.

Marlos Carmo
Fundador da Tolky
Atualizado em 16 de novembro de 2026

Compartilhar
Quem atende no WhatsApp e usa o HubSpot como CRM costuma viver o mesmo retrabalho: a conversa acontece num lugar e o registro, em outro. Alguém copia o resultado do atendimento para o ticket, e o histórico fica incompleto.
Integrar o HubSpot a um agente de IA reduz essa cópia: a conversa gera o registro, dentro de regras que você define. Este passo a passo mostra como pensar e configurar essa integração na Tolky, e onde ela termina.
Atualizado em novembro de 2026.
O que significa integrar o HubSpot a um agente de IA?
Integrar o HubSpot a um agente de IA significa que a conversa no WhatsApp passa a gerar e atualizar registros no HubSpot, com os campos que você mapeou, e que o agente pode consultar o contexto do cliente em vez de começar do zero. A integração não substitui o HubSpot: ele continua sendo o seu CRM, e a Tolky cuida da conversa.
A Tolky tem CRM próprio e uma integração nativa com o HubSpot. É a única integração de CRM nativa; para outras ferramentas, como Pipedrive, Slack, Gmail, Google Sheets, Stripe e Notion, existem conectores. A Tolky não tem integração nativa com Salesforce nem com Pipefy. Para a visão geral, veja integração de IA com CRM em empresas e IA sem integração vira FAQ.
O que a integração com o HubSpot faz na Tolky?
Na Tolky, a integração mapeia propriedades entre as conversas do agente e os objetos do HubSpot, com configuração por agente, e sincroniza tickets criados na conversa. A tabela resume o que está confirmado e o que fica a combinar.
| Capacidade | Situação | Observação |
|---|---|---|
| Mapeamento de propriedades por agente | Confirmado | Cada agente tem o seu mapeamento |
| Objetos mapeáveis | Negócio, ticket, contato e objeto personalizado | Conforme a configuração da sua conta |
| Funil (pipeline) | Confirmado | O mapeamento é ligado a um funil do HubSpot |
| Campos que a IA não preenche | Confirmado | Você escolhe campo a campo |
| Sincronização de tickets | Confirmado, opcional | Ao criar um ticket na conversa, ele é sincronizado |
| Campos obrigatórios do HubSpot | Confirmado | A tela avisa quando faltam dados do contato |
| Detalhes de autenticação e limites da API | A combinar com o time | Não descrevemos aqui |
A Tolky também mostra o ID do HubSpot em informações de contato, o que ajuda a conferir se os dois lados falam do mesmo cliente.
O que preparar antes de começar?
Antes de começar, prepare o HubSpot: funis, campos obrigatórios e quem será o responsável pelos registros. A maior parte dos problemas de integração vem de um HubSpot sem organização, e não da integração em si.
- Funis e etapas: defina qual funil recebe os registros vindos do WhatsApp.
- Propriedades: liste as que a conversa pode preencher, como motivo do contato, produto de interesse ou prioridade.
- Campos obrigatórios: se o ticket exige um campo, a conversa precisa coletá-lo ou o HubSpot recusa o registro.
- Responsável: decida quem é o dono dos registros e como as exceções serão tratadas.
- Acesso: quem na sua equipe pode ver e editar a integração na Tolky (a tela tem permissões próprias de visualizar e editar).
Para o lado da conversa, a IA precisa de uma base revisada: veja como treinar um agente de IA com a sua base de conhecimento.
Como é o passo a passo da integração?
O passo a passo tem sete etapas, do desenho ao monitoramento. A configuração inicial é feita com o time da Tolky, porque a tela de integração só aparece para contas que já têm um mapeamento configurado.
Passo 1: defina o que a conversa deve gerar no HubSpot
Escolha poucos resultados claros, como "criar um ticket de suporte" ou "registrar o motivo do contato". Quanto mais simples o primeiro objetivo, mais fácil de testar. Escreva em uma frase o que deve acontecer e em que objeto do HubSpot.
Passo 2: organize o HubSpot
Revise o funil de destino, as etapas e as propriedades que serão usadas. Remova campos duplicados e nomeie com clareza o que a IA vai preencher. Anote quais propriedades são obrigatórias para criar o objeto que você escolheu.
Passo 3: conecte a conta do HubSpot
Combine com o time da Tolky a conexão da sua conta do HubSpot. A conta fica associada à sua operação, e o time orienta sobre as credenciais necessárias e o nível de acesso. Detalhes de autenticação variam conforme a sua conta e são tratados nesse momento, não neste post.
Passo 4: mapeie as propriedades por agente
Cada agente tem o seu mapeamento: você escolhe o objeto (negócio, ticket, contato ou personalizado), o funil e as propriedades. Para cada propriedade, descreva o que ela significa e, se houver valores fixos, liste as opções. Uma descrição clara ajuda a IA a preencher o campo certo com o valor certo. Um agente de suporte e um de vendas costumam ter mapeamentos diferentes.
Passo 5: defina o que a IA não preenche
Para campos sensíveis ou que dependem de decisão humana, como etapa do funil ou responsável, marque que a IA não deve preenchê-los. É o seu controle de risco. Em caso de dúvida, deixe o campo para uma pessoa; dá para liberar depois, quando houver confiança. O post governança de IA no atendimento trata dessa lógica.
Passo 6: decida sobre a sincronização de tickets
Se a sua equipe abre tickets durante a conversa, ative a sincronização para que o ticket criado na conversa seja sincronizado com o HubSpot. Se o HubSpot exigir campos obrigatórios, complete-os no mapeamento; a tela da Tolky avisa quando faltam dados do contato.
Passo 7: teste em simulação, publique e acompanhe
Antes de publicar, rode simulações com situações reais: um pedido simples, uma reclamação e um caso com dado faltando. Confira no HubSpot se o registro apareceu no objeto, no funil e com os campos esperados. Publique para um grupo pequeno, acompanhe por alguns dias e só depois amplie.
Quais erros mais atrapalham a integração?
Os erros mais comuns são campos obrigatórios não coletados, propriedades mal descritas e a IA preenchendo o que deveria ser humano. A tabela relaciona cada um à correção.
| Sintoma | Causa provável | Correção |
|---|---|---|
| O ticket não aparece no HubSpot | Campo obrigatório sem valor | Colete o dado na conversa ou preencha no mapeamento |
| Valor errado em um campo | Descrição vaga da propriedade | Reescreva a descrição e liste as opções permitidas |
| Registro duplicado | Mapeamento repetido entre agentes | Revise qual agente cria cada objeto |
| IA mexendo em etapa do funil | Campo não marcado como "sem IA" | Marque o campo para que a IA não o preencha |
| Contato sem dados | A conversa não coletou o dado | Ajuste o formulário ou a pergunta do agente |
Como a integração se compara a um conector?
A integração nativa é desenhada para o HubSpot e permite o mapeamento por agente; os conectores servem para outras ferramentas, como Pipedrive, Slack, Gmail, Google Sheets, Stripe e Notion. O escopo do que cada conector faz varia por ferramenta; confirme com o time da Tolky antes de depender de uma ação específica.
Se você ainda não usa o HubSpot, a Tolky também funciona como CRM próprio, com funil, oportunidades e atividades. Se está avaliando manter o HubSpot ou trocar, veja a comparação entre Tolky e HubSpot e a página de CRM conversacional.
Como acompanhar a integração depois de publicar?
Depois de publicar, acompanhe a integração por amostragem: abra alguns registros criados a partir de conversas e confira se objeto, funil e campos estão como o esperado. A rotina é curta e evita que um erro pequeno se repita por semanas.
Uma checagem semanal, no início, costuma bastar:
- Sorteie cinco conversas que geraram registro e compare o resultado com o que o cliente disse.
- Procure campos que ficaram vazios com frequência. Em geral, a pergunta do agente precisa mudar ou a propriedade não é relevante.
- Leia as conversas em que a IA passou para uma pessoa e veja se um campo "sem IA" poderia ser liberado, ou o contrário.
- Reescreva as descrições das propriedades que geraram valor errado.
- Reveja quem tem permissão de visualizar e editar a integração na Tolky.
Avise o time de vendas ou de suporte sobre o que passou a chegar automaticamente ao HubSpot, para que ninguém duplique o registro à mão. Para medir o efeito no atendimento, veja taxa de resolução por IA: como medir. Um bom sinal é a equipe parar de copiar dados entre sistemas e passar o tempo no que exige conversa humana.
Onde a Tolky entra, e o que ela não faz?
A Tolky entra como a camada de conversa: agentes de IA no WhatsApp que atendem, coletam dados e registram o resultado no HubSpot dentro das regras que você definiu. Ela não troca o HubSpot e não promete preencher todo campo sem revisão.
Também vale dizer o que a integração não promete: não afirmamos aqui sincronização bidirecional de todos os objetos nem a leitura de qualquer propriedade do HubSpot durante a conversa. Para o seu caso específico, peça uma demonstração no seu HubSpot. A plataforma agrega mais de 5 milhões de mensagens com IA por mês e mais de 67% de resolução com IA, números da plataforma, não resultado de um cliente. Veja a solução de atendimento no WhatsApp.
Perguntas frequentes
A Tolky tem integração nativa com o HubSpot?
Sim. O HubSpot é a única integração de CRM nativa da Tolky. Para outras ferramentas, há conectores.
Posso mapear campos diferentes para cada agente?
Sim. O mapeamento é por agente, então um agente de suporte e um de vendas podem usar objetos, funis e propriedades diferentes.
Quais objetos do HubSpot entram no mapeamento?
Negócio, ticket, contato e objeto personalizado, conforme a configuração da sua conta. Confirme com o time quais fazem sentido para o seu fluxo.
Posso impedir que a IA preencha certos campos?
Sim. Você marca, campo a campo, o que a IA não deve preencher, e deixa esses campos para uma pessoa.
O ticket criado na conversa vai para o HubSpot?
Se a sincronização de tickets estiver ativa, sim: ao criar um ticket na conversa, ele é sincronizado com o HubSpot. A sincronização é uma opção que você liga ou desliga.
Preciso do HubSpot para usar a Tolky?
Não. A Tolky tem CRM próprio e pode funcionar sozinha ou conviver com o HubSpot.
Conclusão
Integrar o HubSpot a um agente de IA no WhatsApp funciona melhor quando você começa pequeno: um agente, um objeto, poucos campos, simulação antes de publicar. A Tolky entrega a integração nativa e o mapeamento por agente; o HubSpot segue como o seu CRM. Vamos conversar?
Veja os planos, conheça o CRM da Tolky ou fale com o time →
Compartilhar
Tags
- integrar HubSpot com agente de IA no WhatsApp
- integração HubSpot WhatsApp
- HubSpot e IA conversacional
- #AI CRM conversacional
- tickets HubSpot automáticos
- mapeamento de propriedades HubSpot
- CRM integrado ao WhatsApp
- integração nativa HubSpot
Sobre o autor

Marlos Carmo
Fundador da Tolky
Marlos Carmo é empreendedor em IA e fundador da Tolky, a infraestrutura e AI CRM da era conversacional que unifica atendimento inteligente, multicanalidade (como WhatsApp e voz), CRM vivo e inteligência operacional em um único ecossistema. É finalista do SXSW Innovation Awards e integrante do Francesco's Economy, rede global de jovens empreendedores com foco em inovação e impacto social. Atua conectando Inteligência Artificial e transformação digital em projetos para grandes organizações.
Próximo passo
Quer levar isso para a sua operação?
A Tati, assistente de IA da Tolky, entende o seu cenário em poucas perguntas, sugere o melhor caminho e te conecta com uma pessoa do time levando todo o contexto.


