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

# Meta Ads

> Detecte quando uma conversa do WhatsApp chega a partir de um anúncio da Meta (Click to WhatsApp) e use essa atribuição nos seus fluxos do Brain Studio.

Os anúncios **Click to WhatsApp (CTWA)** do Facebook e do Instagram abrem uma conversa no WhatsApp quando o usuário clica. Este guia explica **como saber se um chat vem de um anúncio da Meta**: quando a conversa se origina em um anúncio, a Jelou insere automaticamente na memória um objeto `_referral` com os dados do anúncio de origem.

Com essa informação você pode **atribuir o lead**, rotear conforme a campanha, personalizar a primeira resposta ou registrar a origem no seu CRM, sem cruzar dados manualmente entre o Meta Ads Manager e o canal conversacional.

## Como funciona

Quando um usuário clica em um anúncio **Click to WhatsApp**, o WhatsApp abre com uma mensagem inicial e a Meta anexa a essa primeira interação os dados de referência (*referral*) do anúncio. A Jelou detecta esses dados e os insere automaticamente na memória da conversa sob a variável `_referral`.

<Note>
  Não é necessária nenhuma instalação no Marketplace. O objeto `_referral` é injetado automaticamente sempre que a conversa se origina em um anúncio Click to WhatsApp.
</Note>

## Detectar se um chat vem de um anúncio

Para saber se uma conversa chegou a partir de um anúncio da Meta, verifique se a variável `_referral` existe na memória. Quando a conversa se origina em um anúncio, a Jelou insere o seguinte objeto:

```json theme={null}
{
  "_referral": {
    "source_url": "https://fb.me/XXXXX",
    "source_id": "120XXXXXXXXX387",
    "source_type": "ad",
    "body": "BODY_CONTENT",
    "media_type": "video",
    "video_url": "https://www.facebook.com/story.php?story_fbid=XXXXX",
    "thumbnail_url": "https://scontent.ftru6-2.fna.fbcdn.net/v/XXXXXXXXX",
    "ctwa_clid": "CTWA",
    "welcome_message": {
      "text": "WELCOME_MESSAGE"
    }
  }
}
```

Se `_referral` não existir na memória, a conversa **não** se originou em um anúncio Click to WhatsApp (por exemplo, um usuário que escreve diretamente para o número).

Saiba mais sobre como ler essas variáveis em: [Memory](/pt/guias/variaveis/memory).

## Referência de campos

| Campo                  | Descrição                                                                                       |
| ---------------------- | ----------------------------------------------------------------------------------------------- |
| `source_url`           | URL curta do anúncio de origem (por exemplo, um link `fb.me`).                                  |
| `source_id`            | Identificador do anúncio ou publicação de origem na Meta.                                       |
| `source_type`          | Tipo de origem. O valor `ad` indica que a conversa veio de um anúncio.                          |
| `body`                 | Texto principal do anúncio que o usuário viu antes de clicar.                                   |
| `media_type`           | Tipo de conteúdo do anúncio: `image` ou `video`.                                                |
| `video_url`            | URL do vídeo do anúncio. Presente quando `media_type` é `video`.                                |
| `thumbnail_url`        | URL da miniatura do conteúdo do anúncio.                                                        |
| `ctwa_clid`            | *Click to WhatsApp Click ID*: identificador único do clique, útil para atribuição e relatórios. |
| `welcome_message.text` | Mensagem de boas-vindas configurada no anúncio, com a qual a conversa inicia.                   |

<Note>
  Os campos disponíveis dependem do anúncio. Um anúncio com imagem não incluirá `video_url`, e alguns campos podem chegar vazios conforme a configuração do criativo.
</Note>

## Como usar no seu fluxo

Dentro de qualquer nó você pode acessar os dados do anúncio com a sintaxe de memória `{{$memory._referral.campo}}`. Por exemplo:

* `{{$memory._referral.source_type}}` → `ad`
* `{{$memory._referral.ctwa_clid}}` → identificador do clique para atribuição
* `{{$memory._referral.body}}` → texto do anúncio que o usuário viu

Uma forma comum de aproveitá-lo é **ramificar o fluxo conforme a origem**:

<Steps>
  <Step title="Verifique se a conversa vem de um anúncio">
    No início do fluxo, avalie se `_referral` existe na memória. Se existir, a conversa chegou a partir de um anúncio Click to WhatsApp.
  </Step>

  <Step title="Salve a atribuição para reutilizá-la">
    Guarde `ctwa_clid` e `source_id` na memória ou envie-os ao seu CRM para atribuir o lead à campanha de origem.
  </Step>

  <Step title="Personalize ou roteie conforme o anúncio">
    Use `body`, `source_url` ou `source_id` para adaptar a primeira resposta do agente, rotear para a equipe correta ou disparar uma notificação interna.
  </Step>
</Steps>

<Warning>
  O objeto `_referral` só é injetado quando a conversa se **origina** no anúncio. Se o usuário já tinha uma conversa anterior com o número e escreve novamente sem passar pelo anúncio, a referência pode não estar disponível.
</Warning>

## Artigos relacionados

<CardGroup cols={2}>
  <Card title="Memory" href="/pt/guias/variaveis/memory" icon="database">
    Como ler e persistir variáveis entre conversas e nós.
  </Card>

  <Card title="Google Ads" href="/pt/guias/integracoes/marketing/google-ads" icon="google">
    Atribua conversas do WhatsApp às suas campanhas do Google Ads.
  </Card>
</CardGroup>