Saltar al contenido principal

Solución de problemas

¿Tienes problemas? No te preocupes — ¡la mayoría tienen soluciones sencillas! Busca tu problema a continuación y sigue la solución.

Fallo en la verificación del webhook​

Error: "The callback URL or verify token couldn't be validated."

Posibles causas y soluciones:​

#CausaSolución
1La URL no es HTTPSInstala un certificado SSL en tu servidor
2Error tipográfico en la URL de callbackCopia y pega directamente desde la configuración del módulo
3Error tipográfico en el verify tokenCopia y pega directamente desde la configuración del módulo
4El servidor bloquea las peticionesRevisa tu firewall / plugins de seguridad
5Problemas de redirección en .htaccessAsegúrate de que la URL no redirija (sin problemas de redirección www ↔ no-www)
6Seleccionaste "User" en lugar de "Page"Cambia el menú desplegable a "Page" en los webhooks de Facebook

Cómo depurar:​

  1. Abre tu navegador y visita tu Webhook URL directamente: 
    https://yourcrm.com/facebookleadsintegration/webhook?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=test123
  2. Si funciona correctamente, deberías ver test123 mostrado en la página
  3. Si ves una página de error, el problema está en tu servidor
tip

¿Sigue sin funcionar? Revisa los logs de error de tu servidor en /path/to/your/crm/application/logs/

Error "Invalid Scopes" durante el inicio de sesión en Facebook​

Error: "Invalid Scopes: pages_manage_metadata"

Solución:​

Esto significa que el módulo solicita un permiso obsoleto. Asegúrate de usar la última versión del módulo (v2.0.0+), que usa los permisos correctos:

  • pages_show_list
  • pages_read_engagement
  • leads_retrieval
  • pages_manage_ads
  • ads_management

Actualiza tu módulo a la última versión para solucionarlo.

"Error Accessing App" / "App Not Active"​

Error: Al intentar conectar con Facebook ves "Error Accessing App" o "The app is not active."

Posibles causas y soluciones:​

#CausaSolución
1App ID incorrecto en la configuración del móduloVerifica que el App ID coincida con tu app Meta
2La app fue eliminada o deshabilitadaRevisa tu app en developers.facebook.com/apps
3No eres admin/desarrollador de la appAñádete en App Roles → Roles
4Restricciones de la appRevisa App Settings → Basic → App Restrictions

El lead de prueba funciona pero los leads reales no llegan​

El botón "Send Test Lead" del módulo funciona, pero los leads reales de Facebook no aparecen.

Comprueba esto:​

#ComprobaciónCómo
1¿Tu página está suscrita?Settings → Connected Pages → Debe mostrar "Monitoring"
2¿El webhook está verificado?Settings → Connection Status → Webhook debe estar en verde
3¿"leadgen" está suscrito?Meta App → Webhooks → Page → "leadgen" debe estar marcado
4¿El anuncio usa la página correcta?Ads Manager → Ad Set → Asegúrate de que usa la página suscrita
5¿El anuncio está activo?Ads Manager → El estado de la campaña debe ser "Active"

Prueba con la herramienta de Facebook:​

Usa la Lead Ads Testing Tool para enviar un lead de prueba real del webhook. Si esto funciona pero los anuncios reales no, el problema probablemente está en la configuración de tu campaña de anuncios.

Error 500 en las páginas del módulo​

Síntoma: Las páginas del módulo muestran una página en blanco o "500 Internal Server Error"

Soluciones:​

  1. Revisa los logs de error de PHP:

    /path/to/your/crm/application/logs/log-YYYY-MM-DD.php

  2. Causas comunes:

    • Versión de PHP demasiado antigua (necesitas 7.4+)
    • Extensiones PHP faltantes (cURL, JSON)
    • Permisos de archivos incorrectos
    • Archivos del módulo corruptos durante la subida

  3. Corregir permisos de archivos:

    find /path/to/modules/facebookleadsintegration -type f -exec chmod 644 {} \;
    find /path/to/modules/facebookleadsintegration -type d -exec chmod 755 {} \;

  4. Vuelve a subir el módulo si los archivos podrían estar corruptos

El botón Copy no funciona​

Síntoma: Hacer clic en el botón "Copy" junto a la webhook URL o verify token no hace nada.

