Pular para o conteúdo principal
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

CampoDescrição
source_urlURL curta do anúncio de origem (por exemplo, um link fb.me).
source_idIdentificador do anúncio ou publicação de origem na Meta.
source_typeTipo de origem. O valor ad indica que a conversa veio de um anúncio.
bodyTexto principal do anúncio que o usuário viu antes de clicar.
media_typeTipo de conteúdo do anúncio: image ou video.
video_urlURL do vídeo do anúncio. Presente quando media_type é video.
thumbnail_urlURL da miniatura do conteúdo do anúncio.
ctwa_clidClick to WhatsApp Click ID: identificador único do clique, útil para atribuição e relatórios.
welcome_message.textMensagem 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:
1

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

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

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.

​
Artigos relacionados

Memory

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

Google Ads

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