O identificador que liga a conversa de WhatsApp ao anúncio que a trouxe. Onde ele aparece, quando ele falta, e os 5 testes para saber se a sua ferramenta está guardando ele.
Por Robert Maciel, gestor de tráfego há 9 anos · Publicado em 29/out/2026 · Parte do Dossiê do Sinal
Uma pessoa clica no seu anúncio, abre o WhatsApp e manda "Oi, quero o preço". Três dias depois ela compra. Se ninguém guardou a marca daquele clique, essa venda nunca mais encontra o anúncio que a trouxe. No relatório, ela vira "orgânico".
Essa marca tem nome: ctwa_clid. É o identificador do clique num anúncio de clique para o WhatsApp (Click to WhatsApp, daí o "ctwa"). Ele é a ponte entre a conversa e o anúncio, e é o dado que a Meta pede de volta quando você informa que aquela conversa virou lead ou venda.
Na referência oficial do WhatsApp Business, o campo aparece descrito como "Click to WhatsApp ad click ID", ou seja, o ID do clique no anúncio de clique para o WhatsApp (Meta para desenvolvedores).
Ele não identifica a pessoa. Ele identifica aquele clique, naquele anúncio. Por isso é tão valioso: a Meta já sabe de onde o clique veio e não precisa adivinhar quem é o cliente comparando telefone ou e-mail.
A própria documentação da API de Conversões para mensagens comerciais diz que o ID do clique liga o evento direto ao clique de origem e faz a correspondência de forma mais confiável do que os dados do cliente em hash. A orientação é curta: "Send ctwa_clid whenever you have it" (Meta para desenvolvedores).
Quando alguém manda mensagem a partir de um anúncio de clique para o WhatsApp, a mensagem que chega ao seu sistema pela API oficial vem com um bloco chamado referral. A Meta descreve esse bloco como incluído só quando a mensagem foi enviada por um anúncio de clique para o WhatsApp (Meta para desenvolvedores).
Dentro do referral vêm, entre outros campos:
source_id: o ID do anúncio;source_url: o link do anúncio;headline e body: o título e o texto principal do anúncio;media_type: se o anúncio era imagem ou vídeo;ctwa_clid: o ID do clique.Na documentação da API de Conversões, a Meta orienta guardar o ctwa_clid, que vem desse referral, junto com a conversa (Meta para desenvolvedores).
Na prática, trate esse dado como algo que chega uma vez, no começo. O referral vem com a mensagem que nasceu do anúncio. Se a sua ferramenta não gravar nesse momento, não há tela nenhuma de onde buscar depois.
Três situações deixam a conversa sem o ID do clique.
O referral faz parte do webhook da API oficial do WhatsApp Business. O app comum do celular não entrega esse dado para nenhum sistema seu. Se o atendimento roda só no celular, o clique se perde na hora em que a conversa abre.
A Meta avisa que, nas mensagens que nascem de um anúncio no Status do WhatsApp, o campo ctwa_clid é omitido por completo (Meta para desenvolvedores). O referral pode vir, mas sem o ID do clique. Quem anuncia nesse posicionamento precisa do caminho sem ID, explicado mais abaixo.
Muitas empresas não recebem o webhook direto da Meta. Ele passa por uma plataforma de atendimento, por um integrador ou por um CRM. Se uma dessas peças não repassa o referral inteiro, o ctwa_clid some no caminho. A Meta mandou; o seu CRM nunca viu.
Por isso a pergunta certa para o fornecedor não é "vocês têm integração com a Meta?". É "me mostre o ctwa_clid gravado numa conversa real que veio de anúncio".
Faça estes testes com uma campanha de clique para o WhatsApp no ar. Não precisa programar, só ter acesso à ferramenta de atendimento ou ao CRM.
ctwa_clid. Peça a quem cuida da ferramenta para mostrar o campo gravado nessa conversa. Ele é uma sequência longa de letras e números. "Veio do Instagram" não é o ctwa_clid.ctwa_clid precisa ir junto, no cadastro. Se ele fica só no histórico do chat, ninguém vai usá-lo na hora da venda.Se a conversa falhou no teste 2 ou no 3, o problema está na entrada. Se falhou no 4 ou no 5, a entrada está boa e o que falta é ligar o CRM.
Guardar o ID do clique é metade do trabalho. A outra metade é mandar de volta para a Meta, pela API de Conversões para mensagens comerciais, cada vez que a conversa avança.
Pela documentação, o evento de WhatsApp leva action_source como business_messaging, messaging_channel como whatsapp e, nos dados do usuário, o whatsapp_business_account_id com o ctwa_clid (Meta para desenvolvedores).
Os eventos aceitos incluem LeadSubmitted, QualifiedLead e Purchase, entre outros (como InitiateCheckout e OrderCreated). Um mapa simples para quem vende por conversa:
LeadSubmitted.QualifiedLead.Purchase, com o valor.É isso que muda o que a campanha aprende. Para a Meta otimizar a campanha de WhatsApp por lead, a Página precisa ter 10 eventos de lead ou de compra em 30 dias (Central de Ajuda da Meta). Sem eventos voltando, a campanha só tem a conversa para aprender. E ela traz mais gente que conversa, não mais gente que compra.
O mapa completo, etapa por etapa, está no Guia das Etapas.
A Meta tem um caminho para quando não há ctwa_clid. Nesse caso, o evento precisa levar o page_id, o whatsapp_business_account_id e pelo menos um dado do cliente em hash (SHA-256), como o telefone. A documentação avisa que o evento sem page_id é recusado, mesmo que traga dados válidos do cliente (Meta para desenvolvedores).
Esse caminho tem três limites, todos escritos na mesma página:
Ou seja: o caminho sem ID é o plano B. O plano A é não perder o ctwa_clid na entrada.
Num cliente que eu acompanho, a análise das conversas mostrou que só 14 de cada 100 conversas vindas de anúncio chegavam com a marca do anúncio. As outras 86 apareciam como "orgânico".
O anúncio não era o problema. O caminho era. Enquanto o ID do clique não for gravado na entrada, o relatório vai premiar o anúncio errado e punir o que vende.
Os dois são IDs de clique, mas de plataformas diferentes.
referral do webhook do WhatsApp, quando a pessoa clica num anúncio de clique para o WhatsApp.Quem anuncia no Google e leva para o WhatsApp precisa que a página grave o GCLID antes do clique no botão de WhatsApp e leve esse ID até o lead. Depois, você envia o GCLID de volta ao Google com o tipo da conversão e a data, como conversão offline (mesma página da Ajuda do Google Ads). O passo a passo dos dois caminhos está no artigo sobre rastreamento de vendas no WhatsApp.
Não. Ele identifica o clique num anúncio. Por isso a Meta consegue ligar o evento ao anúncio sem depender de telefone ou e-mail.
Não. O referral, que traz o ctwa_clid, chega pelo webhook da API oficial do WhatsApp Business. O app do celular não entrega esse dado para nenhum sistema.
Pode ser anúncio no Status do WhatsApp, em que a Meta omite o campo. Também pode ser uma ferramenta no meio do caminho que não repassa o referral inteiro. Os 5 testes deste artigo mostram em qual ponto ele se perde.
A documentação consultada não traz uma validade para o ID. O que ela traz é o limite do caminho sem ID: 7 dias de atribuição. A regra prática é mandar cada evento no dia em que a etapa muda.
ctwa_clid é o ID do clique no anúncio de WhatsApp. Ele chega no referral da mensagem que nasce do anúncio, pela API oficial.ctwa_clid. É isso que ensina a campanha a buscar quem compra.Quer ver por que o lead que chega não é o lead que compra, com os documentos da Meta um por um? Está no Dossiê.
Em 60 minutos passamos por estes pontos com os seus números, e você sai com o plano de ajustes por escrito.
Este material te dá o quê. O que trava na sua conta é o como: qual evento pedir, onde a origem se perde, por onde a venda volta. É isso que a Sessão Ciclo Fechado resolve.
R$ 597 · 60 minutos · só 4 sessões por semana · garantia dupla
Quero a minha sessão →P.S.: ainda não é a hora? Entre na lista da mentoria Ciclo Fechado e saiba primeiro quando abrir. Ou continue lendo: todos os materiais gratuitos.