Registre mensagens do WhatsApp no HubSpot a partir de um número com Coexistência

Como uma mensagem do WhatsApp chega a um contato do HubSpot?

Em três etapas. A Meta entrega a mensagem ao destino de webhook que você definiu para o número, que aqui é um nó Webhook do n8n. O workflow busca no HubSpot um contato com o telefone do remetente e cria um se nada corresponder. Depois cria um registro de comunicação com o texto da mensagem e o associa a esse contato.

O HubSpot criou o objeto Communications para esse caso. Ele representa uma mensagem no WhatsApp, LinkedIn ou SMS enviada ou recebida fora do HubSpot, e aparece na linha do tempo do registro como uma ligação ou um e-mail registrado. As propriedades obrigatórias são o tipo de canal, hs_communication_logged_from definido como CRM, o corpo, um responsável e um carimbo de data e hora.

Nada disso exige um app do marketplace do HubSpot. O nó HTTP Request do n8n pode reutilizar a credencial do HubSpot que você já configurou para o nó HubSpot, e a chamada é um único POST por mensagem.

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

As mensagens digitadas no celular também são registradas?

Podem ser, e isso é o que um número com Coexistência acrescenta. Quando alguém da equipe responde pelo app do WhatsApp Business, a Meta envia um eco dessa mensagem enviada para o mesmo destino de webhook. Um workflow que trata tanto as mensagens recebidas quanto os ecos grava os dois lados da conversa na linha do tempo, e quem abre o contato no HubSpot vê o que o cliente perguntou e o que a loja respondeu.

Separe pelo campo do webhook. As mensagens recebidas chegam em messages e as respostas do celular chegam em smb_message_echoes. Registre a primeira como recebida e a segunda como enviada, e a linha do tempo fica em ordem.

As respostas que o próprio workflow envia pela Cloud API já são conhecidas por ele, então registre-as no momento do envio em vez de esperar um webhook.

E o canal de caixa de entrada do WhatsApp do próprio HubSpot?

É outra integração. A caixa de entrada de conversas do HubSpot conecta um número de WhatsApp ao próprio HubSpot, e a base de conhecimento dele diz que o número não pode estar conectado a outra integração do WhatsApp. Ela está disponível no Marketing Hub ou no Service Hub Professional e Enterprise.

Um número conectado pela EasyCoexistence segue o caminho inverso: a Meta encaminha os webhooks para uma URL sua, e o HubSpot recebe os registros pela API. A conversa é respondida pelo celular ou pelo seu workflow, e o HubSpot é o sistema de registro que guarda o histórico junto ao contato, ao negócio ou ao ticket.

A chamada precisa de um escopo de escrita em contatos no app privado ou na credencial que a faz, o mesmo escopo que o workflow já precisa para criar o contato.

Como o workflow deve associar um remetente a um contato?

Pelo número de telefone, normalizado antes da busca. A Meta envia o remetente como dígitos com o código do país e sem o sinal de mais, como 14155550188. Os contatos do HubSpot são digitados à mão, então a mesma pessoa pode estar salva como +1 415 555 0188 ou (415) 555-0188.

O padrão confiável é manter uma propriedade de contato dedicada com o número só em dígitos, preenchê-la quando o workflow criar um contato e buscar por essa propriedade. Buscar direto no campo de telefone de texto livre funciona para contatos criados pelo workflow e deixa passar muitos criados por uma pessoa, o que gera duplicatas.

Quando a busca não retorna nada, crie o contato com o nome do perfil do payload do webhook como primeiro nome e o número só em dígitos nos dois campos. Alguém pode mesclar ou renomear depois, e a conversa já está anexada.

Erros comuns

• Registrar apenas as mensagens recebidas. A linha do tempo passa a mostrar perguntas sem respostas, porque as respostas digitadas no celular chegam como eventos smb_message_echoes.
• Deixar hs_communication_logged_from sem valor. O HubSpot exige que seja CRM ao criar uma comunicação pela API.
• Buscar contatos no campo de telefone bruto. O formato só em dígitos da Meta raramente coincide com o que uma pessoa digitou, e cada falha cria um contato duplicado.

Perguntas frequentes

Continue lendo