Fuentes de Leads — Guía de Configuración
LeadHub puede recibir leads de 19 fuentes diferentes. La mayoría funcionan mediante webhook — usted pega una URL generada por LeadHub en la plataforma externa y los leads fluyen automáticamente.
Cómo Funciona Cada Fuente Basada en Webhook
- Vaya a Integraciones → Fuentes de Leads y cree una nueva conexión.
- Seleccione el tipo de fuente y configure el mapeo de campos.
- Copie la URL del Webhook Entrante generada.
- Pegue la URL en la plataforma externa (instrucciones por fuente abajo).
- Pruebe enviando un lead de prueba — aparece en su espacio de trabajo en segundos.
Facebook Lead Ads (Meta)
Facebook Lead Ads permite a los usuarios enviar un formulario dentro de Facebook/Instagram sin salir de la app.
Meta ya no ofrece la opción Otro bajo Integración CRM en los formularios de leads, por lo que ya no es posible pegar una URL de webhook a nivel de formulario. En su lugar, conéctese mediante OAuth y un webhook a nivel de app, como se describe a continuación.
Paso 1 — Configure su App de Meta
Cree (o abra) una app de tipo Business en developers.facebook.com:
-
Agregue el producto Facebook Login.
-
Configuración de la App → Básica → Dominios de la App: agregue su dominio de LeadHub (p. ej.
crm.example.com). -
Facebook Login → Configuración → Valid OAuth Redirect URIs: agregue
https://YOUR-DOMAIN/oauth/meta/callbackDebe coincidir exactamente con el
APP_URLde su instalación, incluidohttps.
Agregar el dominio y la URI de redirección también corrige el error "Can't load URL. The domain of this URL isn't included in the app's domains."
Paso 2 — Conecte en LeadHub
- Vaya a Conexiones de Fuentes de Leads y agregue una conexión de tipo Meta.
- Ingrese su App ID y App Secret.
- Haga clic en Conectar vía OAuth, apruebe los permisos solicitados y seleccione su Página.
- LeadHub guarda automáticamente el token de acceso de la Página en la conexión.
Paso 3 — Configure el Webhook de Leadgen (a Nivel de App de Meta)
Esto reemplaza la opción "Otro" a nivel de formulario que fue eliminada:
- En el Panel de la App → Webhooks, elija el objeto Page.
- Suscríbase al campo
leadgen. - Callback URL y Verify Token: copie ambos desde la pantalla de la conexión de Meta en LeadHub.
- Suscriba su Página.
Los nuevos leads ahora fluyen automáticamente — Meta envía cada lead al webhook y LeadHub obtiene los detalles completos del lead desde la Graph API usando el token de acceso de su Página.
Permisos y Revisión de la App
La conexión OAuth solicita estos permisos (scopes): leads_retrieval, pages_show_list, pages_read_engagement, pages_manage_ads.
Estos permisos requieren la Revisión de la App de Meta (App Review) + Verificación del Negocio (Business Verification) antes de funcionar para cuentas distintas de los Administradores, Desarrolladores o Testers de la propia app.
Para probar antes de la aprobación, puede:
- Agregarse como Administrador / Desarrollador / Tester en la app de Meta, o
- Pegar un Page Access Token (generado en el Graph API Explorer de Meta con
leads_retrieval) en el campo Page Access Token de la conexión — LeadHub lee los leads directamente con él.
Ejemplo de Mapeo de Campos
| Campo de Facebook | Campo de LeadHub |
|---|---|
full_name | first_name |
email | email |
phone_number | phone |
Alternativamente, use Zapier o n8n como puente si necesita más control sobre el payload.
Instagram, TikTok, LinkedIn, WhatsApp Business, Telegram, Viber, Twitter/X
Cada una de estas fuentes sigue el mismo patrón básico:
- Cree una Conexión de Fuente de Leads en LeadHub con el tipo correspondiente.
- Copie la URL del Webhook generada.
- Configúrela en la plataforma de origen según sus instrucciones específicas.
Para detalles completos de cada plataforma, consulte la guía en inglés o las instrucciones mostradas en la pantalla de configuración de la conexión en LeadHub.
Snapchat, Pinterest, Google Ads, YouTube, Microsoft Advertising
Estas plataformas publicitarias también funcionan mediante webhook o a través de Zapier como puente:
- Cree una Conexión de Fuente de Leads en LeadHub con el tipo correspondiente.
- Copie la URL del Webhook.
- Configúrela en el administrador de anuncios de la plataforma correspondiente.
Typeform
Pasos de Configuración
- Cree una Conexión de Fuente de Leads: Tipo → Typeform.
- Copie la URL del Webhook.
- En Typeform → Su Formulario → Conectar → Webhooks:
- Haga clic en Agregar un webhook.
- Pegue la URL del Webhook de LeadHub.
- Habilite el webhook.
JotForm
Pasos de Configuración
- Cree una Conexión de Fuente de Leads: Tipo → JotForm.
- Copie la URL del Webhook.
- En JotForm → Su Formulario → Configuración → Integraciones → Webhooks:
- Pegue la URL del Webhook.
- Haga clic en Completar Integración.
Calendly
Pasos de Configuración
- Cree una Conexión de Fuente de Leads: Tipo → Calendly.
- Copie la URL del Webhook.
- En Calendly → Integraciones → Webhooks → Crear Nuevo Webhook:
- Pegue la URL del Webhook.
- Seleccione el evento invitee.created.
Formulario Web de LeadHub
Cuando alguien envía un formulario creado con el Generador de Formularios de LeadHub, se crea un lead automáticamente — no se necesita configuración de webhook. Consulte Generador de Formularios.
Correo (IMAP)
Capture leads de correos entrantes a una bandeja de entrada monitoreada.
Pasos de Configuración
- Cree una dirección de correo dedicada para captura de leads.
- En LeadHub, cree una conexión: Tipo → Correo (IMAP).
- Ingrese host IMAP, puerto, usuario, contraseña y carpeta.
- LeadHub sondea la bandeja de entrada cada 5 minutos (mediante el trabajo cron) y crea un lead de cada nuevo correo.
Webhook Genérico (Cualquier Plataforma)
Para cualquier plataforma no listada anteriormente, use el tipo de conexión Webhook Genérico. Obtendrá una URL que acepta cualquier carga JSON y podrá configurar el mapeo de campos para extraer datos del lead.
curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]","first_name":"Test","last_name":"Lead","phone":"+1555000000"}'