Saltar al contenido principal

Configurar Webhooks

Ahora indicaremos a Facebook dónde enviar los datos de los leads. Esto se llama "webhook" - es como darle a Facebook la dirección postal de tu CRM.

¿Qué es un Webhook?​

En términos simples:

Alguien rellena tu formulario de leads en Facebook/Instagram
         ↓
Facebook dice: "¡Oye, tengo un nuevo lead!"
         ↓
Facebook envía los datos del lead a TU URL de webhook
         ↓
Tu módulo lo recibe y crea el lead en Perfex CRM

Un webhook es simplemente una URL en tu servidor a la que Facebook envía datos. El módulo crea esta URL automáticamente - solo necesitas indicarle a Facebook cuál es.

Obtener los detalles del webhook desde Perfex​

Antes de ir a Facebook, obtengamos los detalles desde tu módulo:

  1. Inicia sesión en Perfex CRM
  2. Ve a Meta Leads → Settings en la barra lateral
  3. Primero, introduce tu App ID y App Secret (del Paso 1) y haz clic en Save Settings
  4. Baja hasta la sección Webhook Settings
  5. Verás dos valores:
CampoEjemploQué es
Webhook Callback URLhttps://yourcrm.com/facebookleadsintegration/webhookDonde Facebook envía los datos
Verify Tokena1b2c3d4e5f6g7h8i9j0Un código secreto para verificar la conexión
  1. Haz clic en el botón Copy junto a cada valor
aviso

La Callback URL DEBE comenzar con https:// - ¡Facebook requiere SSL! Si tu URL comienza con http://, necesitas instalar primero un certificado SSL.

Añadir Webhooks a tu app de Meta​

1. Abre el panel de tu app de Meta​

Ve a tu app en:

👉 https://developers.facebook.com/apps/

Haz clic en tu app para abrirla.

2. Añade el producto Webhooks​

  1. En la barra lateral izquierda, busca "Add Product" o baja por el panel
  2. Encuentra "Webhooks" en la lista de productos
  3. Haz clic en "Set Up" o "Configure"
tip

Si ya ves "Webhooks" en la barra lateral izquierda, haz clic directamente - no hace falta añadirlo de nuevo.

3. Selecciona "Page" como tipo de objeto​

  1. En la página de Webhooks, verás un desplegable que dice "User" por defecto
  2. Cambia este desplegable a "Page"
aviso

¡Esto es crítico! DEBES seleccionar "Page" - ni "User", ni "Application", ni nada más. Los datos de leads llegan a través de suscripciones de Página.

4. Suscríbete al Webhook​

  1. Haz clic en el botón "Subscribe to this object" (o "Edit Subscription" si ya está configurado)
  2. Aparecerá un cuadro de diálogo pidiendo dos valores:
CampoQué introducir
Callback URLPega tu URL de Webhook del módulo (ej: https://yourcrm.com/facebookleadsintegration/webhook)
Verify TokenPega tu Verify Token del módulo
  1. Haz clic en "Verify and Save"

5. Qué ocurre al hacer clic en "Verify and Save"​

Facebook enviará inmediatamente una solicitud de verificación a tu URL de webhook:

Facebook: "Oye, ¿es realmente tu servidor?"
Tu Módulo: "¡Sí! Aquí está el verify token para demostrarlo!"
Facebook: "¡Genial, verificado!"

Si funciona: Verás un mensaje de éxito y el diálogo se cerrará.

Si falla: Consulta la sección Solución de problemas para soluciones comunes.

6. Suscríbete a eventos "leadgen"​

Tras la verificación, debes indicar a Facebook qué eventos enviar:

  1. Verás una lista de tipos de eventos bajo suscripciones de "Page"
  2. Busca "leadgen" en la lista (quizá necesites desplazarte)
  3. Haz clic en el interruptor/casilla "Subscribe" junto a "leadgen"
tip

"leadgen" es el ÚNICO evento que necesitas. No necesitas suscribirte a ningún otro evento (como "messages" o "feed"). Solo "leadgen".

¡Verificación exitosa!​

La configuración de tu webhook debería verse así:

Webhooks
├── Object: Page
├── Callback URL: https://yourcrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Verificado
└── Subscriptions:
    └── ✅ leadgen (suscrito)

De vuelta en tu módulo de Perfex CRM, el indicador de estado del webhook debería mostrar verde/Verificado ahora.

Cómo probar el Webhook​

¿Quieres asegurarte de que el webhook funciona?

  1. Ve a tu Perfex CRM → Meta Leads → Settings
  2. Haz clic en el botón "Test Connection"
  3. Deberías ver todas las marcas verdes

Haremos pruebas más exhaustivas más adelante en la sección Probar leads.

Errores comunes a evitar​

ErrorSolución
Seleccionaste "User" en lugar de "Page"Cambia el desplegable a "Page"
Olvidaste suscribirte a "leadgen"Busca "leadgen" en la lista y suscríbete
Usar HTTP en lugar de HTTPSInstala certificado SSL en tu servidor
Error tipográfico en la Callback URLCopia-pega directamente desde la configuración del módulo
"Callback URL couldn't be validated"Consulta Solución de problemas

¿Webhook configurado? Conectar tus Páginas