Referência do nó

KindstartCategoriaGatilhos

Gatilho por Formulário de Lead Ads Enviado

Para que serve

Dispara o fluxo quando alguém preenche um formulário de anúncio da Meta (Lead Ads, no Facebook ou Instagram) e é registrado como lead novo da campanha. O lead nasce sem conversa: a pessoa preencheu um formulário, ainda não falou com você.

É uma opção de evento do nó Start, escolhida em "Quando iniciar" no grupo Campanhas (Lead de formulário (Lead Ads)).

Quando usar

• Fazer o primeiro contato por WhatsApp com quem acabou de preencher o formulário.
• Usar as respostas do formulário (nome, telefone, campos personalizados) para qualificar o lead.
• Ter um fluxo por formulário, filtrando por form_id.

Passo a passo

1. ·
   Abra o nó **Start** do fluxo.
2. ·
   No campo "Quando iniciar", escolha o evento **Lead de formulário (Lead Ads)** no grupo **Campanhas**.
3. ·
   Se quiser, use os filtros para restringir por campanha, formulário, 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 formulário é enviado por um contato novo na campanha.
• Não dispara quando o mesmo contato envia novamente pela mesma campanha (não vira um segundo lead).
• Não dispara se a busca dos dados do formulário na Meta falhar. Nesse caso nenhum lead é criado.

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 (só Lead Ads; pode vir vazio)
event.campaign_id	Id interno da campanha
event.campaign_lead_id	Id do lead da campanha
event.contact_id	Id do contato
event.business_id	Id do negócio criado ou vinculado (vazio quando não há funil configurado)
event.form_id	Id do formulário na Meta
event.ad_id	Id do anúncio (pode vir vazio)
event.platform	facebook ou instagram
event.fields	Respostas do formulário, com o nome do campo na Meta como chave (ex.: event.fields.full_name)

O contato é criado ou localizado pelo telefone (e, na falta dele, pelo e-mail). Como o lead nasce sem conversa, este gatilho não traz event.conversation_id.

Filtros

O painel do Start ganha a seção Filtros com: Campanha (lista das campanhas de Lead Ads do workspace), ID do formulário, ID do anúncio e Plataforma (Facebook ou Instagram). Funciona do mesmo jeito descrito em Filtros do Start — campo, operador, valor, combinados por E/OU.

Exemplo

1. Start → evento Lead de formulário (Lead Ads), filtro form_id É igual a o id do seu formulário.
2. Enviar Mensagem (template) → primeiro contato pelo WhatsApp, usando {{event.fields.full_name}}.

Pré-requisitos e cuidados

Atenção

A leitura dos formulários exige a permissão **leads_retrieval** na conexão Meta da Página, e o uso real em produção depende da aprovação dessa permissão na Meta (App Review). Sem ela, os formulários não chegam.

Atenção

Páginas que já estavam conectadas antes desta funcionalidade precisam de duas ações: rodar o comando `meta:subscribe-leadgen` (assina o evento de formulário nas Páginas ativas) e **reconectar** a Página para ganhar a permissão `leads_retrieval`. As Configurações de campanhas mostram o status por conexão.

Atenção

`event.fields` contém dados pessoais do lead. Não copie esses valores para mensagens de log, notas públicas ou sistemas que não deveriam recebê-los.

Saiba mais

• Lead Forms — criar, publicar e sincronizar os formulários que alimentam este gatilho
• 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