> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liderhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CTWA Clid

> O que é o ctwa_clid, como acessá-lo via Custom Tool e usar a atribuição de anúncios para otimizar campanhas na Meta

## 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

<Info>
  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.
</Info>

## Como acessar via Custom Tool

Para capturar o `ctwaClid` e devolvê-lo ao seu sistema, é necessário criar uma <Tooltip headline="Custom Tools" tip="Como criar integrações personalizadas, webhooks e menções @ação nos agentes." cta="Ver mais" href="/integracoes/personalizada">Custom Tool</Tooltip>.

Consulte também o <Tooltip headline="Exemplo: enviar lead para N8N" tip="Passo a passo completo de uma Custom Tool que envia dados do lead para o N8N via webhook, incluindo o parâmetro metadata na resposta." cta="Ver exemplo" href="/integracoes/exemplo-custom-tool#resposta-do-agente">exemplo de envio de lead para N8N</Tooltip> para ver um fluxo webhook completo com o objeto `metadata` no payload.

<Steps>
  <Step title="Crie a Custom Tool">
    Acesse **Configurações > Integrações > Custom Tool** e clique em **Nova Chamada Personalizada**.
  </Step>

  <Step title="Configure o webhook">
    Informe a URL do seu endpoint (n8n, Make, Zapier ou backend próprio) e defina o método HTTP.
  </Step>

  <Step title="Acione no prompt do agente">
    Use a menção <Badge color="blue">@ação</Badge> da Custom Tool no prompt - por exemplo, ao qualificar o lead ou no início da conversa.
  </Step>

  <Step title="Leia o metadata no backend">
    No payload recebido pelo seu webhook, acesse `metadata.ctwaClid` para obter o identificador de atribuição do anúncio.
  </Step>
</Steps>

## 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.

| Campo                 | Descrição                                                        |
| --------------------- | ---------------------------------------------------------------- |
| `title`               | Título do anúncio                                                |
| `ctwaClid`            | ID de clique Click-to-WhatsApp - principal campo para atribuição |
| `mediaURL`            | URL da mídia do anúncio                                          |
| `sourceID`            | ID da fonte ou campanha na Meta                                  |
| `sourceApp`           | App de origem (`facebook`, `instagram`, etc.)                    |
| `sourceURL`           | URL do post ou anúncio de origem                                 |
| `sourceType`          | Tipo da fonte (ex.: `ad`)                                        |
| `clickToWhatsappCall` | Indica 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 <Tooltip headline="Exemplo: enviar lead para N8N" tip="Payload completo com name, metadata e chat na resposta da Custom Tool." cta="Ver exemplo" href="/integracoes/exemplo-custom-tool#resposta-do-agente">Resposta do agente</Tooltip>:

```json theme={null}
{
  "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
  }
}
```

<Note>
  Quando o lead **não** veio de anúncio, o objeto `metadata` pode vir vazio ou sem o campo `ctwaClid`.
</Note>

## Otimizar campanhas na Meta

Com o `ctwaClid` em mãos, seu backend pode enviar eventos de conversão de volta à Meta pela [Conversions API](https://developers.facebook.com/docs/marketing-api/conversions-api/). Assim, a Meta passa a otimizar a entrega dos anúncios para perfis com maior chance de converter.

Saiba mais em <Tooltip headline="API de Conversão" tip="O que é a Conversions API da Meta e como ela pode otimizar suas campanhas de tráfego." cta="Ver mais" href="/whatsapp/api-conversao">API de Conversão</Tooltip>.

<Tip>
  Combine o `ctwaClid` com eventos do seu funil comercial. Por exemplo, acione uma Custom Tool quando o status da conversa mudar para <Badge color="blue">Sucesso</Badge> e envie o evento correspondente à Meta a partir do seu backend.
</Tip>

## Fluxo resumido

<div style={{ display: 'flex', justifyContent: 'center', width: '100%' }}>
  ```mermaid theme={null}
  flowchart LR
    adClick[Lead clica no anuncio CTWA] --> whatsapp[Conversa inicia na LiderHub]
    whatsapp --> metadataObj[metadata com ctwaClid disponivel]
    metadataObj --> customTool[Custom Tool executada]
    customTool --> webhook[Seu backend recebe payload]
    webhook --> metaCAPI[Envia evento para Meta CAPI]
    metaCAPI --> optimize[Campanha otimizada]
  ```
</div>

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre CTWA Clid">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=CTWA%20Clid&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="O que é o ctwa_clid?">
    É 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.
  </Accordion>

  <Accordion title="Preciso de uma Custom Tool para acessar o ctwaClid?">
    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.
  </Accordion>

  <Accordion title="O metadata vem em toda execução de Custom Tool?">
    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`.
  </Accordion>

  <Accordion title="Como uso o ctwaClid para otimizar campanhas?">
    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.
  </Accordion>
</AccordionGroup>