Referência do nó

KindstartCategoriaGatilhos

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

Para que serve

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, 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)).

Quando usar

• 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).

Passo a passo

1. ·
   Abra o nó **Start** do fluxo.
2. ·
   No campo "Quando iniciar", escolha o evento **Lead de anúncio (Click to WhatsApp)** no grupo **Campanhas**.
3. ·
   Se quiser, use os filtros para restringir por campanha, anúncio ou plataforma.
4. ·
   Conecte a saída do Start ao próximo bloco do fluxo.

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.

Variáveis disponíveis

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)
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:

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

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 — campo, operador, valor, combinados por E/OU.

Exemplo

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 {{event.referral.headline}}. Como posso ajudar?"

O que você precisa saber antes de automatizar

Atenção

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.

Saiba mais

• Contas de Anúncios — conecte a Meta para identificar a campanha de cada lead
• Start (Início do fluxo) — outras formas de iniciar um fluxo e como funcionam os filtros
• Gatilho por Comentário Recebido — outro gatilho configurado como opção do Start
• Se / Senão (condição) — para tratar as variáveis do evento dentro do fluxo