Office Porto Alegre · Andrade e Eeden

ChatGuru → Meta Ads

Como ligar o fluxo de qualificação do WhatsApp de volta na Meta, pra campanha parar de otimizar por conversa iniciada e passar a otimizar por lead qualificado.

API de Conversões (CAPI) Conta act_1132275175073255 31/08/2026
A ideia em uma frase: quando o lead qualifica no fluxo do ChatGuru, um evento volta pro pixel da Meta com o telefone criptografado — a Meta cruza com quem clicou no anúncio e tu passa a enxergar custo por lead qualificado por campanha e por criativo.

Como a conexão funciona

Quatro peças. As três primeiras já existem na operação — só falta a ponte.

1

Anúncio CTWA

Campanhas de clique-pro-WhatsApp que já rodam (Pensão por Morte, Aposentadoria, BPC, Rodobens).

→
2

ChatGuru qualifica

O fluxo de perguntas marca o lead como qualificado (etapa do funil) e dispara uma ação de webhook com telefone + etapa.

→
3

Ponte (n8n)

Recebe o webhook, faz o hash SHA-256 do telefone e monta o evento no formato da Meta.

→
4

Meta CAPI

Evento entra no pixel via /{pixel_id}/events. A Meta casa o telefone com o clique e atribui à campanha certa.

O que muda na prática

Hoje

Custo por conversa

A campanha otimiza por "conversa iniciada". O algoritmo busca quem clica e manda um oi — inclusive o curioso que nunca vira caso. A qualidade do lead fica invisível pra Meta.

Com a conexão

Custo por lead qualificado

Cada campanha e criativo ganha um número de leads que passaram na triagem. Depois de volume suficiente de eventos, a campanha pode otimizar direto por esse evento — o algoritmo passa a buscar o perfil que qualifica.

Estado atual da conta

Conferido na API em 31/08/2026 — a infraestrutura do lado da Meta já existe.

disparando

Pixel - Thiago

458805988569612

Último disparo 30/08. Candidato a receber os eventos das frentes previdenciárias.

disparando

Pixel Rodobens

1526759482490725

Último disparo 29/08. Compartilhado com a conta API (act_704063345818460) — provável destino dos eventos da frente Rodobens.

Campanhas ativas são quase todas clique-pro-WhatsApp

  • WhatsApp — Pensão por Morte (2 campanhas ativas, R$ 1.000/dia na principal)
  • WhatsApp — Aposentadoria, BPC, Anulatória/RMC
  • WhatsApp — Rodobens
  • Única exceção: "Contato no Site - Rodobens" (objetivo de leads no site)

As duas pegadinhas

1 · Atribuição por clique só existe na API oficial do WhatsApp

O identificador do clique (ctwa_clid) só chega junto da mensagem se o número roda na Cloud API oficial. Se o ChatGuru estiver no modo não-oficial (WhatsApp Web), o casamento cai pro telefone criptografado — funciona, mas com taxa de correspondência menor. Confirmar o modo do número antes de prometer atribuição perfeita.

2 · ChatGuru não tem integração nativa com a Meta

Ele tem API (ativada pelo suporte, visível só pra ADMIN) e ações de webhook nos diálogos — mas nenhum botão "conectar Meta". A ponte no meio (n8n) é obrigatória, e é ela que a gente monta.

O que precisamos decidir antes de montar

Plano e permissões do ChatGuru

A API está habilitada na conta? As ações de webhook aparecem no editor de fluxo? (Se não, é um chamado no suporte deles.)

Qual etapa do funil = "lead qualificado"

O ponto exato do fluxo que dispara o evento. Tem que ser a mesma régua que o time de atendimento já usa.

Qual pixel recebe os eventos

Pixel - Thiago pras frentes previdenciárias e Pixel Rodobens pra Rodobens é a aposta — confirmar.

n8n no ar

A ponte vai morar lá. O conector estava fora (erro 502) em 31/08 — validar o acesso.

Modo do número de WhatsApp

Oficial (Cloud API) ou não-oficial? Define se teremos ctwa_clid ou só o match por telefone.

Plano de implantação

  1. Responder as 5 pendências acimaUm print do painel do ChatGuru resolve as duas primeiras.
  2. Montar o workflow no n8nWebhook de entrada → normalização e hash do telefone → chamada à Graph API. Sai pronto, só colar a URL no ChatGuru.
  3. Configurar a ação de webhook no fluxo do ChatGuruNa etapa de qualificação, enviando telefone + etapa + campanha de origem quando houver.
  4. Testar na aba Test Events do Gerenciador de EventosSimular um lead qualificando e ver o evento chegar no pixel antes de valer de verdade.
  5. Rodar 2–4 semanas acumulando eventosNessa fase o ganho já aparece: custo por lead qualificado por campanha e criativo nos relatórios.
  6. Migrar a otimização das campanhas pro evento de qualificaçãoQuando houver volume estável de eventos por semana — aí o algoritmo passa a caçar o perfil que qualifica.