A melhor forma de conectar o WhatsApp ao HubSpot com histórico de conversa no registro de Contato

Conecte o WhatsApp ao HubSpot com uma leitura de QR code e autorização OAuth — sem precisar da Business API. As mensagens sincronizam com a linha do tempo do Contato no HubSpot em segundos, mostradas como atividade de WhatsApp agrupada por dia e por conversa. As chamadas são registradas à parte como Call Engagements. A configuração leva cerca de dois minutos.

Para uma equipe comercial, o registro de Contato é onde um negócio realmente vive — não a caixa de entrada, não o celular de quem vende. Se a conversa de WhatsApp que fechou, travou ou fez perder um negócio não está nesse Contato, o registro está incompleto, por melhor que esteja configurado o resto do HubSpot.

Um gatilho comum para verificar isso: alguém da equipe fecha um negócio quase todo pelo WhatsApp, depois um gestor abre o Negócio no HubSpot esperando ver como aconteceu — e encontra um registro de Contato sem nenhuma conversa, porque nunca houve conexão nenhuma.

Este guia cobre o que a maioria dos guias de configuração deixa de fora: exatamente como o histórico de conversa aparece depois de conectado — em qual objeto ele cai, como é agrupado e o que verificar se não estiver lá. Se você ainda não conectou o WhatsApp ao HubSpot, o passo a passo completo está aqui; se está tentando entender por que as mensagens não chegam ao HubSpot de jeito nenhum, comece por aqui em vez disso.

O que «histórico de conversa no registro de Contato» realmente significa

Uma conversa de WhatsApp se resolve em três lugares no HubSpot: a Linha do tempo do Contato, uma associação com o Negócio correspondente e — especificamente para chamadas — um Call Engagement separado.

• Linha do tempo do Contato — toda mensagem de WhatsApp, enviada e recebida, é registrada aqui como atividade de WhatsApp.
• Associação com o Negócio — a mesma conversa também se anexa ao Negócio correspondente, então quem revisa um Negócio vê o histórico de WhatsApp sem precisar ir ao Contato.
• Call Engagements — chamadas de voz e vídeo do WhatsApp são registradas como seu próprio tipo de objeto, o Call Engagement nativo do HubSpot, e não como atividade de mensagem na Linha do tempo.

As mensagens sincronizam com a Linha do tempo em segundos após serem enviadas ou recebidas. O que você vê ali, porém, é agrupado: a linha do tempo do HubSpot condensa a atividade do mesmo dia de uma conversa em uma única entrada, expansível para ver a troca completa — o mesmo padrão visual que o HubSpot usa para outros tipos de atividade atualizados com frequência, nada exclusivo do WhatsApp. Uma mensagem de dez minutos atrás e outra de hoje de manhã podem aparecer dentro do mesmo cartão recolhido, o que é uma escolha de exibição, não um atraso na sincronização.

Por que isso importa: essa distinção resolve a confusão mais comum com essa integração. Os dados já chegaram — eles simplesmente não são exibidos como uma linha separada por mensagem dentro do cartão da Linha do tempo. Expanda a entrada do dia para ver tudo.

Os sinais de instalações e avaliações reforçam isso além de uma simples afirmação: a página da integração no Marketplace do HubSpot mostra 4,4 estrelas em 53 avaliações e cerca de 3.000 instalações — uma base bem maior do que a mesma integração mostra no Pipedrive ou no Bitrix24, e vale a pena conferir diretamente na própria plataforma do HubSpot em vez de aceitar de bandeja.

Por que o tipo de conta importa mais do que a maioria dos guias de configuração menciona

A maioria das ferramentas de WhatsApp para HubSpot, incluindo as duas com que esta é mais comumente comparada, é construída sobre a WhatsApp Business API — o que significa que um número dedicado, aprovado pela Meta, é pré-requisito antes que qualquer sincronização de Contato possa começar.

• A integração do wati com o HubSpot exige acesso à WhatsApp Business API, disponível só nos planos pagos do wati, além de um plano HubSpot Professional ou superior. Ela é genuinamente capaz — sincronização bidirecional nativa, resumos de conversa por IA, criação automática de tarefas a partir de promessas feitas no chat —, mas nada disso começa antes de haver um número Business API em funcionamento.
• A integração do respond.io com o HubSpot também é baseada na Business API, embora ofereça o WhatsApp Coexistence como caminho mais suave — um número existente pode entrar em modo coexistência em vez de ser totalmente desconectado. Essa é uma diferença real em relação a uma exigência mais rígida de API apenas, mas ainda assim significa verificação Meta Business, não uma simples conexão por QR code.

