No Brasil o clique para WhatsApp é o principal ponto de entrada de muitas campanhas. O problema é que o identificador que liga o anúncio à conversa só chega se a conta WhatsApp Business tiver a atribuição de anúncios ativada, e só aparece na primeira mensagem do webhook.
Sem esse identificador não existe forma confiável de saber qual criativo ou conjunto gerou o lead que fechou a venda.
Por onde o ctwa_clid chega no webhook
O campo ctwa_clid vem dentro do objeto referral da primeira mensagem recebida via WhatsApp Cloud API. Quando a atribuição de anúncios está habilitada na conta Business, o Meta injeta esse identificador no webhook sempre que a conversa é iniciada por um clique em anúncio.
Se a atribuição estiver desativada, o objeto referral chega vazio ou sem o ctwa_clid. Ativar a opção é obrigatório e fica em Configurações da conta WhatsApp Business > Avançado > Atribuição de anúncios.
O identificador é único por clique e não se repete. Ele é o equivalente do gclid ou fbclid, porém entregue fora do navegador e dentro do payload do webhook.
Onde armazenar o ctwa_clid e por quanto tempo
Guarde o ctwa_clid no registro do contato no CRM ou no BSP logo na primeira mensagem. A recomendação é manter o valor por pelo menos 90 dias, período que cobre a maioria dos ciclos de venda e coincide com a janela de atribuição padrão do Meta.
Se o atendimento é feito por vários atendentes, o campo precisa ficar visível para todos. Muitos times perdem a atribuição porque o primeiro atendente não salva o ctwa_clid ou o apaga ao responder.
Enviando a conversão via Conversions API for Business Messaging
Para que o algoritmo otimize corretamente é preciso devolver o evento de conversão usando a Conversions API for Business Messaging. O payload exige action_source igual a business_messaging e messaging_channel igual a whatsapp.
O ctwa_clid é enviado sem hash no parâmetro ctwa_clid. Sem esse retorno o Meta não associa a venda ao clique original e a otimização para conversões de WhatsApp fica cega.
A janela de deduplicação é de 48 horas contadas a partir do primeiro evento com o mesmo event_id. Envie o evento de servidor o mais rápido possível após a venda confirmada.
Armadilhas comuns no funil de WhatsApp
O cliente apaga a primeira mensagem e o ctwa_clid some do histórico. O atendente humano responde sem registrar o identificador. O lead volta por outro canal (Instagram, ligação) e a venda é atribuída manualmente ao lugar errado.
Além disso, parte relevante do tráfego que chega ao WhatsApp é automatizado. Tráfego automatizado responde por 51% de todos os acessos na internet e bots ruins representam 37% desse volume. Filtrar esse tráfego antes de gastar tempo de atendimento humano é o mesmo problema de proteção de campanha, só que um passo depois do clique.
Checklist de validação no Events Manager
Verifique se o evento de WhatsApp aparece no Events Manager com o parâmetro ctwa_clid preenchido. Confirme que o status do evento é “Recebido” e não “Não atribuído”. Teste enviando um evento de teste com ctwa_clid fictício e observe se ele aparece na deduplicação.
Se o evento não aparece, revise se a conta WhatsApp Business tem a atribuição ativada e se o token da Conversions API tem as permissões corretas para business_messaging.
O ctwa_clid aparece em todas as mensagens ou só na primeira?
Só na primeira mensagem do webhook. Depois que a conversa começa, o identificador não é repetido nas mensagens seguintes.
Posso usar o ctwa_clid para deduplicar eventos de compra?
Sim. Envie o mesmo event_id no Pixel e na Conversions API dentro da janela de 48 horas para que o Meta deduplique corretamente.
O que acontece se a conta WhatsApp Business não tiver atribuição de anúncios ativada?
O objeto referral chega sem ctwa_clid e a conversa fica sem ligação com o anúncio que a originou.
É possível prometer atribuição 1 em conversas de WhatsApp?
Não. O canal tem ruído natural: cliente apaga mensagem, atendente erra registro ou lead volta por outro caminho. A atribuição é probabilística.
Quanto tempo devo guardar o ctwa_clid no CRM?
Pelo menos 90 dias, para cobrir janelas de atribuição e ciclos de venda mais longos.
Verifique sempre se o evento de WhatsApp está chegando com o ctwa_clid preenchido antes de ajustar lances ou orçamentos com base nessas conversões.
Leia também: Postback S2S que não registra conversão: onde o subid se perde no funil
Escrito por
Redação Safely