Meta Ads

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.

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.

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:

{
  "_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.

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.

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.

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:

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.

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.

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.

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.

Memory

Como ler e persistir variáveis entre conversas e nós.

Google Ads

Atribua conversas do WhatsApp às suas campanhas do Google Ads.

Primeiros Passos

Desenvolvedor

Jelou CLI

Mensagens Outbound

Gestão

Marketplace

Canais

Configuração

Faturamento

Como funciona

Detectar se um chat vem de um anúncio

Referência de campos

Como usar no seu fluxo

Artigos relacionados

Memory

Google Ads

​Como funciona

​Detectar se um chat vem de um anúncio

​Referência de campos

​Como usar no seu fluxo

​Artigos relacionados

Memory

Google Ads

Como funciona

Detectar se um chat vem de um anúncio

Referência de campos

Como usar no seu fluxo

Artigos relacionados