Integração da WhatsApp Business API com seu CRM (Configuração Funcional)

Aqui está uma realidade frustrante: as conversas no WhatsApp fluem, os representantes respondem, os leads demonstram interesse e, mesmo assim, 40% desses contatos nunca aparecem no CRM. Não por uma limitação técnica, mas porque a integração foi configurada de forma incorreta e falha silenciosamente.

Um gerente de RevOps em uma empresa B2B SaaS descobriu isso ao puxar um relatório do WhatsApp e comparar com o HubSpot. A diferença era real e estava se acumulando há dois meses. A correção levou uma tarde, depois que ela identificou em qual caminho estava e o que havia sido configurado errado.

Este guia apresenta as três configurações principais de integração: ManyChat para HubSpot, Respond.io para HubSpot e webhook para qualquer CRM, com o mapeamento de campos específico, a lógica de deduplicação e as etapas de atribuição UTM que cada uma exige.

Escolhendo o Caminho de Integração

Antes de mexer em qualquer configuração, escolha o caminho. A decisão depende da sua toolstack atual e do seu CRM. Segundo a documentação oficial da WhatsApp Business Platform da Meta, a Business API suporta três níveis de autenticação com diferentes capacidades de envio de mensagens: o caminho de integração determina qual nível se aplica ao seu caso de uso. Se você ainda está decidindo qual plataforma de chat se encaixa melhor no seu fluxo de trabalho, a comparação entre Respond.io e ManyChat para vendas B2B detalha os trade-offs com clareza.

Se você usa HubSpot e constrói fluxos ativamente no ManyChat, siga o Caminho A. Se você opera todas as atividades de chat pelo Respond.io, o Caminho B oferece uma sincronização mais profunda. Se o seu CRM não é o HubSpot, o Caminho C é sua opção.

Caminho A: ManyChat para HubSpot

Ativando a Integração

No ManyChat, acesse Configurações, Integrações e depois HubSpot. Você vai precisar de:

• Uma conta HubSpot com acesso a Contatos
• Função de administrador no ManyChat
• Chave de API do HubSpot ou conexão OAuth (OAuth é o recomendado)

Clique em Conectar, autorize a conexão com o HubSpot e confirme o portal vinculado.

Permissões Necessárias no HubSpot

O usuário do HubSpot que faz a conexão precisa, no mínimo: Contatos (visualizar e editar), Propriedades (visualizar) e Workflows (visualizar). Se você usa workflows do HubSpot acionados por dados do ManyChat, adicione Workflows (editar).

Mapeando Campos de Contato

Os dados do assinante do ManyChat mapeiam para propriedades de contato do HubSpot. Veja o mapeamento padrão e o que você vai querer personalizar:

Para mapear um atributo customizado, acesse ManyChat, Integrações, HubSpot e Mapeamento de Campos, e adicione uma nova linha. A propriedade do HubSpot precisa existir antes de ser mapeada. Crie-a primeiro no HubSpot em Contatos, Propriedades.

Atribuição de Responsável pelo Contato

O ManyChat pode atribuir um responsável de contato no HubSpot por round-robin ou por responsável fixo. Configure isso em Configurações de integração com HubSpot e Responsável padrão. Para times com roteamento por território, você vai precisar de um workflow do HubSpot acionado na criação do contato para reatribuir com base em empresa ou região.

O Que Sincroniza e o Que Não Sincroniza

O ManyChat sincroniza propriedades de contato e, opcionalmente, envia uma nota com o resumo da conversa. Ele não sincroniza transcrições completas de conversas com o HubSpot de forma nativa. Para histórico de conversa, você precisa do Caminho B ou de uma solução via webhook.

A integração também não envia atualizações de contato em tempo real para cada mensagem. Ela é acionada por eventos específicos no fluxo (normalmente no opt-in ou quando uma etapa do fluxo dispara a ação do HubSpot).

Caminho B: Respond.io para HubSpot

Conectando pelo Módulo Nativo HubSpot do Respond.io

No Respond.io, acesse Configurações, Integrações e HubSpot. A autenticação é feita via OAuth. O Respond.io exige uma conta de administrador no HubSpot para a conexão inicial.

Uma vez conectado, o Respond.io cria uma sincronização bidirecional: contatos criados no Respond.io aparecem no HubSpot e contatos já existentes no HubSpot podem ser puxados para as conversas do Respond.io.

Mapeamento de Lifecycle Stage

O Respond.io pode atualizar os lifecycle stages do HubSpot com base em eventos de conversa. Configure isso nas configurações de integração com o HubSpot:

• Novo contato pelo WhatsApp: Lead
• Perguntas de qualificação concluídas: Marketing Qualified Lead
• Reunião agendada: Sales Qualified Lead

