Lead Ads (Meta y LinkedIn)

Cada formulario completado en tus anuncios de Facebook/Instagram (Meta Lead Ads) o de LinkedIn (Lead Gen Forms) se convierte en un Lead en el CRM, usando tu propia app (modelo BYO).

La integración de Lead Ads usa TU app y TU página o cuenta de anuncios (modelo BYO, o sea, "trae tu propia app"). Cuando alguien completa un formulario de lead en un anuncio de Facebook/Instagram (Meta) o de LinkedIn, el CRM crea automáticamente un Lead y le asigna un responsable por rotación (round-robin), igual que la captación por formulario público. Nosotros no cobramos nada ni intervenimos: los datos vienen directo de tu cuenta de anuncios.

La integración nace inerte: no ocurre nada hasta que completes las credenciales y la actives. El App Secret y los tokens de acceso quedan cifrados en el CRM y nunca se muestran de vuelta.

Requisitos previos

• Meta: una app en developers.facebook.com, una Página de Facebook que ejecuta los anuncios y los permisos leads_retrieval y pages_manage_metadata; necesitarás el App Secret y un page access token de larga duración.
• LinkedIn: una app en linkedin.com/developers con acceso a la Lead Sync / Advertising API y un access token OAuth con el alcance r_marketing_leadgen_automation.
• Tener formularios de Lead (Meta Lead Ads / LinkedIn Lead Gen Forms) ya creados en tus campañas.
• En Sellio, ser administrador para guardar las credenciales y activar la integración en Configuración → Integraciones.

Cómo funciona Meta (Facebook/Instagram)

El webhook de Meta NO envía los datos del formulario: solo envía un identificador (leadgen_id). Al recibirlo, el CRM verifica la firma del evento (HMAC-SHA256 del cuerpo con tu App Secret) y luego BUSCA el lead en la Graph API de Meta usando tu page access token, obteniendo los campos completados (field_data). Esos campos se mapean a los campos del Lead y el Lead se crea.

Configurar Meta: en el panel de Meta

1. Crea (o usa) una app en developers.facebook.com. En Configuración → Básico, copia el App Secret.
2. Agrega el producto "Webhooks" y el objeto/producto de Leadgen (Leads Access). Solicita los permisos leads_retrieval y pages_manage_metadata para tu página.
3. Genera un page access token de larga duración para la página que ejecuta los anuncios (Graph API Explorer o Business Manager).
4. Guarda todo: pegarás el App Secret, el page token y un "verify token" (un texto que tú inventas) en el CRM.

Configurar Meta: en el CRM

1. Abre Configuración → Integraciones y localiza la tarjeta "Meta Lead Ads (Facebook/Instagram)".
2. Verify token: inventa un texto y escríbelo. Usarás el MISMO valor en el panel de Meta.
3. App Secret y Page access token: pega ambos (se guardan juntos, cifrados) y haz clic en "Guardar credenciales".
4. Copia la "URL del webhook (Meta)" que aparece.
5. De vuelta en el panel de Meta → Webhooks, pega esa URL como Callback URL y tu verify token como Verify Token. Meta hace un handshake (GET) y el CRM responde al desafío si el verify token coincide.
6. Suscríbete al campo "leadgen" de tu página. Luego vuelve al CRM y haz clic en "Activar".

Configurar LinkedIn

En LinkedIn (Lead Gen Forms), crea una app en linkedin.com/developers, solicita los productos de Lead Sync / Advertising API y genera un access token OAuth con alcance de lead gen (r_marketing_leadgen_automation). En el CRM, en la tarjeta "LinkedIn Lead Gen Forms", pega el access token (y opcionalmente el URN de la organización), guarda y activa. Apunta tu automatización (o el pull de las respuestas del formulario) a la "URL de entrada (LinkedIn)", enviando un JSON con los campos del formulario.

Mapeo de campos

Cada fila del mapeo conecta el NOMBRE de un campo del formulario del anuncio (a la izquierda) con un campo del Lead (a la derecha, por api_name: email, name, phone, company, title…). Ya vienen valores predeterminados sensatos: full_name → name, email → email, phone_number → phone, company_name → company. Agrega filas solo para campos personalizados de tu formulario. Si el formulario envía first_name y last_name por separado (común en LinkedIn), se combinan en el nombre.

Trata la URL del webhook, el App Secret y los tokens como secretos. Las firmas inválidas se rechazan (401). Sin el page access token, el CRM no puede buscar los datos del lead en la Graph API, así que pega el token junto con el App Secret. Limitación: el pull nativo de LinkedIn (suscribirse a leadNotifications y luego buscar las respuestas vía API) se documenta aquí y puede conectarse; hoy la ruta recibe un payload de respuesta de formulario ya normalizado.

Cómo probar

1. Meta: en el panel de Meta → Webhooks, el handshake (GET) ya valida el verify token al guardar la Callback URL. Luego, usa la "Lead Ads Testing Tool" de Meta (developers.facebook.com/tools/lead-ads-testing) para enviar un lead de prueba en tu formulario.
2. Verifica en el CRM: debe aparecer un nuevo Lead con los campos mapeados; si vino empresa, la Empresa se localiza/crea y se vincula.
3. LinkedIn: dispara (o envía manualmente) un payload de respuesta de formulario a la "URL de entrada (LinkedIn)" y verifica el Lead creado.

Solución de problemas

• El handshake de Meta falla: el verify token escrito en el CRM debe ser IDÉNTICO al Verify Token del panel de Meta. Igualálos y guarda.
• Recibe el webhook pero no crea el Lead: sin el page access token el CRM no busca el field_data en la Graph API. Pega el page token JUNTO con el App Secret. Confirma los permisos leads_retrieval/pages_manage_metadata y que te suscribiste al campo "leadgen" de la página.
• Firma inválida (401): el App Secret del CRM difiere del app de Meta (la firma es HMAC-SHA256 del cuerpo con el App Secret). Vuelve a pegar el App Secret correcto.
• Un lead sin correo se ignora: el correo es el único campo obligatorio del Lead. Garantiza el campo de correo en el formulario del anuncio.
• Los campos no se completan: revisa el Mapeo (nombre del campo del formulario → api_name del Lead). En LinkedIn, first_name + last_name se combinan en el nombre automáticamente.

Abrir este artículo dentro del sistema →