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

# Meta Lead Ads

> Transforme os formulários instantâneos dos seus anúncios do Facebook e Instagram em contatos, responda por WhatsApp assim que um lead chega e salve de onde cada um veio.

O Meta Lead Ads transforma os envios dos formulários instantâneos dos seus anúncios do Facebook e Instagram em contatos da Ciarem. Você escolhe onde cada resposta do formulário fica, pode enviar um modelo de WhatsApp para cada novo lead assim que ele preenche o formulário, e pode salvar a campanha e o anúncio de onde cada lead veio. Os administradores o configuram em **Configurações > Integrações > Meta Lead Ads**.

## Conectar uma página do Facebook

Os leads pertencem a uma página do Facebook, então você conecta a página que veicula seus anúncios de cadastro.

<Steps>
  <Step title="Abra o Meta Lead Ads">
    Vá em **Configurações**, depois em **Integrações**, e clique em **Conectar** no cartão do Meta Lead Ads.
  </Step>

  <Step title="Entre com o Facebook">
    Entre com uma conta do Facebook que administre a página e marque a página no diálogo do Facebook. Se o Facebook pedir para escolher empresas, marque também a empresa dona da página.
  </Step>

  <Step title="Confira seus formulários">
    Os formulários instantâneos da página aparecem em **Formulários de leads**. Um formulário que você criar depois no Meta Ads Manager também aparece ali. Clique em **Atualizar** se ainda não o vir.
  </Step>
</Steps>

Para adicionar outra página, use **Conectar página**. Mantenha marcadas no diálogo do Facebook as páginas que você já conectou, porque desmarcar uma tira o acesso da Ciarem a ela. Uma página só pode estar conectada a um espaço de trabalho da Ciarem.

## Formulários de leads

A tabela **Formulários de leads** mostra, para cada formulário, os envios, os contatos criados e quantos precisam de atenção. Envios que não viraram contato costumam indicar um problema de mapeamento. Um formulário mostra **Pronto** quando cada pergunta tem um destino, ou quantas perguntas ainda faltam mapear.

## Mapear as perguntas

Abra um formulário para escolher onde cada resposta fica, em **Mapeamento de perguntas**. As perguntas padrão, como nome, e-mail e telefone, são mapeadas sozinhas. As perguntas personalizadas precisam de um destino: um campo do contato ou uma propriedade personalizada. Clique em **Salvar alterações**. Uma mudança no mapeamento vale só para os leads novos; os que já chegaram mantêm o mapeamento com que entraram.

Quando uma pergunta de múltipla escolha vai para uma propriedade com opções, **Destino das respostas** permite escolher em qual opção cada resposta fica. Por padrão, cada resposta vai para a opção com o mesmo rótulo.

Para pausar um formulário, desative **Criar contatos a partir deste formulário**. Os envios continuam sendo salvos, mas nenhum contato é criado enquanto ele estiver desativado.

## Como os leads se relacionam com seus contatos

Um lead precisa de um e-mail ou de um telefone para virar contato. A Ciarem procura primeiro um contato com o mesmo e-mail e depois um com o mesmo telefone:

* **Sem correspondência**: a Ciarem cria um contato novo, com a campanha ou o anúncio do lead como origem.
* **Com correspondência**: o nome, o e-mail e o telefone do lead só preenchem os campos vazios do contato, então nada que sua equipe ou o agente de IA já definiu é substituído. As propriedades personalizadas que você mapeou são atualizadas com as respostas do lead mais recente. Uma resposta vazia nunca apaga uma propriedade.

Um lead sem e-mail e sem telefone não é importado. Ele aparece no histórico de envios do formulário com o motivo.

## Rastreamento e dados do anúncio

Em **Rastreamento e dados do anúncio**, você pode salvar de onde cada lead veio em propriedades do contato:

* **Parâmetros de rastreamento**: os valores definidos nas configurações do formulário na Meta, por exemplo `utm_source`.
* **Dados do anúncio**: o nome da campanha, do conjunto de anúncios e do anúncio, e a plataforma (Facebook ou Instagram).

Nada aqui é salvo se você não mapear. Quando um lead corresponde a um contato existente, essas propriedades são substituídas pelos valores do lead mais recente. A origem do contato mantém a primeira campanha que o trouxe.

## Quando chega um novo lead

* **Modelo de resposta automática**: escolha um [modelo](/pt/channels/message-templates) de WhatsApp aprovado e ele é enviado para cada novo lead deste formulário assim que ele o preenche. Cada envio é cobrado da sua carteira do WhatsApp pela tarifa da Meta, como qualquer modelo.
* **Criar uma tarefa de follow-up quando a resposta automática não puder ser enviada**: com isso ativo, se nenhuma resposta automática sair, seja porque nenhum modelo foi escolhido ou porque ela não pôde ser enviada, a Ciarem cria uma [tarefa](/pt/using-ciarem/tasks) com vencimento 24 horas depois do envio do lead, para o proprietário do contato. Um lead novo quase nunca tem proprietário ainda, então os administradores encontram a tarefa em **Sem proprietário**.

A resposta automática é pulada quando o lead não tem telefone, o número não está no WhatsApp, falta um valor obrigatório no modelo, o saldo da carteira é insuficiente, a linha atingiu o limite de mensagens ou a linha de WhatsApp do modelo foi desconectada. Cada caso aparece com o motivo.

## Histórico de envios

Cada formulário guarda um **Histórico de envios** com o resultado de cada lead: o contato que ele criou ou atualizou, se a resposta automática foi enviada e por que um lead não virou contato.

## Desconectar uma página

**Desconectar** faz com que os novos envios dessa página deixem de criar contatos. Seus mapeamentos de formulários são mantidos e voltam a valer se você reconectar.

## Solução de problemas

### Minha página não aparece na lista

O Facebook só mostra as páginas às quais sua conta tem acesso total. Ser administrador do negócio não basta: nas configurações da página no Facebook, nas pessoas com acesso, dê controle total à sua conta. Depois clique de novo em **Conectar página**. Se o Facebook pedir para escolher negócios, marque o negócio dono da página.

### "Esta página do Facebook já está conectada a outro espaço de trabalho"

Uma página só pode enviar seus leads para um espaço de trabalho da Ciarem. Desconecte-a primeiro do outro espaço de trabalho e depois conecte-a aqui.

### "Não conseguimos mais ler os formulários desta página"

A Ciarem perdeu o acesso à página. Isso costuma acontecer quando alguém desmarcou a página na janela do Facebook, mudou a senha do Facebook ou perdeu sua função na página. Clique em **Reconectar** e mantenha a página marcada na janela do Facebook.

### Os leads não estão chegando

* Confira o **Histórico de envios** do formulário. Se o lead estiver lá, o resultado dele diz por que não virou contato. As causas mais comuns são um formulário pausado ou um lead sem e-mail e sem telefone.
* Se o lead não aparecer, confira se a página está conectada e sem o aviso de **Reconectar**.
* Leads enviados antes de você conectar a página não são importados.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.