---
title: Gatilho por Lead de Anúncio (Click to WhatsApp)
description: Dispare um fluxo quando um contato novo chega à sua campanha por um anúncio Click to WhatsApp (CTWA).
---

<NoCard kind="start" categoria="Gatilhos" />

# Gatilho por Lead de Anúncio (Click to WhatsApp)

<Secao icon="info">Para que serve</Secao>

Dispara o fluxo quando alguém clica em um anúncio da Meta que abre uma conversa no WhatsApp (Click to WhatsApp, ou CTWA) e o sistema registra esse contato como um **lead novo da campanha**. O fluxo já nasce sabendo de qual anúncio a pessoa veio.

Assim como o [Gatilho por Comentário Recebido](/guia/flow-builder/gatilhos/comentario-recebido), este não é um bloco novo na paleta: é uma **opção de evento do nó Start**, escolhida em "Quando iniciar" no grupo **Campanhas** (**Lead de anúncio (Click to WhatsApp)**).

<Secao icon="clock">Quando usar</Secao>

- Enviar uma mensagem de boas-vindas específica para quem veio de um anúncio, citando a oferta.
- Qualificar o lead automaticamente, com um fluxo diferente por anúncio.
- Separar os leads por plataforma de origem (WhatsApp, Facebook ou Instagram).

<Secao icon="list-checks">Passo a passo</Secao>

<Passos>
  <Passo>Abra o nó **Start** do fluxo.</Passo>
  <Passo>No campo "Quando iniciar", escolha o evento **Lead de anúncio (Click to WhatsApp)** no grupo **Campanhas**.</Passo>
  <Passo>Se quiser, use os <a href="#filtros">filtros</a> para restringir por campanha, anúncio ou plataforma.</Passo>
  <Passo>Conecte a saída do Start ao próximo bloco do fluxo.</Passo>
</Passos>

## Quando dispara e quando não dispara

- **Dispara** quando um contato **novo na campanha** chega por um anúncio CTWA.
- **Não dispara** quando o mesmo contato volta pela mesma campanha. Ele não vira um segundo lead e nenhum gatilho é acionado de novo.

<Secao icon="sliders-horizontal">Variáveis disponíveis</Secao>

| Variável | O que traz |
|----------|-----------|
| `event.campaign.id` | Id interno da campanha |
| `event.campaign.name` | Nome da campanha (editável) |
| `event.campaign.source_type` | Origem: `ctwa`, `lead_form` ou `whatsapp_flow` |
| `event.campaign.platform` | Plataforma: `facebook`, `instagram` ou `whatsapp` |
| `event.campaign.external_id` | Id externo (id do anúncio, id do formulário ou template do Flow) |
| `event.campaign.ad_id` | Id do anúncio na Meta (pode vir vazio) |
| `event.campaign.ad_name` | Nome do anúncio (pode vir vazio) |
| `event.campaign.campaign_name` | Nome da campanha na Meta (pode vir vazio; veja [Campanha da Meta](#campanha-da-meta)) |
| `event.campaign_id` | Id interno da campanha |
| `event.campaign_lead_id` | Id do lead da campanha |
| `event.contact_id` | Id do contato |
| `event.conversation_id` | Id da conversa aberta pelo clique |
| `event.business_id` | Id do negócio criado ou vinculado (vazio quando não há funil configurado) |
| `event.ad_id` | Id do anúncio |
| `event.platform` | Canal de entrada: `whatsapp`, `facebook` ou `instagram` |
| `event.referral.headline` | Título do anúncio |
| `event.referral.body` | Texto do anúncio |
| `event.referral.source_url` | Link curto do anúncio |
| `event.referral.media_type` | Tipo de mídia do anúncio: `image` ou `video` |
| `event.referral.ctwa_clid` | Click ID do CTWA (pode vir vazio) |

## Campanha da Meta

O clique no anúncio informa apenas o **anúncio**, não a campanha da Meta a que ele pertence. O sistema descobre a campanha pela conexão de [Contas de Anúncios](/guia/conectar/contas-de-anuncios):

- **Anúncio já conhecido** (a sincronização horária já catalogou o anúncio): `event.campaign.campaign_name`, `event.campaign.ad_name` e o nome da campanha já vêm preenchidos no gatilho.
- **Primeiro lead de um anúncio novo**: esses campos podem chegar **vazios** no gatilho. O lead e o disparo do fluxo não esperam essa consulta; a campanha é preenchida logo depois, de forma assíncrona, e vale para os próximos leads e para os relatórios.
- **Sem conexão de Contas de Anúncios**: não há rastreamento de campanha. O lead é registrado normalmente, por anúncio, e aparece como "Anúncio não identificado". Não existe alternativa por código na mensagem.

<Dica>
Se o seu fluxo usa `event.campaign.campaign_name` ou `event.campaign.ad_name` em uma condição ou mensagem, trate o caso vazio. Para uma regra que não pode falhar, prefira `event.campaign.ad_id`, que sempre vem no clique.
</Dica>

O nome da campanha (`event.campaign.name`) segue editável: se você renomear, o sistema nunca o sobrescreve com o nome da Meta.

## Filtros

O painel do Start ganha a seção **Filtros** com: **Campanha** (lista das campanhas de anúncio CTWA do workspace), **ID do anúncio** e **Plataforma** (Facebook, Instagram ou WhatsApp). Funciona do mesmo jeito descrito em [Filtros do Start](/guia/flow-builder/gatilhos/start#filtros) — campo, operador, valor, combinados por **E**/**OU**.

<Secao icon="circle-check">Exemplo</Secao>

Você roda um anúncio de consulta gratuita e quer uma triagem só para ele:

1. **Start** → evento **Lead de anúncio (Click to WhatsApp)**, filtro **ad_id É igual a** o id do anúncio.
2. **Enviar Mensagem** → "Olá! Vi que você veio pelo anúncio <span v-pre>{{event.referral.headline}}</span>. Como posso ajudar?"

<Secao icon="alert-triangle">O que você precisa saber antes de automatizar</Secao>

<Cuidado>
Depende de um canal WhatsApp Cloud API (ou Messenger/Instagram) que receba o dado do anúncio (referral) da Meta. Canais que não expõem esse dado não geram lead de campanha.
</Cuidado>

## Saiba mais

- [Contas de Anúncios](/guia/conectar/contas-de-anuncios) — conecte a Meta para identificar a campanha de cada lead
- [Start (Início do fluxo)](/guia/flow-builder/gatilhos/start) — outras formas de iniciar um fluxo e como funcionam os filtros
- [Gatilho por Comentário Recebido](/guia/flow-builder/gatilhos/comentario-recebido) — outro gatilho configurado como opção do Start
- [Se / Senão (condição)](/guia/flow-builder/logica/if-else) — para tratar as variáveis do evento dentro do fluxo