Testing Leads

Antes de ir para produção, vamos garantir que tudo funciona perfeitamente! Aqui estão várias formas de testar.

Método 1: Test Lead Integrado do Módulo (Mais Fácil!)

A forma mais rápida de testar o fluxo completo:

1. Vá a Meta Leads → Settings
2. Clique no botão "Send Test Lead"
3. Um lead de teste será criado no Perfex CRM
4. Será perguntado: "Test lead created! Would you like to view it?"
5. Clique em Yes para ver o lead

O Que Isto Testa:

• O módulo está a funcionar
• Criação de lead no Perfex CRM
• Atribuição padrão, fonte e estado
• Mapeamento de campos para campos padrão

O Que Isto NÃO Testa:

• Entrega de webhook do Facebook
• Ligação Facebook → seu servidor
• Nomes reais de campos do formulário Facebook

dica

Use isto para uma verificação rápida, depois passe ao Método 2 para um teste completo.

Método 2: Facebook Lead Ads Testing Tool (Recomendado!)

Esta é a melhor forma de testar o fluxo completo – do Facebook até ao seu CRM, sem gastar dinheiro em anúncios.

Passo a Passo:

1. Vá a: 👉 https://developers.facebook.com/tools/lead-ads-testing/

2. Selecione a sua Page no dropdown

   • Escolha a Page que subscreveu no módulo

3. Selecione um Formulário (ou crie um formulário de teste)

   • Se ainda não criou um Lead Form, precisará de criar um primeiro no Ads Manager
   • Ou crie um formulário de teste rápido (ver abaixo)

4. Clique em "Create Lead"

5. Em segundos, verifique o seu Perfex CRM:

   • Vá a Leads – deve ver um novo lead!
   • Vá a Meta Leads → Sync History – verá o registo de sync

O Que Isto Testa:

• Tudo! O fluxo completo do mundo real
• O Facebook envia dados de webhook reais
• O seu servidor recebe e processa
• O lead é criado no Perfex CRM
• O mapeamento de campos funciona com nomes reais de campos do Facebook

informação

Este é o teste definitivo. Se isto funcionar, os Lead Ads reais também funcionarão.

Método 3: Botão Test Connection

Testa as suas credenciais e permissões (mas não a entrega de leads):

1. Vá a Meta Leads → Settings
2. Clique em "Test Connection"
3. Deve ver:

✅ App Credentials: Valid
   App ID is configured and accessible

✅ Access Token: Valid  
   Token is valid and has access to your pages

✅ Permissions: All required permissions granted
   pages_show_list, pages_read_engagement, leads_retrieval, 
   pages_manage_ads, ads_management

aviso

Se alguma permissão aparecer como em falta, religue o Facebook (botão Connect with Facebook na secção Pages).

Método 4: Criar Formulário de Teste Rápido

Se ainda não tem um Lead Form para o Testing Tool:

1. Vá ao Ads Manager
2. Clique em "+ Create" → Objectivo: Leads
3. Configure um ad set básico (orçamento, audiência – não importa para testar)
4. Na secção Ad, clique em "Create Form"
5. Adicione estes campos básicos:
   • Full Name
   • Email
   • Phone Number
6. Adicione um URL de política de privacidade (qualquer URL funciona para testar)
7. Guarde o formulário (não precisa de publicar a campanha!)
8. Volte ao Testing Tool – o seu formulário aparecerá no dropdown

Verificar Histórico de Sync

Após qualquer teste, verifique a página Sync History:

1. Vá a Meta Leads → Sync History
2. Verá uma tabela com todas as tentativas de sync:

Column	Example	Meaning
Date/Time	2026-02-06 10:30:15	Quando o lead foi recebido
Meta Lead ID	123456789	ID interno do lead do Facebook
Perfex Lead	#42 - John Smith	O lead criado no Perfex (com link)
Status	Success	Se o sync foi bem-sucedido
Message	Lead created successfully	Detalhes sobre o sync

Tipos de Estado:

Status	Significado	O Que Fazer
Success	Lead criado no Perfex	Nada – funcionou!
Failed	Algo correu mal	Verifique a mensagem de erro
Skipped	Lead era duplicado	Esperado se detecção de duplicados está activa
Pending	Na fila de retry	Será repetido automaticamente

Lista de Verificação de Testes

Percorra esta lista para garantir que tudo funciona:

• Test Connection – Todas as marcas verdes
• Send Test Lead – Lead aparece no CRM
• Facebook Testing Tool – Lead aparece no CRM via webhook
• Verificar Sync History – Entrada mostra "Success"
• Verificar o Lead – Todos os campos estão correctamente mapeados
• Verificar Atribuição – Lead está atribuído ao membro da equipa correcto
• Verificar Fonte – Lead tem a fonte correcta
• Verificar Estado – Lead tem o estado inicial correcto
• Notificação por Email – Email recebido (se activado) |

Teste Falhou?

Não entre em pânico! Consulte a página Troubleshooting para soluções de problemas comuns.

Todos os Testes Passaram?

Parabéns! A sua integração Meta Leads está totalmente configurada e a funcionar!

Agora pode:

1. Criar e executar campanhas Lead Ad reais
2. Monitorizar leads no Sync History
3. Fazer follow-up com leads no Perfex CRM
4. Deixar a automação fazer o trabalho!

Tem problemas? Troubleshooting