ctwa_clid: como saber de qual anúncio veio o lead do WhatsApp

Um lead chega pelo WhatsApp perguntando o preço. O time comercial responde, fecha a venda, e ninguém sabe se aquele contato veio do anúncio de aquisição que está rodando há duas semanas ou de um clique orgânico no perfil da empresa. O parâmetro que resolve essa dúvida chama-se ctwa_clid, e ele já chega dentro da própria conversa, só que quase ninguém captura.

O que é o ctwa_clid

ctwa_clid é o identificador único que a Meta gera quando alguém clica em um anúncio Click to WhatsApp (CTWA) e cai direto numa conversa. A sigla vem de “Click To WhatsApp Ad”, e o código funciona como uma versão do GCLID do Google Ads para dentro do aplicativo: em vez de viver numa URL, ele viaja anexado à primeira mensagem da conversa.

Segundo a documentação oficial da Conversions API da Meta, o campo entra no objeto user_data do payload e não deve ser hasheado, ao contrário de e-mail e telefone. Isso já diz muito sobre a função dele: não é um dado de identidade da pessoa, é um dado de origem do clique.

Onde o ctwa_clid aparece na prática

O código chega junto com a primeira mensagem que o lead envia, dentro de um objeto chamado referral no webhook da API oficial do WhatsApp. Esse objeto também traz o ID do anúncio, o título e o corpo do criativo que a pessoa viu antes de clicar. Se a conversa não começou por um anúncio, o referral simplesmente não existe no payload, e essa ausência já é uma informação: o contato foi orgânico.

Um detalhe que derruba integração mal feita: o referral só vem preenchido na primeira mensagem daquela conversa. Se o sistema não salva esse dado no exato momento em que ele chega, a origem se perde, porque nenhuma mensagem seguinte carrega o mesmo campo de novo.

Por que o lead do WhatsApp costuma chegar sem origem clara

A maioria dos times de atendimento lê só o texto da mensagem, e o campo referral passa despercebido porque fica fora do que aparece na tela do WhatsApp Business ou do CRM. O resultado é o mesmo problema de sempre: o CAC daquela campanha some do relatório e reaparece como “WhatsApp orgânico” ou “canal desconhecido”, inflando o topo do funil de um jeito que distorce a leitura do funil inteiro.

Isso também acontece com quem já resolveu a atribuição para formulário de site, mas nunca conectou o WhatsApp na mesma lógica. O canal que mais gera reunião em muitas operações de serviço acaba sendo justamente o que menos tem dado de origem.

Material de apoioGuia de Prompts para Marketing e Vendas70 prompts com perguntas sobre marketing, vendas e comportamento para fazer aos seus dados.Baixar o guia

Como usar o ctwa_clid para atribuir o lead ao anúncio

O caminho passa por capturar o campo no primeiro contato e devolvê-lo à Meta quando o lead vira negócio, não só por guardá-lo num relatório. Na prática, isso envolve três passos:

• Capturar o referral na primeira mensagem , gravando ctwa_clid , o ID do anúncio e o horário junto do contato assim que ele entra no funil.
• Associar esse dado ao lead mesmo quando ele volta a falar por outro número, e-mail ou canal, para o histórico não virar um registro novo a cada contato.
• Reportar a conversão de volta à Meta pela Conversions API quando o lead atinge uma etapa que importa para o negócio, para o algoritmo aprender a otimizar por quem vira cliente, não só por quem manda mensagem.

É exatamente esse fluxo que um workflow de captura de webhook automatiza: ele lê o payload assim que a mensagem chega, grava o ctwa_clid junto do lead e dispara a conversão para a Meta no momento certo do funil, sem exportação manual de planilha.

Onde a Laiki entra

A Laiki guarda o ctwa_clid na mesma ficha do lead onde já estão o e-mail, o telefone e os demais eventos do funil. Um Workflow lê o webhook do WhatsApp assim que a primeira mensagem chega, extrai o código e o ID do anúncio, e associa os dois ao contato. Quando esse mesmo lead volta a aparecer em outro canal, o Combinador de ID reconhece que é a mesma pessoa e mantém a origem intacta, em vez de abrir um segundo registro sem histórico de anúncio.

Quando o lead avança para uma etapa relevante do funil comercial, a plataforma envia a conversão de volta para a Meta automaticamente, com o ctwa_clid daquele contato, sem depender de alguém lembrar de fazer esse envio dentro do prazo.

Perguntas frequentes

Todo lead do WhatsApp tem um ctwa_clid?

Não. O código só existe quando a conversa começou a partir de um clique em anúncio Click to WhatsApp. Contato que chegou pelo link da bio, por indicação ou por busca no perfil da empresa não carrega esse campo.

O ctwa_clid expira?

A Meta não documenta publicamente um prazo de validade como faz com o GCLID do Google Ads. Na prática, o cuidado que evita perda de dado é o mesmo: capturar o campo no instante em que a primeira mensagem chega, sem depender de buscá-lo depois.

Preciso programar para capturar esse dado?

É preciso alguém ler o webhook da API oficial do WhatsApp no momento em que ele chega, o que normalmente é trabalho técnico. Uma plataforma de dados que já faça essa leitura, como parte de um Workflow, resolve isso sem exigir que o time de marketing escreva código.

O ctwa_clid substitui a UTM?

Não. A UTM segue útil para o clique que leva a uma página ou formulário. O ctwa_clid resolve o mesmo problema dentro do WhatsApp, onde não existe URL de destino para carregar parâmetro nenhum.