Este guia reúne todas as etapas necessárias para implementar corretamente o Tracking da Meta em campanhas Click to WhatsApp, desde a criação do App até o envio dos eventos de conversão.
Ao final da configuração você terá:
Token permanente da Meta
Dataset (Pixel do WhatsApp)
Rastreamento de Leads
Rastreamento de Compras
Melhor aprendizado do algoritmo da Meta
Melhor otimização das campanhas
Facebook Ads
│
▼
Click to WhatsApp
│
▼
WhatsApp Business
│
▼
Datacrazy CRM
│
├──────────────► Tracking #1
│ Captura origem do Lead
│
├──────────────► Tracking #2
│ Eventos de Conversão
│
└──────────────► Tracking #3
SHA256 (Fallback)
Quando um usuário clica em um anúncio Click to WhatsApp, a Meta sabe apenas que uma conversa foi iniciada.
Ela não sabe:
se o lead respondeu;
se demonstrou interesse;
se recebeu uma proposta;
se iniciou um pagamento;
se comprou.
Os Eventos de Conversão informam exatamente em qual etapa do funil o cliente está.
Quanto mais fiel for esse envio, melhor será a otimização das campanhas.
Clique no anúncio
│
▼
Primeira conversa
│
▼
🟢 leadSubmitted
│
▼
🔵 ViewContent
│
▼
🟡 AddToCart
│
▼
🟠 InitiateCheckout
│
▼
🟣 Purchase
Os nomes de eventos são ‘CamelCase’ onde cada palavra do evento inicia em maiusculo, exemplo lead submitted vira ‘LeadSubmitted’.
Quando o lead responder ao atendimento ou fornecer as informações mínimas para continuar o fluxo.
Respondeu a primeira mensagem
Informou nome
Informou telefone
Confirmou interesse
Informar que o clique no anúncio gerou um lead válido.
Quando o cliente visualizar uma oferta.
Produto apresentado
Serviço apresentado
Catálogo enviado
Proposta enviada
Plano apresentado
Demonstrar interesse em uma oferta.
Quando houver intenção clara de compra.
Escolheu um produto
Escolheu um plano
Solicitou orçamento
Confirmou interesse em comprar
Representar uma forte intenção de compra.
Quando iniciar o processo de pagamento.
PIX
Boleto
Link de pagamento
Checkout
Contrato enviado
Indicar que o cliente entrou na etapa final da compra.
Somente após confirmação do pagamento.
PIX compensado
Cartão aprovado
Boleto pago
Assinatura criada
Venda concluída
Representar a conversão final da campanha.
Sempre que possível envie o valor real da venda.
Evento | Quando enviar | Objetivo |
LeadSubmitted | Lead respondeu | Lead válido |
ViewContent | Produto ou proposta apresentada | Interesse |
AddToCart | Cliente confirmou interesse | Intenção de compra |
InitiateCheckout | Pagamento iniciado | Checkout |
Purchase | Pagamento confirmado | Conversão |
O App será utilizado exclusivamente para gerar um Token permanente e permitir a integração entre o CRM Datacrazy e a Meta.
Esse App será responsável por:
Gerar Token de Sistema
Tracking de Leads
Tracking de Conversões
Envio de Eventos
Consulta do Dataset
Durante a criação do App selecione:
Criar e gerenciar anúncios com a API de Marketing
Conectar-se com clientes pelo WhatsApp
Gerenciar tudo pela Página do Facebook
Após criar o App adicione também:
Gerenciar Páginas → Adicionar
Conectar no WhatsApp → Adicionar
Esses casos de uso liberam permissões necessárias para o Token.
Preencha:
Política de Privacidade
https://datacrazy.io/politica
Termos de Serviço
https://datacrazy.io/termos
Exclusão de Dados
https://datacrazy.io/politica
Após isso:
Salvar
Publicar
Status Ativo
Criar:
Nome
Tracking
Tipo
Administrador
Depois atribuir o App criado.
Permissão:
Controle Total
Gerar Token utilizando:
App criado
Expiração Nunca
Permissões
ads_read
whatsapp_business_management
whatsapp_business_messaging
whatsapp_business_manage_events
read_insights
O Token é exibido apenas uma única vez. Salve-o imediatamente.
No CRM Datacrazy:
Conexões
↓
Selecionar conexão
↓
Gerenciar
↓
Atualizar conexão
↓
Copiar o campo
WhatsApp Business ID
Este será o WABA ID utilizado nas chamadas da API.
Todos os eventos da Meta são enviados para um Dataset.
Antes de enviar qualquer evento é necessário descobrir se ele já existe.
GET https://graph.facebook.com/v25.0/{{wabaID}}/dataset?access_token={{metaToken}}
Resposta esperada
{
"data":[
{
"id":"123456789012345"
}
]
}
O campo id será utilizado como:
datasetId
Caso retorne:
{
"data":[]
}
Criar utilizando:
POST https://graph.facebook.com/v25.0/{{wabaID}}/dataset?access_token={{metaToken}}
Resposta
{
"id":"123456789012345"
}
Armazene esse ID para reutilização.
Consultar Dataset
│
Existe?
┌──────┴──────┐
SIM NÃO
│ │
Usar ID Criar
│ │
└──────┬──────┘
▼
Salvar datasetId
Todos os eventos utilizam a URL:
POST https://graph.facebook.com/v25.0/{{datasetId}}/events?access_token={{metaToken}}
{
"data": [
{
"event_name": "Purchase",
"event_time": 1785282457,
"action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"whatsapp_business_account_id": wabaID,
"ctwa_clid": "SEU_CTWA_CLID"
},
"custom_data": {
"currency": "BRL",
"value": 19.97
}
}
]
}
Campo
Descrição
event_name | Evento enviado |
event_time | Timestamp Unix |
action_source | business_messaging |
messaging_channel | |
whatsapp_business_account_id | ID da WABA |
ctwa_clid | Identificador do anúncio Click to WhatsApp |
currency | Moeda |
value | Valor do evento |
O CTWA CLID é o identificador que permite à Meta relacionar a conversão com o anúncio que originou a conversa.
Sempre envie esse identificador quando disponível.
Sem ele, a Meta poderá registrar o evento, porém a atribuição da conversão ao anúncio será limitada.
Responsável por:
Capturar Campanha
Capturar Conjunto
Capturar Anúncio
Salvar Origem do Lead
Persistir dados no CRM
Fluxo:
(Adicionar link do fluxo)
Responsável por enviar para a Meta:
leadSubmitted
ViewContent
AddToCart
InitiateCheckout
Purchase
Benefícios
Melhor atribuição
Melhor aprendizado
Melhor otimização
Fechamento completo do funil
Fluxo:
(Adicionar link do fluxo)
Utilizado quando não existir:
CTWA CLID
FBCLID
FBC
Realiza o envio utilizando telefone em SHA256.
Método
Qualidade
CTWA CLID | ⭐⭐⭐⭐⭐ |
FBCLID | ⭐⭐⭐⭐ |
FBC | ⭐⭐⭐⭐ |
SHA256 | ⭐ |
Esse método continua alimentando a Meta, porém gera pouca atribuição e baixo impacto na otimização das campanhas.
Utilize apenas como complemento.
Fluxo:
(Adicionar link do fluxo)
Envie apenas eventos reais.
Não envie Purchase antes da confirmação do pagamento.
Não envie eventos duplicados.
Salve o datasetId para reutilização.
Utilize sempre o CTWA CLID quando disponível.
Envie o valor real da venda no evento Purchase.
Utilize o Tracking #3 apenas quando não houver CTWA CLID ou FBCLID.
☐ App criado
☐ App publicado
☐ Usuário de Sistema criado
☐ Token gerado
☐ Permissões corretas
☐ WABA ID localizado
☐ Dataset criado
☐ Dataset salvo
☐ Tracking #1 configurado
☐ Tracking #2 configurado
☐ Tracking #3 configurado SE necessário
☐ Eventos chegando na Meta
☐ Purchase validado
☐ Conversões sendo atribuídas corretamente