Messenger
Conecta una página de Facebook mediante las credenciales de Meta Messenger Platform y webhooks firmados.
Conecta una página de Facebook mediante las credenciales de Meta Messenger Platform y webhooks firmados.
Prepara la app de Meta y la página#
Sigue la guía oficial de introducción a Messenger Platform de Meta. Añade Messenger a una app de Meta, conecta la página de Facebook que debe recibir los mensajes y asegúrate de que tu cuenta pueda administrar ambos recursos.
Reúne los valores de la misma app y de la misma página:
| Campo de Make Agent Fast | Valor del proveedor | Finalidad |
|---|---|---|
| Token de acceso de la página | Token emitido para la página seleccionada | Lee la identidad de la página y envía las respuestas |
| Secreto de la app | Secreto hexadecimal de 32 caracteres de la app de Meta | Verifica las solicitudes de webhook entrantes firmadas |
No uses un token de acceso de usuario ni un token que pertenezca a otra página. El estado de desarrollo y revisión de la app de Meta determina qué personas pueden usar la integración.
Guarda y valida las credenciales#
Abre la página Canales del agente, selecciona Messenger, introduce el token de acceso de la página y el secreto de la app, y selecciona Conectar.
Make Agent Fast llama a la Graph API con appsecret_proof, obtiene el ID y el nombre de la página, y vincula los eventos entrantes exactamente a esa página. A continuación, la tarjeta del conector muestra su URL del webhook y su Token de verificación.
Configura el webhook de la página#
En la misma app de Meta:
- Abre la configuración del webhook de Messenger.
- Pega la URL del webhook y el Token de verificación del conector.
- Completa el desafío de verificación.
- Selecciona la suscripción al evento de mensajes que requiera tu flujo de trabajo de Messenger.
- Suscribe la página de Facebook correspondiente a la app.
- Confirma que la suscripción de la página y el modo de la app permiten a tu usuario de prueba.
El token de verificación solo se usa en el desafío inicial. Los eventos en tiempo de ejecución deben incluir una firma que coincida con el secreto de la app. Make Agent Fast también rechaza los eventos dirigidos a una página distinta, aunque provengan de la misma app de Meta.
Prueba las capacidades#
Envía un mensaje normal a la página desde una cuenta de prueba permitida que no sea administradora y confirma la respuesta y el hilo en Conversaciones. Después, prueba un archivo de audio adjunto si la voz entrante es importante para tu flujo de trabajo.
Se procesan el texto y el audio entrante compatible. En el conector actual de Messenger, las respuestas son solo de texto, incluso cuando el mensaje original era de voz. Se ignoran los acuses de entrega y lectura, los ecos de los mensajes de la propia página, las imágenes y otros archivos adjuntos no compatibles.
Preparación para producción#
Completa los pasos de permisos, revisión de la app, verificación de empresa, URL de privacidad y publicación de la página que Meta exige para tu audiencia. Que todo funcione en modo de desarrollo con una cuenta con rol en la app no demuestra que el público pueda escribir a la integración de la página.
Documenta para los operadores la app de Meta propietaria y el ID de la página. Un token de página puede dejar de funcionar cuando cambian su propietario, los permisos, la asociación con la empresa o las políticas del proveedor.
Rota o desconecta#
Genera el token de página de reemplazo, actualiza el conector, haz una prueba con un usuario permitido y, después, invalida el token anterior. Actualiza Make Agent Fast inmediatamente después de rotar el secreto de la app.
Desactivar o eliminar el conector no cancela la suscripción de la página en Meta. Elimina la suscripción de la página y la credencial del proveedor que ya no uses cuando desmantelues la integración de forma permanente.
Solución de problemas#
| Síntoma | Solución |
|---|---|
| Token rechazado | Confirma que es un token de página de la página correcta y que el secreto de la app pertenece a la misma app |
| Falla la verificación del webhook | Copia exactamente la URL y el token de verificación actuales; usa HTTPS público |
| La verificación funciona, pero los mensajes no llegan | Suscribe la página y el evento de mensajes, y revisa el modo de la app, el rol del usuario y los registros de entrega de Meta |
| Las solicitudes no están autorizadas | Corrige el secreto de la app; las solicitudes POST firmadas no usan el token de verificación |
| Aparece el mensaje entrante, pero no hay respuesta | Revisa la validez del token de página, los permisos de mensajería, el error de envío del proveedor y el estado del conector |
| La voz recibe una respuesta de texto | Es el comportamiento esperado; actualmente no se admite la voz saliente en Messenger |
Las credenciales del proveedor solo deben introducirse en el formulario autenticado del conector o en una llamada a la API de servidor de confianza.