---
title: Gatilho por Formulário de Lead Ads Enviado
description: Dispare um fluxo quando um formulário de anúncio da Meta (Lead Ads) é enviado por um contato novo na campanha.
---

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

# Gatilho por Formulário de Lead Ads Enviado

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

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

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

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

<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 formulário (Lead Ads)** no grupo **Campanhas**.</Passo>
  <Passo>Se quiser, use os <a href="#filtros">filtros</a> para restringir por campanha, formulário, 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 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.

<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 (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](/guia/flow-builder/gatilhos/start#filtros) — campo, operador, valor, combinados por **E**/**OU**.

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

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 <span v-pre>{{event.fields.full_name}}</span>.

<Secao icon="alert-triangle">Pré-requisitos e cuidados</Secao>

<Cuidado>
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.
</Cuidado>

<Cuidado>
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.
</Cuidado>

<Cuidado>
`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.
</Cuidado>

## Saiba mais

- [Lead Forms](/guia/conectar/lead-forms) — criar, publicar e sincronizar os formulários que alimentam este gatilho
- [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