Adelys Docs

Biblioteca › Portales e integraciones › Facebook e Instagram Lead Ads

Conectar Facebook e Instagram Lead Ads

Al terminar, cada persona que rellene un formulario de tus anuncios de Facebook o Instagram aparecerá en tu lista de Leads en segundos, asignada a quien elegiste, con sus respuestas en las notas y sin duplicar a quien ya estaba en el CRM.

Módulo: Leads → Opciones Todos los planes Solo administrador ⏱ 25 min

Antes de empezar

Paso a paso

Míralo hecho. Los pasos de este tutorial, tal cual en el CRM: el cursor hace cada clic donde se hizo de verdad. Pulsa el número de un paso para ir a su cuadro.

crm.adelys.app/leads
Cargando el flujo…
1

Abre la conexión en Leads

Entra a Leads, abre Opciones ▾ y pulsa Facebook e Instagram Lead Ads. Solo lo ve un administrador. La primera vez pulsa Empezar a conectar: Adelys crea la URL de tu webhook y un token de verificación.

Panel lateral «Facebook e Instagram Lead Ads» abierto sobre la pantalla de Leads, con la explicación de que la app de Meta es de tu empresa y el botón Empezar a conectar
El panel vive en Leads porque ahí caen los leads. En Conexiones Seguras la tarjeta «Facebook e Instagram Lead Ads» te manda aquí.
2

Crea tu app en Meta y pega el App Secret

En Meta for Developers → Mis apps → Crear app, elige el tipo Empresa y añade el producto Webhooks. Luego, en Configuración de la app → Básica, copia la clave secreta de la app.

Pégala en el paso 2 del panel y pulsa Guardar. Se guarda cifrada y no se vuelve a mostrar: con ella Adelys comprueba que cada aviso lo manda Meta. Si en Omnicanal ya tienes WhatsApp con esa app, pulsa Usar el App Secret de WhatsApp y no tienes que copiarlo.

3

Configura el webhook en Meta

En tu app → Webhooks, elige el objeto Page y pulsa Suscribirse a este objeto. Copia del panel la URL de devolución de llamada y el token de verificación, pégalos y pulsa Verificar y guardar. Después suscríbete al campo leadgen.

Pasos 2 y 3 del asistente: App Secret guardado, y los campos de solo lectura URL de devolución de llamada y Token de verificación, cada uno con su botón Copiar, y el botón Generar una URL nueva
La URL identifica a tu empresa. Si alguna vez se filtra, pulsa Generar una URL nueva y pégala otra vez en Meta: la vieja deja de funcionar en el acto.
4

Conecta tu página con su token

Abre el Explorador de la API Graph, elige tu app y pide estos permisos: leads_retrieval (leer las respuestas), pages_manage_metadata (suscribir la página) y pages_show_list (ver tus páginas). Genera el token y, en Token de acceso a la página, elige tu página.

Pásalo por el Depurador de tokens y pulsa Ampliar token de acceso; el token de página que sale de un token largo no caduca mientras no cambies la contraseña ni quites permisos.

En el panel escribe el id de la página (solo números), un nombre para reconocerla, pega el token y elige el responsable por defecto. Pulsa Conectar página.

Al conectar la página, Adelys la suscribe a tu app por ti (un POST a <id de la página>/subscribed_apps con subscribed_fields=leadgen) y te dice si Meta lo aceptó. Antes comprueba que el token sirve y que es de esa página; si no le pusiste nombre, usa el que tiene en Meta. Cada página conectada dice si recibe avisos; si no, el motivo aparece debajo. Si faltaba el permiso pages_manage_metadata, genera el token otra vez con él y pégalo; si fue un fallo pasajero de Meta, pulsa Volver a suscribir en la página, sin volver a pegarlo.

Paso 4 del asistente con la lista de permisos del token, los enlaces al Explorador de la API Graph y al Depurador de tokens, una página conectada y el formulario Id de la página, Nombre, Token de acceso de la página y Responsable por defecto
Puedes conectar varias páginas. Cada una guarda su token cifrado y su responsable.
5

Prueba con un lead de prueba

Abre la herramienta de prueba de anuncios para clientes potenciales de Meta, elige tu página y tu formulario y pulsa Crear lead. En unos segundos aparece en Últimos leads recibidos con su estado, y en tu lista de Leads con la fuente meta_lead_ads.

El formulario aparece también en Formularios: ahí eliges su responsable y la etapa del embudo en la que entra (por ejemplo, «Contactado»). Pulsa Guardar formularios.

Secciones Formularios y Últimos leads recibidos del panel: un formulario con su responsable y su etapa, y la lista de leads con los estados Lead creado, Ya existía: anotado y No se pudo traer con su botón Reintentar
Cada lead dice qué pasó: Lead creado, Ya existía: anotado, Sin cupo de registros o No se pudo traer, con el motivo y el botón Reintentar.
Qué entra en el lead: nombre, correo, teléfono y empresa van a sus campos; el nombre del formulario va a «Interés»; el cargo, la ciudad y cada pregunta personalizada van a las notas, legibles («¿Cuál es tu presupuesto?: B/. 1 500»), junto con la campaña y el anuncio si tu token puede leerlos. El responsable recibe el aviso «Nuevo lead de Facebook» o «de Instagram», y tus automatizaciones de «Lead creado» corren con el origen meta_lead_ads.
Ojo: si el correo o el teléfono ya están en un lead o un cliente, no se crea otro: se anota en su bitácora que volvió a escribir. Y si tu plan se queda sin cupo de registros, el lead no se pierde en Meta: queda «Sin cupo», te avisamos, y lo reintentas cuando liberes espacio.

Casos prácticos

Una ferretería deja de bajar Excel de Facebook

Ferretería El Tornillo pagaba anuncios con formulario «Cotiza tu pedido» y cada lunes descargaba un Excel de Meta. Conectó su página, asignó el formulario a Carla con la etapa «Contactado» y activó su automatización de bienvenida. Ahora Carla recibe el aviso al minuto, el cliente recibe el correo de bienvenida y el lunes ya no hay nada que importar.

Un cliente que vuelve a escribir

Un cliente de la agencia rellenó dos veces el mismo formulario en una semana. La segunda vez no apareció un lead nuevo: su ficha recibió la nota «Volvió a llenar un formulario de Instagram» con las respuestas nuevas, y su responsable un aviso. El embudo siguió limpio.

Preguntas frecuentes

¿Por qué tengo que crear una app de Meta?

Porque los leads son tuyos y Meta solo los entrega a una app con permiso sobre tu página. Con tu propia app nadie más —tampoco Adelys como empresa— tiene acceso a tus páginas, y puedes revocarlo cuando quieras desde Meta.

Me sale «No se pudo traer». ¿Qué hago?

Lee el motivo debajo del lead. Casi siempre es el token de la página (venció o se generó sin leads_retrieval): genera uno nuevo, pégalo en la página conectada y pulsa Reintentar. Si Meta estaba caído, Adelys reintenta solo varias veces durante unas horas antes de marcarlo.

¿Llegan también los leads que ya tenía en Facebook?

No. Meta avisa de los leads nuevos desde que la página está suscrita. Los anteriores los descargas desde Meta y los subes con Opciones → Importar leads.

¿Qué pasa si desconecto?

Se borran el App Secret y los tokens de tus páginas y la URL deja de funcionar. Los leads que ya entraron se quedan en el CRM.

Sigue con