Configure esses mapeamentos para disparar automaticamente quando a etapa relevante do fluxo for concluída.

Deduplicação de Contatos por Número de Telefone

O Respond.io usa o número de telefone como chave primária de deduplicação ao sincronizar com o HubSpot. Se um contato já existir no HubSpot com o mesmo número de telefone formatado em E.164, o Respond.io atualiza o registro existente em vez de criar um duplicado.

O detalhe: o formato do número de telefone precisa ser exatamente igual. Se o HubSpot tem "+1 (555) 000-0000" e o Respond.io envia "+15550000000", a deduplicação não vai funcionar. Padronize todos os números para o formato E.164 nos dois sistemas. No HubSpot, você pode usar um workflow com a ação "Formatar número de telefone" para normalizar os registros existentes.

Opções de Sincronização do Histórico de Conversa

O Respond.io pode enviar o histórico de conversa para o HubSpot como uma nota no registro do contato. Ative isso em Integração com HubSpot, Opções de Sincronização e Registrar Conversas. Cada conversa se torna uma nota com data e hora e o histórico completo.

Essa é a maior vantagem do Caminho B sobre o Caminho A para times que querem que os representantes tenham contexto antes de ligar para um lead originado pelo chat.

Caminho C: Webhook para Qualquer CRM

Estruturando o Payload do Webhook do Respond.io

O Respond.io suporta webhooks de saída acionados por eventos de conversa (novo contato, mensagem recebida, etapa de fluxo concluída). Configure-os em Configurações, Desenvolvedor e Webhooks.

Um exemplo de payload quando um contato conclui uma etapa de fluxo de qualificação:

{
  "event": "contact.updated",
  "contact": {
    "id": "abc123",
    "phone": "+15550001234",
    "firstName": "Jane",
    "lastName": "Chen",
    "customAttributes": {
      "company_size": "50-200",
      "use_case": "sales_automation",
      "timeline": "Q2_2026",
      "source_ad_id": "23849572894"
    },
    "createdAt": "2026-04-18T09:32:00Z",
    "optInTimestamp": "2026-04-18T09:31:47Z"
  },
  "conversation": {
    "id": "conv_xyz789",
    "channel": "whatsapp"
  }
}

Construindo o Zap no Zapier ou no Make

No Zapier:

1. Gatilho: Webhooks by Zapier, Catch Hook
2. Copie a URL do webhook para o Respond.io
3. Envie um contato de teste pelo fluxo para preencher os dados de exemplo
4. Ação: Criar ou Atualizar Contato no seu CRM
5. Mapeie os campos do payload do webhook para os campos do CRM
6. Adicione uma etapa de filtro: só avance se o campo phone não estiver vazio

No Make (antes chamado de Integromat), use o módulo Webhooks como gatilho e depois roteie para o módulo Criar/Atualizar Contato do seu CRM.

Lidando com o Problema de Formato do Número de Telefone

O WhatsApp sempre envia números de telefone no formato E.164. A maioria dos CRMs aceita E.164, mas alguns (especialmente o Salesforce) têm requisitos de formato local. Adicione uma etapa de formatação de texto no Zapier ou no Make para remover o prefixo do código do país ou reformatar conforme necessário antes da ação de CRM ser disparada.

Atribuição UTM e de Origem

Quando um contato entra no seu Funnel pelo WhatsApp a partir de um anúncio da Meta, os dados de origem do anúncio acompanham o contato, mas só se você tiver conectado o handoff corretamente. Para a configuração completa de anúncios que alimenta esse pipeline de atribuição, consulte o guia sobre campanhas de anúncios Click-to-WhatsApp.

A Meta passa um parâmetro ad_id e campaign_id quando a conversa é iniciada por um anúncio Click-to-WhatsApp. O Respond.io captura esses dados automaticamente nos metadados da conversa. O ManyChat os captura como variáveis de User Input se você adicionou a etapa de origem de anúncio da Meta ao fluxo.

Para obter atribuição por campanha no seu CRM:

1. Armazene ad_id, ad_set_id e campaign_id como atributos customizados na sua plataforma de chat
2. Inclua-os no mapeamento de campos ou no payload do webhook para o CRM
3. Crie uma propriedade customizada no HubSpot chamada "WhatsApp Campaign Source" mapeada para campaign_id
4. Construa um relatório no HubSpot filtrado por "WhatsApp Campaign Source" para ver o Pipeline por campanha

Isso fornece uma visão simples de campanha para Pipeline sem precisar de uma ferramenta de atribuição de terceiros.

Regras de Deduplicação

