Introdução

O Facebook Lead Ads é uma solução de anúncios da Meta que permite criar e veicular campanhas nas plataformas da marca, como Facebook e Instagram. Um dos formatos disponíveis é o de formulários de captação de leads, que simplificam o processo de inscrição do cliente final.

A integração com o Ploomes tem como objetivo importar automaticamente os leads capturados nesses formulários para a sua conta, facilitando o acompanhamento e o gerenciamento das oportunidades geradas.

Escopo Geral

Por meio da integração, todos os leads que preencherem formulários do Facebook Lead Ads vinculados à página integrada no Ploomes — incluindo formulários originados de outras plataformas, como Instagram — serão enviados para o CRM.

Ao chegar no Ploomes, os leads podem ser utilizados para criar pessoas, empresas e negócios, de acordo com as configurações definidas pelo usuário.

Vale destacar que a comunicação é unidirecional: o Ploomes recebe dados do Facebook, mas não envia informações de volta para a plataforma de anúncios. Alterações feitas no Ploomes não serão refletidas no Facebook Lead Ads.

O envio é realizado via webhooks, o que significa que os leads são transmitidos assim que o formulário é preenchido. Em condições normais, a integração ocorre quase em tempo real, podendo haver pequenas variações em cenários de alto volume.

Por que integrar o Facebook Lead Ads?

O Facebook Lead Ads permite que o cliente final preencha formulários sem sair da rede social, o que aumenta a taxa de conversão.

Com a integração, os leads capturados são enviados diretamente para o Ploomes, seguindo o mapeamento de campos configurado no formulário, garantindo agilidade no contato e melhor aproveitamento das oportunidades.

Como integrar o Facebook Lead Ads?

Para integrar é necessário que o usuário tenha permissão de administrador na página do Facebook.

Na Ploomes, acessar o painel de integração pelo caminho: Administração > Integrações Plug-and-Play > selecione a integração com o Facebook:
Clique em “Habilitar integração” e depois em “Autorizar integração”. Um pop-up vai abrir no navegador. Caso haja algum usuário do Facebook logado no momento da autorização, o pop-up vai perguntar se deseja conectar seu usuário ao Ploomes, quais páginas você deseja integrar, e exibir as permissões requeridas pela integração.
1. É importante que todas as permissões sejam aceitas, caso contrário a integração pode não funcionar corretamente.
2. É obrigatório que o usuário logado fazendo essa autorização tenha o perfil de administrador de todas as páginas que deseja integrar. Apenas assim ele poderá fornecer todas as permissões que a integração precisa para funcionar.
3. Caso não haja usuário logado, o pop-up apresentará uma tela de login no Facebook ao abrir.
Todas as páginas selecionadas serão inscritas na integração (pelos webhooks).

Para finalizar, clique em “Concluir” e a configuração no Facebook estará pronta!
Caso a autorização tenha sido feita com sucesso, uma notificação aparecerá na tela e a integração ficará marcada como autorizada.
Após isso, é necessário selecionar o comportamento a ser realizado quando recebermos leads do Facebook entre três opções:
Caso a opção envolva a criação de negócios, é necessário selecionar em qual estágio de funil ele será criado e se devemos criar um novo negócio ou atualizar o anterior caso o mesmo lead seja enviado duas vezes pelo Facebook.
Diferente das demais integrações, não existem mapeamentos padrão na integração com o Facebook, por conta da possibilidade de integrar múltiplos formulários de múltiplas páginas diferentes. Ao exibir as opções de mapeamento, serão exibidas as páginas integradas:
Selecionando uma, serão exibidos os formulários dessa página:
E dentro do formulário, os campos dele:
As possibilidades de mapeamento são diversas, mas há 3 campos obrigatórios para serem mapeados antes dos demais (é necessário realizar esses mapeamentos para cada formulário que deseja integrar, mas apenas se configurou para criar a entidade):
1. No mapeamento de cliente, mapear algum campo do Facebook para Cliente.Nome
2. No mapeamento de contato, mapear algum campo do Facebook para Contato.Nome
3. No mapeamento de negócio, mapear algum campo do Facebook para Negócio.Título (obrigatório apenas caso a criação de negócios esteja habilitada)

Mapeamento dos campos

A integração do Ploomes com o Facebook Lead Ads oferece suporte a todos os campos nativos da plataforma, assim como a todos os tipos de perguntas personalizadas criados nos formulários.

Campos de Resposta Curta, Condicionada e Hora Marcada