Por que isso importa: se o objetivo é realmente ver as conversas de WhatsApp *já existentes* da sua equipe — as que quem vende já mantém há meses nos próprios números —, uma exigência de Business API é um muro, não um passo de configuração. Conectar por QR code, como descrito a seguir, é o que torna essas conversas existentes alcançáveis desde o início.

Antes de começar

• Permissões de administrador no HubSpot — para autorizar o app via OAuth.
• Qualquer conta de WhatsApp — WhatsApp comum, o aplicativo Business ou a Business API. Nenhuma aprovação de Business API é necessária para conectar.
• Cerca de dois minutos — uma leitura de QR code mais uma autorização OAuth.

Passo 1: Conecte sua conta de WhatsApp

Escaneie um QR code do espaço de trabalho da TimelinesAI, da mesma forma que você vincularia o WhatsApp Web. Passos completos de configuração aqui se quiser o passo a passo inteiro — este guia continua a partir de uma conexão já concluída.

Por que isso importa: este passo determina quais conversas existem para sincronizar. Conectar seu próprio número traz suas conversas existentes para o escopo; um número compartilhado ou sem responsável fixo precisa de sua própria conexão, tratada separadamente no nosso guia de caixas compartilhadas para equipes do HubSpot.

Passo 2: Autorize o HubSpot via OAuth

Autorize o app do Marketplace do HubSpot com uma conta de administrador. É um fluxo OAuth padrão — sem chaves de API para gerar, sem configuração de desenvolvedor.

Por que isso importa: o escopo do OAuth determina em que a integração pode escrever. Uma autorização de administrador é o que permite que os objetos Contato, Negócio e Call Engagement fiquem todos acessíveis — um usuário autorizador com restrições pode limitar silenciosamente o que de fato sincroniza.

Passo 3: Confirme que a correspondência de contatos está resolvendo corretamente

Cada mensagem é associada a um Contato pelo número de telefone, e um novo Contato é criado automaticamente quando não há correspondência — a mesma lógica de correspondência documentada para o Pipedrive, funcionando aqui sobre o mesmo mecanismo de base.

Por que isso importa: correspondência e exibição são dois mecanismos diferentes. Uma mensagem pode ser corretamente associada ao Contato certo no instante em que chega, mesmo aparecendo ainda dentro de um cartão diário agrupado da Linha do tempo — tentar resolver um problema de «mensagem sumida» duvidando da correspondência, quando o problema real é só o agrupamento de exibição do Passo 1, é um beco sem saída comum.

Passo 4: Decida o que acontece nos Negócios, não só nos Contatos

Confira se a conversa está realmente se associando ao Negócio certo, não só ao Contato — vale a pena um olhar deliberado em vez de supor, especialmente para um Contato com mais de um Negócio aberto.

Por que isso importa: um registro de Contato com vários Negócios pode deixar ambiguidade sobre a qual pertence um fio de WhatsApp. Confirmar isso agora evita que alguém revise o Negócio errado e perca justamente o contexto que o explica. Isso importa mais em vendas baseadas em contas, onde um Contato pode ter uma renovação, um upsell e uma conversa sobre produto novo abertos ao mesmo tempo — três fios de WhatsApp diferentes que precisam cair em três Negócios diferentes, não se misturar em um só.

Passo 5: Ative ações de Workflow se quiser automação

Os Workflows do HubSpot podem enviar uma mensagem de WhatsApp como ação nativa dentro de qualquer automação — uma nova etapa de Negócio, o envio de um formulário, um follow-up agendado. É uma função separada do histórico de conversa, e só vale a pena ativar se você tiver uma automação concreta em mente, tratada em detalhe em outro lugar.

Por que isso importa: ações de Workflow e sincronização da Linha do tempo são sistemas independentes. Ativar um não afeta o outro, e tratá-los como se fossem a mesma coisa na hora de resolver problemas só faz perder tempo.

Passo 6: Confirme que o histórico está realmente chegando ao registro de Contato