Quando o mesmo número de telefone entra no fluxo múltiplas vezes (comum em campanhas de retargeting), a integração precisa de uma regra clara. Isso é especialmente relevante quando a automação de captura de leads puxa contatos de vários canais simultaneamente.

A ordem de prioridade:

1. Combine pelo número de telefone primeiro (normalizado em E.164)
2. Se encontrou correspondência: atualize o registro existente, não crie outro
3. Se não encontrou correspondência: crie um novo contato, sinalize como novo lead
4. Se o telefone coincide mas o e-mail é diferente: atualize o e-mail só se o registro existente não tiver e-mail

No HubSpot, a deduplicação nativa só corresponde por e-mail por padrão. Para deduplicação por telefone, use um workflow do HubSpot: dispare na criação do contato, pesquise o contato existente pelo número de telefone e, se encontrado, mescle os registros usando uma etapa de código customizado ou um aplicativo de deduplicação de terceiros como o Dedupely.

No Salesforce, use regras de duplicação em Configuração, Gerenciamento de Duplicatas, com uma regra de correspondência no campo Telefone. Um estudo da Gartner sobre qualidade de dados em CRM identificou que a baixa qualidade de dados custa às organizações em média $12,9 milhões por ano: a deduplicação por telefone é uma das correções mais eficientes em termos de custo.

Testando a Integração

Execute esta sequência de 6 etapas antes de ir ao ar:

1. Passe você mesmo pelo fluxo completo do WhatsApp usando um número de telefone de teste
2. Verifique sua plataforma de chat (ManyChat ou Respond.io) para confirmar que o contato foi criado com todos os atributos customizados preenchidos
3. Aguarde 2 a 3 minutos e verifique no CRM se um novo contato com o número de telefone correspondente foi criado
4. Verifique se cada campo mapeado chegou com o valor correto, especialmente os atributos customizados
5. Confirme que o responsável pelo contato foi atribuído corretamente
6. Envie um segundo teste com o mesmo número de telefone para verificar a deduplicação (atualização em vez de duplicata)

Se a etapa 3 falhar: verifique primeiro o status da conexão da integração e depois consulte o log de eventos da sua plataforma de chat para encontrar erros de sincronização.

Se a etapa 4 falhar com atributos customizados ausentes: confirme que o atributo foi preenchido durante o fluxo (verifique o registro do contato no ManyChat ou no Respond.io) e que o mapeamento de campo está configurado corretamente.

Erros Comuns

Incompatibilidade no formato do número de telefone. A falha mais comum. Normalize para E.164 em todos os sistemas antes de construir qualquer mapeamento. Chat funnels em conformidade com GDPR para compradores na UE cobre requisitos adicionais sobre armazenamento de números de telefone se os seus contatos estiverem na Europa.

Timestamp de opt-in ausente. Tanto o GDPR quanto a Política do WhatsApp Business exigem que você registre quando o usuário fez opt-in. Armazene o timestamp de opt-in como um campo no CRM desde o primeiro dia, não como uma adição tardia.

CRM bloqueando registros sem e-mail. HubSpot e Salesforce podem ser configurados para exigir e-mail na criação do contato. Contatos do WhatsApp muitas vezes não têm e-mail coletado. Remova o requisito de e-mail para contatos originados pelo chat ou colete o e-mail como uma etapa do fluxo.

Conflito de tipo de propriedade no HubSpot. Se você mapear um atributo de texto do ManyChat para uma propriedade numérica do HubSpot, a sincronização vai falhar silenciosamente. Combine os tipos de propriedade exatamente: texto com texto, número com número, dropdown com dropdown.

O Que Fazer a Seguir

Depois que a integração estiver confirmada e funcionando, crie uma visualização no CRM filtrada por "WhatsApp Campaign Source não está vazio". Combine essa visualização com um design sólido do modelo de dados do CRM para que suas propriedades customizadas de chat fiquem em um schema consistente desde o início. Essa se torna sua visualização contínua para acompanhar o Pipeline originado pelo chat. Revise-a semanalmente comparando com outras fontes de leads para ver a contribuição do canal.

A partir daí, conecte os dados de atribuição à receita. Quando um lead originado pelo chat fechar, marque o negócio com a origem de campanha original. Após 60 dias, você terá dados suficientes para otimizar o investimento em anúncios em direção às campanhas que geram não apenas conversas, mas receita fechada.

Saiba Mais

• Configurando um Funnel de anúncios da Meta para chat pelo WhatsApp de ponta a ponta
• Automação de roteamento de leads para leads capturados pelo chat
• Como o fim do formulário de contato está remodelando a captura de leads
• Automação de workflow no CRM para times de operações
• Medindo a performance do chat funnel: as métricas que importam
• Configurando o Respond.io com HubSpot de ponta a ponta