Pular para o conteúdo

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

10 min de leitura
Integrar o HubSpot com agente de IA no WhatsApp: passo a passo

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.

CapacidadeSituaçãoObservação
Mapeamento de propriedades por agenteConfirmadoCada agente tem o seu mapeamento
Objetos mapeáveisNegócio, ticket, contato e objeto personalizadoConforme a configuração da sua conta
Funil (pipeline)ConfirmadoO mapeamento é ligado a um funil do HubSpot
Campos que a IA não preencheConfirmadoVocê escolhe campo a campo
Sincronização de ticketsConfirmado, opcionalAo criar um ticket na conversa, ele é sincronizado
Campos obrigatórios do HubSpotConfirmadoA tela avisa quando faltam dados do contato
Detalhes de autenticação e limites da APIA combinar com o timeNã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.

SintomaCausa provávelCorreção
O ticket não aparece no HubSpotCampo obrigatório sem valorColete o dado na conversa ou preencha no mapeamento
Valor errado em um campoDescrição vaga da propriedadeReescreva a descrição e liste as opções permitidas
Registro duplicadoMapeamento repetido entre agentesRevise qual agente cria cada objeto
IA mexendo em etapa do funilCampo não marcado como "sem IA"Marque o campo para que a IA não o preencha
Contato sem dadosA conversa não coletou o dadoAjuste 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:

  1. Sorteie cinco conversas que geraram registro e compare o resultado com o que o cliente disse.
  2. Procure campos que ficaram vazios com frequência. Em geral, a pergunta do agente precisa mudar ou a propriedade não é relevante.
  3. 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.
  4. Reescreva as descrições das propriedades que geraram valor errado.
  5. 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.

Leia também