Pular para o conteúdo principal

​
Visão geral

CTWA significa Click-to-WhatsApp: anúncios no Facebook ou Instagram que levam o lead direto para uma conversa no WhatsApp. O ctwa_clid (Click-to-WhatsApp Click ID) é o identificador único do clique nesse anúncio. A Meta envia esse valor quando o lead vem de uma campanha paga, e ele permite rastrear qual anúncio ou campanha originou a conversa. Com o ctwaClid, você pode devolver eventos de conversão à Meta e melhorar a otimização das suas campanhas de tráfego pago.

​
Quando o ctwa_clid está disponível

O ctwaClid fica disponível quando o lead inicia a conversa a partir de:
  • Um anúncio Click-to-WhatsApp no Facebook
  • Um anúncio Click-to-WhatsApp no Instagram
  • Um botão de ação em uma Página do Facebook que abre o WhatsApp
O ctwaClid fica disponível na conversa, mas a LíderHub não exibe esse valor em uma tela para cópia manual. Para enviá-lo ao seu CRM, ERP ou backend, você precisa configurar uma integração.

​
Como acessar via Custom Tool

Para capturar o ctwaClid e devolvê-lo ao seu sistema, é necessário criar uma . Consulte também o para ver um fluxo webhook completo com o objeto metadata no payload.
1

Crie a Custom Tool

Acesse Configurações > Integrações > Custom Tool e clique em Nova Chamada Personalizada.
2

Configure o webhook

Informe a URL do seu endpoint (n8n, Make, Zapier ou backend próprio) e defina o método HTTP.
3

Acione no prompt do agente

Use a menção @ação da Custom Tool no prompt - por exemplo, ao qualificar o lead ou no início da conversa.
4

Leia o metadata no backend

No payload recebido pelo seu webhook, acesse metadata.ctwaClid para obter o identificador de atribuição do anúncio.

​
Parâmetro metadata

Toda execução de Custom Tool envia automaticamente um objeto metadata junto ao payload da requisição. Esse objeto contém dados de atribuição do anúncio quando o lead veio de campanha paga.
CampoDescrição
titleTítulo do anúncio
ctwaClidID de clique Click-to-WhatsApp - principal campo para atribuição
mediaURLURL da mídia do anúncio
sourceIDID da fonte ou campanha na Meta
sourceAppApp de origem (facebook, instagram, etc.)
sourceURLURL do post ou anúncio de origem
sourceTypeTipo da fonte (ex.: ad)
clickToWhatsappCallIndica se o clique foi em botão de ligação CTWA
Exemplo do objeto metadata no payload de uma Custom Tool (com IDs fictícios). Veja o contexto completo em : 
{
  "metadata": {
    "title": "Escritório Exemplo - Advocacia",
    "ctwaClid": "AfjXJL_exemplo_clid_ofuscado_para_documentacao_abc123xyz",
    "mediaURL": "https://www.facebook.com/reel/0000000000000000/",
    "sourceID": "120000000000000000",
    "sourceApp": "instagram",
    "sourceURL": "https://www.instagram.com/p/ExemploPostId/",
    "sourceType": "ad",
    "clickToWhatsappCall": false
  }
}
Quando o lead não veio de anúncio, o objeto metadata pode vir vazio ou sem o campo ctwaClid.

​
Otimizar campanhas na Meta

Com o ctwaClid em mãos, seu backend pode enviar eventos de conversão de volta à Meta pela Conversions API. Assim, a Meta passa a otimizar a entrega dos anúncios para perfis com maior chance de converter. Saiba mais em .
Combine o ctwaClid com eventos do seu funil comercial. Por exemplo, acione uma Custom Tool quando o status da conversa mudar para Sucesso e envie o evento correspondente à Meta a partir do seu backend.

​
Fluxo resumido

​
Deixe uma sugestão

Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse Obtenha suporte.

​
Dúvidas Frequentes

É o identificador único do clique em um anúncio Click-to-WhatsApp. A Meta envia esse valor quando o lead inicia a conversa a partir de uma campanha paga no Facebook ou Instagram.
Sim. A LíderHub não exibe o ctwaClid em tela para cópia manual. Para enviá-lo ao seu sistema, configure uma Custom Tool que dispare um webhook e leia o campo metadata.ctwaClid no payload recebido.
Sim. Toda Custom Tool executada envia o parâmetro metadata junto ao payload. Quando o lead veio de anúncio, o objeto inclui campos como ctwaClid, sourceApp e sourceURL.
Envie o ctwaClid junto com eventos de conversão do seu funil (ex.: lead qualificado ou venda fechada) para a Conversions API da Meta. Com isso, a Meta melhora o direcionamento dos anúncios para perfis com maior chance de converter.
Última modificação em 15 de junho de 2026