Envía leads de Facebook e Instagram a una bandeja de entrada de WhatsApp

Conecta a una bandeja de entrada de WhatsApp en Deskwoot una página de Facebook que tenga anuncios de Lead Ads. Cada formulario que alguien llena en Facebook o Instagram llega como una conversación nueva a tu panel, con todos los datos del formulario adjuntos. Además, sale una plantilla de WhatsApp ya aprobada en cuanto Meta envía el webhook, así que la ventana de 24 horas para responder al cliente se abre de inmediato.

Lo que necesitas antes de conectar

• Una página de Facebook que sea dueña de los anuncios de Lead Ads.
• Una app de Meta con el webhook de Lead Ads suscrito a nivel de la app.
• Un token de acceso de la página con estos permisos: pages_show_list, pages_read_engagement, pages_manage_metadata, leads_retrieval. Usa uno de larga duración (60 días) para no tener que renovarlo cada semana.
• La clave secreta de la app de Meta (Configuración, Básica, Clave secreta de la app en tu app de Meta).
• Una bandeja de entrada de WhatsApp Cloud API ya configurada en Deskwoot.
• Al menos una plantilla de WhatsApp aprobada en Meta Business Manager. Las plantillas pueden tener variables (los marcadores {{1}}, {{2}}, ...), y nuestra configuración te deja asignar cada variable al nombre del lead, al nombre de tu cuenta, a un texto fijo o a cualquier campo del formulario.

Conectar la página

1. En Deskwoot, ve a Configuración, Integraciones, Meta Lead Ads.
2. Pega el ID de la página, el token de acceso de larga duración de la página y la clave secreta de la app.
3. Elige la bandeja de entrada de WhatsApp Cloud API donde deben llegar las conversaciones.
4. Escribe el nombre de tu plantilla de bienvenida aprobada y el código de idioma (por ejemplo, lead_welcome + en_US).
5. Haz clic en Conectar página.

Probamos tu token de acceso de la página con la Graph API para confirmar que la página existe. Luego llamamos a POST /<page_id>/subscribed_apps?subscribed_fields=leadgen del lado de Meta para que la página empiece de verdad a enviar los webhooks de leadgen. Sin esa activación en cada página, la suscripción a nivel de la app no entrega nada. Nosotros lo hacemos por ti.

Configurar el webhook en tu app de Meta

Después de conectar, haz clic en Configurar en la tarjeta de la página conectada. Aparecen dos valores:

• URL de devolución de llamada, como https://deskwoot.com/api/webhooks/meta-leadgen/<your-slug>
• Token de verificación, un texto aleatorio propio de cada página

Pega los dos en el panel de tu app de Meta, en Webhooks, Página, Editar suscripción. Cada página conectada tiene su propio slug y su propio token de verificación, así que si se filtran los datos de una página, nunca sirven para autorizar un webhook de otra.

Descubrir los campos del formulario

Haz clic en Descubrir campos en el panel de configuración. Llamamos a Graph /<page_id>/leadgen_forms?fields=questions y traemos la clave de cada pregunta de todos los formularios activos de esta página. Esas claves pasan a ser las opciones de los menús de asignación de campos y de variables de plantilla que verás más abajo.

Asignación de campos

Indícanos qué pregunta del formulario de Meta corresponde a qué campo de contacto de Deskwoot. Los valores predeterminados ya son razonables:

• email, EMAIL o como se llame en tu formulario, se asigna a Correo electrónico. El correo define quién es el contacto (primero buscamos o creamos el contacto por correo y, si no hay, por teléfono).
• full_name se asigna a Nombre completo
• phone_number se asigna a Teléfono, y se deja solo con dígitos antes de guardarlo como ID de WhatsApp.

Puedes agregar asignaciones propias para Empresa o Cargo si tu formulario tiene esas preguntas.

Variables de plantilla

Las plantillas de WhatsApp usan marcadores {{1}}, {{2}}, ... en el cuerpo. El selector de variables te deja llenar cada uno con:

• Nombre del lead, tomado de la asignación de full_name
• Nombre de la cuenta, el nombre visible de tu cuenta de Deskwoot
• Texto fijo, un texto tal cual
• Campo del formulario, cualquier clave de campo que descubrimos arriba

Agrega tantas filas de variables como espera tu plantilla, en orden. Si tu plantilla no tiene variables, puedes dejarla sin filas.

Qué pasa cuando un lead llena el formulario

1. Meta envía un webhook de leadgen a la URL de tu slug con la firma HMAC x-hub-signature-256.
2. Comprobamos la firma con la clave secreta de tu app y, si no coincide, descartamos el lead sin avisar.
3. Reservamos el lead en una fila MetaLeadAdLead con UNIQUE(accountId, leadgenId). Los webhooks repetidos (Meta reintenta hasta 7 veces en 5 días) se descartan en este paso, así que nunca se crea una conversación duplicada.
4. Traemos el lead completo con Graph GET /<leadgen_id>.
5. Buscamos o creamos el contacto y asignamos los campos del formulario según tu configuración.
6. Abrimos una conversación nueva en tu bandeja de entrada de WhatsApp con todos los datos del formulario en customAttributes.metaLeadAd.
7. Enviamos la plantilla de bienvenida con WhatsApp Cloud API. El mensaje llega al teléfono del lead, abre la ventana de 24 horas para responder y tu agente (o Fynn, si es el responsable) sigue desde ahí.

Desconectar

Haz clic en Desconectar en la tarjeta de la página. Llamamos a Meta DELETE /<page_id>/subscribed_apps para que deje de enviar webhooks y luego borramos la fila local. Aunque Meta devuelva un error (token vencido, página eliminada), igual borramos la fila local, así nunca te quedas con una configuración que no puedes quitar.

Preguntas frecuentes