Envie uma mensagem de teste e confirme exatamente onde ela aparece — é a única forma de saber que a configuração está funcionando de ponta a ponta, em vez de supor isso a partir de um status de conexão verde.

1. Envie uma mensagem de WhatsApp de um número com correspondência existente no HubSpot.
2. Abra esse registro de Contato no HubSpot.
3. Confirme que a mensagem aparece na Linha do tempo, expandindo a entrada do dia se estiver recolhida.
4. Abra o Negócio associado e confirme que a mesma conversa também está visível ali.
5. Se foi uma chamada, confirme que ela aparece separadamente como Call Engagement, não dentro da atividade de mensagem da Linha do tempo.

Este vídeo mostra a sincronização de ponta a ponta, incluindo como mensagens, anexos e reações chegam ao Contato e ao Negócio.

Problemas comuns e solução

Uma mensagem parece não estar lá. Quase sempre ela está dentro de um cartão diário recolhido da Linha do tempo, não faltando. Expanda a entrada daquele dia antes de supor que a sincronização falhou.

As mensagens caem no Contato errado, ou duplicam um. Esse é o mecanismo de correspondência, não um problema de exibição — a mesma causa raiz documentada para o Pipedrive: registros de Contato já duplicados no HubSpot confundem a correspondência por número de telefone. Remova as duplicatas no HubSpot primeiro.

Uma chamada não aparece onde você esperava. Chamadas são registradas como Call Engagements, um objeto diferente da atividade de mensagem da Linha do tempo usada para textos. Confira a seção de Chamadas do registro de Contato, não a Linha do tempo de mensagens.

Ações de Workflow não estão disparando. Esse é um subsistema separado da sincronização de conversa. Confirme que o próprio Workflow está ativado e que as condições de disparo estão realmente sendo atendidas antes de supor um problema de conexão.

Nada está sincronizando com o HubSpot. Verifique primeiro a conexão de WhatsApp, não o lado do HubSpot — uma conexão de WhatsApp caída parece idêntica a uma falha de sincronização do HubSpot vista de dentro do CRM.

Perguntas frequentes

Preciso da WhatsApp Business API para conectar ao HubSpot?

Não. WhatsApp comum, o aplicativo WhatsApp Business e a Business API funcionam todos. Nenhuma aprovação de Business API é necessária para começar.

Meu número de WhatsApp atual vai funcionar, ou preciso de um novo?

Seu número atual funciona como está, conectado por QR code — nada precisa ser desconectado nem migrado antes.

As mensagens aparecem nos Negócios, ou só nos Contatos?

Nos dois. A mesma conversa é registrada na Linha do tempo do Contato e associada ao Negócio correspondente, então quem revisa qualquer um dos dois registros vê o histórico.

Quão rápido o WhatsApp realmente sincroniza com o HubSpot?

As mensagens sincronizam em segundos após serem enviadas ou recebidas. O que aparece na Linha do tempo é agrupado por dia e por conversa para exibição — um padrão de interface do HubSpot, não um atraso na sincronização real.

As chamadas de WhatsApp aparecem da mesma forma que as mensagens?

Não — chamadas são registradas como Call Engagements do HubSpot, um objeto separado da atividade de mensagem da Linha do tempo usada para conversas de texto.

Existe uma forma de verificar se essa integração é realmente confiável?

A página do Marketplace do HubSpot mostra o número de instalações e a avaliação direto da própria plataforma do HubSpot — uma fonte viva que se atualiza sozinha, diferente de qualquer resumo de terceiros, incluindo este.

Vários membros da equipe podem ver o mesmo histórico de conversa de WhatsApp?

Sim, uma vez no registro de Contato, qualquer pessoa com acesso do HubSpot àquele Contato vê o histórico sincronizado completo — do mesmo jeito que veria qualquer outra atividade da Linha do tempo. Gerenciar quem pode responder de qual número é uma questão separada, de caixa compartilhada, não de visibilidade do histórico.

Uma agência pode usar isso em vários portais do HubSpot?

Cada portal do HubSpot é autorizado separadamente por sua própria conexão OAuth, então uma agência que gerencia vários portais de clientes conecta cada um individualmente, em vez de compartilhar uma única autorização entre contas.

Comece agora

Conecte o WhatsApp ao HubSpot e dê aos seus registros de Contato o histórico de conversa que falta a eles. Comece um teste gratuito — sem cartão de crédito.