Mapeamento de Campos
O mapeamento de campos é como você informa ao módulo: "Quando o Facebook enviar um campo chamado email, coloque-o no campo Email do Perfex CRM."
Como Acessar
Vá para Meta Leads → Field Mapping na barra lateral.
Ou navegue para: https://yourcrm.com/admin/facebookleadsintegration/field_mapping
Como Funciona o Mapeamento de Campos
Quando alguém preenche seu Lead Form no Facebook/Instagram, os dados ficam assim:
{
"full_name": "John Smith",
"email": "[email protected]",
"phone_number": "+1234567890",
"company_name": "Acme Corp",
"city": "New York"
}
O módulo precisa saber onde colocar cada valor no Perfex CRM:
Facebook Field → Perfex CRM Field
─────────────────────────────────────────────
full_name → Lead Name
email → Email
phone_number → Phone
company_name → Company
city → City
Mapeamentos Padrão (Automático!)
Boas notícias! O módulo vem com mapeamentos padrão integrados para campos comuns do Facebook. Eles funcionam automaticamente - sem configuração necessária!
| Facebook Field | Perfex CRM Field | Auto-Mapped? |
|---|---|---|
full_name | Lead Name | Yes |
first_name + last_name | Lead Name | Yes |
email | Yes | |
phone_number | Phone | Yes |
company_name | Company | Yes |
street_address | Address | Yes |
city | City | Yes |
state | State | Yes |
country | Country | Yes |
zip_code | Zip Code | Yes |
website | Website | Yes |
job_title | Position | Yes |
Se seu Lead Form usar esses nomes de campo padrão do Facebook, tudo será mapeado automaticamente! Você não precisa configurar nada.
Mapeamentos de Campos Personalizados
Para quaisquer campos não padrão (perguntas personalizadas no seu Lead Form), você pode criar mapeamentos personalizados.
Adicionando um Mapeamento Personalizado
- Vá para a página Field Mapping
- Clique em "Add Mapping"
- Preencha:
| Coluna | O que Inserir | Exemplo |
|---|---|---|
| Facebook Field (caixa esquerda) | O nome do campo do seu Lead Form | budget |
| Perfex CRM Field (dropdown direito) | Onde armazenar no Perfex | "Description" ou um campo personalizado |
- Clique em "Save Mappings"
Exemplo: Perguntas Personalizadas
Digamos que seu Lead Form pergunte: "What's your monthly budget?"
Se você nomeou o campo como monthly_budget no seu Lead Form:
Facebook Field: monthly_budget → Perfex CRM Field: Description
Ou se você tem um campo personalizado no Perfex:
Facebook Field: monthly_budget → Perfex CRM Field: leads_budget (custom)
Usando Custom Fields do Perfex CRM
Se você criou campos personalizados para leads no Perfex CRM, eles aparecerão no dropdown em "Custom Fields".
Como Criar um Campo Personalizado:
- No Perfex CRM, vá para Setup → Custom Fields
- Clique em New Custom Field
- Configure:
- Field Belongs To: Leads
- Field Name: ex.: "Budget"
- Slug: ex.:
leads_budget
- Salve
Este campo personalizado agora aparecerá no dropdown de Field Mapping!
Dica profissional: Nomeie os campos do formulário Facebook usando o mesmo slug dos seus Custom Fields do Perfex (ex.: leads_budget), e eles serão mapeados automaticamente sem configuração manual!
Encontrando os Nomes dos Campos do Facebook
Não tem certeza de como os campos do seu formulário Facebook são chamados? Aqui está como descobrir:
Método 1: Verificar o Lead Form no Ads Manager
- Vá para Facebook Ads Manager
- Abra sua campanha → Ad set → Ad
- Clique no Lead Form
- Veja os nomes dos campos ("Field Name" ou "Question ID")
Método 2: Verificar um Lead de Teste
- Envie um lead de teste pelo módulo (Settings → "Send Test Lead")
- Vá para Sync History
- Clique no registro do lead de teste
- Você verá os nomes exatos dos campos enviados pelo Facebook
Método 3: Usar o Facebook Lead Ads Testing Tool
- Vá para Lead Ads Testing Tool
- Selecione sua Page e Form
- Crie um lead de teste
- Verifique Sync History para os nomes dos campos
Removendo Mapeamentos
Para remover um mapeamento personalizado:
- Clique no botão vermelho ✕ ao lado da linha do mapeamento
- Clique em "Save Mappings"
Remover um mapeamento não exclui leads existentes - afeta apenas leads futuros.
Prioridade de Mapeamento
Quando um lead chega, o módulo processa os campos nesta ordem:
- Mapeamentos personalizados (suas configurações manuais) - verificados primeiro
- Mapeamentos padrão (campos padrão integrados) - usados como fallback
- Auto-detecção (se o nome do campo corresponde ao slug de um Custom Field do Perfex)
Isso significa que seus mapeamentos personalizados sempre têm prioridade sobre os padrão!
Perguntas Comuns
"E se eu não configurar nenhum mapeamento?"
Os mapeamentos padrão cuidarão de todos os campos padrão automaticamente. Você só precisa de mapeamentos personalizados para perguntas personalizadas nos seus Lead Forms.
"E se o Facebook enviar um campo que eu não mapeei?"
Será armazenado no campo Description do lead como dados adicionais, então você nunca perde informações.
"Posso mapear um campo do Facebook para múltiplos campos do Perfex?"
Não diretamente - cada campo do Facebook mapeia para um campo do Perfex. Se precisar disso, use as workflow automations do Perfex CRM.
Pronto para aprender sobre Lead Ads? What Are Lead Ads?