Podem ser mapeados para campos de texto simples ou multilinha do Ploomes, independentemente do valor informado.
Também é possível mapear para campos numéricos, porém o valor só será integrado corretamente se a resposta for totalmente numérica, sem espaços ou caracteres adicionais.
Recomendação: quando possível, utilize perguntas de múltipla escolha para restringir as respostas do lead ou mantenha o uso de campos de texto simples para evitar inconsistências.

Perguntas de Múltipla Escolha

Podem ser mapeadas para campos de Opção Pré‑Cadastrada do Ploomes.
Atenção: se as opções de resposta contiverem acentos ou espaços, o Ploomes poderá gerar variações indesejadas no nome da opção (por exemplo: substituir espaços por “_”, remover acentos ou converter para letras minúsculas).

Exemplo:

Opção no Facebook: 1 - A
Resultado no Ploomes: 1_-_a

No exemplo acima, a opção foi criada no Ploomes por um usuário como “1 - A” porque esta é uma das possíveis respostas no Facebook, na intenção de que essa fosse a opção utilizada pela integração ao integrar os leads. Porém, ao integrar um lead que selecionou a opção “1 - A” no Facebook, a integração criou e utilizou a opção “1_-_a”.

Para resolver isso, é necessário alterar como os nomes dos campos são exibidos ao exportar os leads no Facebook:

Na tela de perguntas do formulário, vá em Configurações > Configurações do formulário > Nomes dos campos:
Nessa tela, as perguntas e respostas presentes no formulário serão exibidas, e será possível a forma como os valores das opções serão integrados por padrão.
Nesta tela, revise as perguntas e respostas e defina como os valores devem ser exportados para o Ploomes.:

Ao salvar, as opções serão integradas de forma consistente, evitando problemas de formatação.

Informações importantes

Integração por Página do Facebook

Cada página do Facebook pode ser integrada apenas com uma única conta do Ploomes.
Para integrar a mesma página em outra conta do Ploomes, é necessário remover todos os mapeamentos existentes relacionados a essa página na conta anterior.

Identificação de Duplicidades

A integração realiza verificações para evitar a criação de registros duplicados ao importar leads:

Pessoas

Se o campo E-mail (nativo do Ploomes) estiver mapeado no formulário do Facebook, ele será utilizado para identificar duplicidades.
Caso o e-mail não esteja mapeado, a identificação é feita pelo campo “Id (Facebook Lead Ads)”, criado automaticamente pela integração.

Empresas

A duplicidade é verificada inicialmente pelo campo “Id (Facebook Lead Ads)” (campo customizado).
Se não houver correspondência, é utilizada a correspondência pelo Nome (nativo do Ploomes).

Negócios

O sistema verifica se o negócio pertence ao cliente e se o status está ativo antes de criar ou atualizar.

Campos Criados Automaticamente pela Integração

Além do campo “Id (Facebook Lead Ads)”, a integração cria também o campo “Formulário de origem (Facebook)” em contatos e empresas.
Este campo identifica qual formulário originou o lead, permitindo o uso em automações, filtros e relatórios.

Compatibilidade com Versões Anteriores

Em versões antigas da integração (e na documentação anterior), todos os mapeamentos — contato, cliente e negócio — eram configurados apenas na aba “Mapear campos de Negócios”.
Nessa configuração, os mapeamentos obrigatórios eram:
- Negócio.Título
- Negócio.Contato
- Negócio.Contato.Empresa

Estes mapeamentos ainda funcionam para contas antigas, mas recomendamos que novas configurações sejam feitas separando os mapeamentos por entidade (Pessoa, Empresa e Negócio) para facilitar manutenção e organização.

FAQ

1. Tenho mais de um formulário. Preciso mapear os campos duas vezes?

Sim. Cada formulário do Facebook Lead Ads possui seus próprios campos, mesmo que tenham o mesmo nome. Portanto, é necessário mapear os campos individualmente para cada formulário.

2. Meus leads estão vindo com um código ao invés do nome. Por quê?

Isso ocorre quando os campos Nome do Contato ou Nome da Empresa não foram mapeados.

Nesse caso, o Ploomes utiliza o código do lead gerado pelo Facebook para permitir a criação da Pessoa e da Empresa, já que o campo Nome é obrigatório.

3. Como identificar formulários diferentes na lista de mapeamento?

No mapeamento, os campos aparecem separados por pontos, indicando:

Página > Formulário (Ad) > Nome do Campo