Cómo recibir leads de Facebook Ads en tu CRM por webhook en segundos

28 de octubre de 2026 · Equipo Zoosial

Conecta tu página de Facebook a Zoosial, suscribe un webhook al evento lead.received y cada formulario de Meta (Lead Ads) que alguien llene llegará a tu CRM, normalmente en segundos, con sus respuestas y el anuncio de origen. No descargas archivos ni revisas el Administrador de anuncios a mano.

Cómo llega el lead

Meta avisa a Zoosial en cuanto se llena el formulario y Zoosial lo reenvía a tu webhook. Si ese aviso se pierde, un respaldo revisa los formularios cada pocos minutos. Los leads de otras fuentes distintas a los formularios de Meta se meten por tu propio sistema.

Paso a paso

1. Conecta tu página de Facebook con el inicio de sesión oficial desde el panel (crea tu cuenta gratis si aún no la tienes).
2. Crea tu endpoint en el CRM: una URL https que acepte POST. Los webhooks de salida solo van a https.
3. Suscribe el webhook:

   POST /hooks
   { "url": "https://tu-crm.com/zoosial", "events": ["lead.received"] }

   La respuesta devuelve el secret una sola vez: guárdalo.
4. Prueba sin esperar un lead real. POST /accounts/:id/lead-forms/:formId/test-webhook emite un lead.received de muestra con las preguntas reales de tu formulario.
5. Lanza el anuncio con formulario, desde Meta o desde Zoosial.

Qué trae el evento

El payload va anidado en data:

{
  "event": "lead.received",
  "data": {
    "formId": "…",
    "lead": {
      "id": "…", "created_time": "…",
      "ad_id": "…", "adset_id": "…", "campaign_id": "…",
      "is_organic": false,
      "field_data": [{ "name": "…", "values": ["…"] }]
    }
  }
}

El conjunto de anuncios viene en data.lead.adset_id, no en la raíz. Si el lead es orgánico o salió de una vista previa del anuncio, los campos de anuncio vienen vacíos o ausentes.

Verifica la firma

Cada entrega lleva la cabecera X-SocialGate-Signature: sha256=<hmac>, calculada con tu secret sobre el cuerpo crudo. Verifícala antes de procesar, sin volver a serializar el JSON. Hay reintentos con backoff, y puedes ver el historial en GET /hooks/:id/deliveries. Detalles en webhooks.

Y después del CRM

En el panel puedes mover cada lead por un embudo (nuevo, contactado, calificado, ganado o perdido) con valor y notas; también por API con PATCH /accounts/:id/lead-states/:leadId. Desde tu sistema puedes mandar un WhatsApp o pedir que una llamada con IA contacte al lead ($0.125 USD el minuto). Ver Leads y CRM y la documentación.

Lo que debes saber

• Zoosial recibe leads de formularios de Meta, no de otras fuentes.
• Meta no permite editar un formulario ya creado: si cambias las preguntas, se crea otro.
• Si prefieres no usar webhooks, puedes leer los leads con GET /accounts/:id/leads.

Todo el contrato está en llms.txt. Puedes empezar gratis.

Preguntas frecuentes

← Todos los artículos