> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flunora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Lead Ads

> Ligar os formulários do Facebook e do Instagram ao seu funil, pela ponte do Make.

Um lead que preenche o formulário de um anúncio no Facebook ou no Instagram entra no seu
funil em segundos, com a campanha, o conjunto e o anúncio que o trouxeram. A ponte entre
o Meta e a Flunora é o Make, e o caminho tem três partes: a Flunora abre um endereço de
entrega, o Make liga o Facebook a esse endereço, e um envio de teste prova que a ponte
está de pé.

O app tem uma tela que acompanha os três, em **Configurações**, **Integrações**,
**Ferramentas**, no card do Facebook Lead Ads. Ela mostra o estado de cada parte, porque
você vai alternar entre três produtos para completar isto e precisa saber onde parou ao
voltar.

## Antes de começar

Você precisa de uma página no Facebook com pelo menos um formulário de Lead Ads
publicado, de uma conta no Make, e de ser administrador da página. O plano gratuito do
Make cobre o volume de quem está começando.

## Passo 1: abra o endereço de entrega

Na tela do Facebook Lead Ads, escolha a origem que os contatos vão carregar e crie o
endereço. A origem é obrigatória aqui, e é a razão de existir da integração: sem ela o
contato entra sem dizer de onde veio, e medir a campanha era justamente o que se queria.
Ela pode ser trocada depois sem mexer na URL.

Copie a URL. Ela é um [webhook de entrada](/pages/contatos/visao-geral) comum, com token.

## Passo 2: ligue o Facebook ao endereço, no Make

<Steps>
  <Step title="Crie um cenário">
    No Make, crie um cenário novo e em branco.
  </Step>

  <Step title="Adicione o gatilho Watch Leads">
    Procure por Facebook Lead Ads e escolha **Watch Leads**. Conecte a sua conta do
    Facebook e autorize o acesso à página. Depois escolha a página e o formulário que
    você quer ouvir.
  </Step>

  <Step title="Adicione Get Lead Details">
    O gatilho avisa que houve um lead, mas quem traz os campos preenchidos é o módulo
    **Get Lead Details**. Ligue-o ao gatilho e aponte o `Lead ID` que veio dele.
  </Step>

  <Step title="Adicione um HTTP Request">
    Ação **Make a request**. O método é `POST`, a URL é o endereço que você copiou no
    passo 1, e o corpo é `JSON (application/json)`.
  </Step>

  <Step title="Monte o corpo e mapeie os campos">
    Crie a estrutura do corpo com os campos da tabela abaixo, todos como **Required: No**.
    Campo obrigatório quebra o cenário quando o Facebook manda vazio, o que acontece com
    telefone o tempo todo.
  </Step>

  <Step title="Ative o cenário">
    Salve e ligue. O Make passa a ouvir a página.
  </Step>
</Steps>

### O que mapear

Os campos do contato vêm do **Get Lead Details**, e os de campanha vêm do **Watch Leads**.
Trocar a origem dos dois é o engano mais comum, e o efeito é o contato entrar sem
atribuição.

| Campo no corpo | De onde vem      | O que selecionar         |
| -------------- | ---------------- | ------------------------ |
| `name`         | Get Lead Details | Field data, Full name    |
| `email`        | Get Lead Details | Field data, Email        |
| `phone`        | Get Lead Details | Field data, Phone number |
| `campaignId`   | Watch Leads      | Ad, Campaign ID          |
| `campaignName` | Watch Leads      | Ad, Campaign Name        |
| `adsetId`      | Watch Leads      | Ad, Adset ID             |
| `adsetName`    | Watch Leads      | Ad, Adset Name           |
| `adId`         | Watch Leads      | Ad, Ad ID                |
| `adName`       | Watch Leads      | Ad, Ad Name              |
| `formId`       | Watch Leads      | Form ID                  |

Os campos disponíveis dependem do formulário que você publicou. Se **Phone number** não
aparece na lista, é porque o formulário não pede telefone.

## Passo 3: prove que a ponte está de pé

A tela do Facebook Lead Ads envia um contato de teste pelo mesmo caminho que o Make usa.
Se ele aparecer no pipeline, a integração funciona. A própria tela oferece abrir ou
excluir esse contato depois, para o teste não virar lixo na base.

## Depois que estiver rodando

Os campos de campanha aparecem na ficha do contato e nos relatórios, que é o que permite
responder qual anúncio trouxe quem fechou. Se os contatos chegarem sem essa informação, a
causa quase sempre é o mapeamento do passo 2 apontando para o módulo errado.

Quando um envio falha, o erro devolvido é o mesmo da entrada de contatos, e está em
[erros](/pages/guias/erros). O Make mostra o corpo da resposta no histórico do cenário.