Solución:​

  • Asegúrate de que tu CRM se acceda por HTTPS — la API del portapapeles requiere un contexto seguro
  • Prueba seleccionando manualmente el texto y pulsando Ctrl+C
  • Revisa la consola del navegador en busca de errores de JavaScript (F12 → pestaña Console)

Los leads se quedan en "Pending Retry"​

Síntoma: Sync History muestra leads con estado "Pending" que no se están procesando.

Soluciones:​

  1. Procesar manualmente: Ve a Sync History → Haz clic en "Process Retry Queue"
  2. Revisa el cron: La cola de reintento se procesa automáticamente mediante el cron job de Perfex CRM
    • Asegúrate de que tu cron job esté ejecutándose: Setup → Settings → Cron Job
    • La URL del cron debe llamarse cada 5 minutos
  3. Revisa el mensaje de error en Sync History para ver por qué falló el lead inicialmente

Token de acceso expirado​

Síntoma: La prueba de conexión falla con "Token expired" o los leads dejan de llegar.

Solución:​

El módulo intercambia tokens de corta duración por tokens de larga duración (válidos unos ~60 días). Para actualizar:

  1. Ve a Meta Leads → Settings
  2. Desplázate hasta Connected Pages
  3. Haz clic en "Connect with Facebook" de nuevo
  4. Inicia sesión y concede permisos
  5. El token se actualiza automáticamente
tip

Pon un recordatorio para reconectar cada 50 días y mantener el token actualizado.

Los campos no se mapean correctamente​

Síntoma: Los datos del lead aparecen en campos incorrectos o faltan.

Pasos para depurar:​

  1. Ve a Sync History → Haz clic en una entrada de lead para ver los datos crudos
  2. Comprueba qué nombres de campos envía Facebook
  3. Ve a Field Mapping → Asegúrate de que el nombre del campo de Facebook coincida
  4. Recuerda: los campos estándar (email, full_name, phone_number) se mapean automáticamente

Problemas comunes de nombres de campos:​

Lo que esperasLo que envía FacebookSolución
namefull_nameYa se mapea automáticamente
phonephone_numberYa se mapea automáticamente
companycompany_nameYa se mapea automáticamente
budgetcustom_question_1Crea un mapeo personalizado

El módulo no aparece después de la instalación​

Soluciones:​

  1. Revisa la ubicación de los archivos: La carpeta del módulo debe estar en modules/facebookleadsintegration/
  2. Revisa el nombre del archivo: El archivo principal debe ser facebookleadsintegration.php (todo en minúsculas)
  3. Activa el módulo: Ve a Setup → Modules → Haz clic en Activate
  4. Revisa los permisos: Los archivos deben ser legibles por el servidor web (644 para archivos, 755 para directorios)

Problemas específicos del servidor​

Usuarios de Cloudflare​

Si usas Cloudflare, añade las IPs del webhook de Facebook a la lista blanca:

  1. Ve a Cloudflare → WAF (Web Application Firewall)
  2. Crea una regla para Allow peticiones desde Facebook
  3. O añade estas a la lista blanca de tu firewall:
    • Las IPs del webhook de Facebook están en: https://developers.facebook.com/docs/sharing/webmasters/getting-started/webhooks/

Usuarios de Nginx​

Asegúrate de que tu configuración de Nginx permita peticiones POST a la webhook URL y no bloquee el User-Agent de Facebook.

Hosting compartido​

La mayoría del hosting compartido funciona bien. Si tienes problemas:

  • Comprueba si allow_url_fopen está habilitado en PHP
  • Comprueba si la extensión cURL está instalada
  • Comprueba si tu host bloquea webhooks entrantes (algunos hosts centrados en seguridad lo hacen)

¿Sigues necesitando ayuda?​

Si ninguna de las soluciones anteriores resuelve tu problema:

  1. Revisa los logs de error de Perfex CRM
  2. Revisa el Sync History del módulo en busca de mensajes de error
  3. Captura una captura de pantalla de cualquier mensaje de error
  4. Contáctanos en [email protected] con:
    • Tu versión de Perfex CRM
    • Versión de PHP
    • El mensaje de error
    • Pasos para reproducir el problema

Consulta el FAQ para más respuestas FAQ