Configuração

Lead Ads (Meta e LinkedIn)

Cada formulário preenchido nos seus anúncios do Facebook/Instagram (Meta Lead Ads) ou do LinkedIn (Lead Gen Forms) vira um Lead no CRM, usando o seu próprio app (modelo BYO).

A integração de Lead Ads usa o SEU app e a SUA página/conta de anúncios (modelo BYO, "traga o seu próprio app"). Quando alguém preenche um formulário de lead num anúncio do Facebook/Instagram (Meta) ou do LinkedIn, o CRM cria automaticamente um Lead e atribui um responsável por rodízio, igual à captação por formulário público. Não há custo, margem nem intermediação nossa: os dados vêm direto da sua conta de anúncios.

A integração nasce inerte: nada acontece até você preencher as credenciais e ativar. O App Secret e os tokens de acesso ficam cifrados no CRM e nunca são exibidos de volta.

Pré-requisitos

Meta: um app em developers.facebook.com, uma Página do Facebook que roda os anúncios e permissões leads_retrieval e pages_manage_metadata; você vai precisar do App Secret e de um page access token de longa duração.
LinkedIn: um app em linkedin.com/developers com acesso à Lead Sync / Advertising API e um access token OAuth com escopo r_marketing_leadgen_automation.
Ter formulários de Lead (Meta Lead Ads / LinkedIn Lead Gen Forms) já criados nas suas campanhas.
No Sellio, ser administrador para salvar as credenciais e ativar a integração em Configurações → Integrações.

Como funciona o Meta (Facebook/Instagram)

O webhook do Meta NÃO manda os dados do formulário: ele manda apenas um identificador (leadgen_id). Ao receber, o CRM verifica a assinatura do evento (HMAC-SHA256 do corpo com o seu App Secret) e então BUSCA o lead na Graph API do Meta usando o seu page access token, obtendo os campos preenchidos (field_data). Esses campos são mapeados para os campos do Lead e o Lead é criado.

Configurar o Meta: no painel do Meta

Crie (ou use) um app em developers.facebook.com. Em Configurações → Básico, copie o App Secret.
Adicione o produto "Webhooks" e o objeto/produto de Leadgen (Leads Access). Peça as permissões leads_retrieval e pages_manage_metadata para a sua página.
Gere um page access token de longa duração para a página que roda os anúncios (Graph API Explorer ou Business Manager).
Guarde tudo: você vai colar o App Secret, o page token e um "verify token" (um texto que você inventa) no CRM.

Configurar o Meta: no CRM

Abra Configurações → Integrações e localize o cartão "Meta Lead Ads (Facebook/Instagram)".
Verify token: invente um texto e digite-o. Você vai usar o MESMO valor no painel do Meta.
App Secret e Page access token: cole os dois (são salvos juntos, cifrados) e clique em "Salvar credenciais".
Copie a "URL do webhook (Meta)" que aparece.
De volta ao painel do Meta → Webhooks, cole essa URL como Callback URL e o seu verify token como Verify Token. O Meta faz um handshake (GET) e o CRM responde ao desafio se o verify token casar.
Assine o campo "leadgen" da sua página. Depois volte ao CRM e clique em "Ativar".

Configurar o LinkedIn

No LinkedIn (Lead Gen Forms), crie um app em linkedin.com/developers, solicite os produtos de Lead Sync / Advertising API e gere um access token OAuth com escopo de lead gen (r_marketing_leadgen_automation). No CRM, no cartão "LinkedIn Lead Gen Forms", cole o access token (e opcionalmente o URN da organização), salve e ative. Aponte a sua automação (ou o pull das respostas do formulário) para a "URL de recebimento (LinkedIn)", enviando um JSON com os campos do formulário.

Mapeamento de campos

Cada linha do mapeamento liga o NOME de um campo do formulário do anúncio (à esquerda) a um campo do Lead (à direita, pelo api_name: email, name, phone, company, title…). Já vêm padrões sensatos: full_name → name, email → email, phone_number → phone, company_name → company. Adicione linhas só para campos personalizados do seu formulário. Se o formulário mandar first_name e last_name separados (comum no LinkedIn), eles são combinados no nome.

Exemplo: Formulário do Meta com full_name, email, phone_number e um campo personalizado "orcamento" → mapeie orcamento para um campo do Lead (ex.: segment). Os demais já são mapeados pelos padrões.

💡 A criação é idempotente: o mesmo lead não é duplicado. O CRM dedup por leadgen_id (reentrega do webhook) e por e-mail. Se o formulário não trouxer e-mail, o lead é ignorado, pois o e-mail é o único campo obrigatório do Lead. Se o campo "empresa" vier preenchido, o CRM localiza ou cria a Empresa correspondente e vincula.

Trate a URL do webhook, o App Secret e os tokens como secretos. Assinaturas inválidas são recusadas (401). Sem o page access token, o CRM não consegue buscar os dados do lead na Graph API, por isso cole o token junto com o App Secret. Limitação: o pull nativo do LinkedIn (assinar leadNotifications e depois buscar as respostas via API) é documentado aqui e pode ser plugado; hoje a rota recebe um payload de resposta de formulário já normalizado.

Como testar

Meta: no painel do Meta → Webhooks, o handshake (GET) já valida o verify token ao salvar a Callback URL. Depois, use a "Lead Ads Testing Tool" do Meta (developers.facebook.com/tools/lead-ads-testing) para enviar um lead de teste no seu formulário.
Confira no CRM: um novo Lead deve aparecer com os campos mapeados; se veio empresa, a Empresa é localizada/criada e vinculada.
LinkedIn: dispare (ou envie manualmente) um payload de resposta de formulário para a "URL de recebimento (LinkedIn)" e confira o Lead criado.

Solução de problemas

O handshake do Meta falha: o verify token digitado no CRM precisa ser IDÊNTICO ao Verify Token no painel do Meta. Ajuste-os iguais e salve.
Recebe o webhook mas não cria o Lead: sem o page access token o CRM não busca o field_data na Graph API. Cole o page token JUNTO com o App Secret. Confirme as permissões leads_retrieval/pages_manage_metadata e que você assinou o campo "leadgen" da página.
Assinatura inválida (401): o App Secret no CRM difere do app do Meta (a assinatura é HMAC-SHA256 do corpo com o App Secret). Recole o App Secret correto.
Lead sem e-mail é ignorado: o e-mail é o único campo obrigatório do Lead. Garanta o campo de e-mail no formulário do anúncio.
Campos não preenchem: revise o Mapeamento (nome do campo do formulário → api_name do Lead). No LinkedIn, first_name + last_name são combinados no nome automaticamente.

Abrir este artigo dentro do sistema →