Skip to main content
Importante: Debes tener una página de Facebook para utilizar la integración de Messenger. La Página será la identidad a través de la cual su IA responde a los usuarios.

​
🔢 Tabla de contenidos

  1. Create a Meta Business Account
  2. Create a Meta App and Enable Messenger
  3. Generate a Page Access Token
  4. Configure Webhooks in the Meta App
  5. Connect Your Meta App to ZappWay
  6. Final Checks and Monitoring

​
1. Cree una cuenta metaempresarial

  1. Navigate to https://business.facebook.com.
  2. Click “Create Account.”
  3. Fill out the required information:
    • Business Name
    • Your Full Name
    • Work Email
  4. Continue through the prompts to finalize setup. When prompted:
    • Add a Facebook Page (you can use an existing page or create a new one).
    • Add a Payment Method if requested.
    • Complete Business Verification by submitting the necessary documents (e.g., company registration, proof of address).
Consejo: Meta puede limitar ciertas funciones en cuentas nuevas hasta que completes el proceso de verificación. Siga todas las instrucciones que aparecen en pantalla y proporcione los documentos adicionales solicitados.

​
2. Cree una metaaplicación y habilite Messenger

  1. Go to https://developers.facebook.com/apps.
  2. Click “Create App.”
  3. When prompted “What do you want your app to do?”, select “Other.”
  4. Choose “Business” as your app type.
  5. Complete the form by providing:
    • App Name (for example, “ZappWay Messenger Bot”)
    • Contact Email
    • Link to the Meta Business Account you created in Step 1.
  6. Click “Create App.”
  7. Inside your newly created App’s dashboard, locate the “Products” section.
  8. Select ”+ Add Product.”
  9. Find “Messenger” in the list, and click “Set Up.”
Nota:
  • Si Meta solicita verificación comercial adicional en esta etapa, complete ese proceso antes de continuar.
  • Asegúrese de estar trabajando con la cuenta de Business Manager correcta.

​
3. Generar un token de acceso a la página

El token de acceso a la página autentica su integración y permite a ZappWay enviar y recibir mensajes en nombre de su página de Facebook.

​
3.1 Generar token en el panel de metaaplicación

  1. In your Meta App, navigate to Messenger → Settings.
  2. Under “Access Tokens” section, you’ll see your connected Facebook Pages.
  3. Select the Page you want to use for this integration.
  4. Click “Generate Token”.
  5. A modal will appear asking for permissions - accept all required permissions.
  6. Copy the generated Page Access Token immediately and store it securely.
CRÍTICO: Vencimiento del token
  • De forma predeterminada, los tokens de acceso a la página caducan después de 60 días.
  • Para crear un token que nunca caduca, debes:
  1. Cree un usuario del sistema en Business Manager
  2. Asigne el usuario del sistema a su aplicación con el permiso “Administrar aplicación”
  3. Genere un token del usuario del sistema (seleccione “Nunca” para que caduque)
  • Recomendamos utilizar tokens que nunca caduquen para uso en producción.

​
3.2 Verificar permisos de tokens

Su token debe tener estos permisos:
  • pages_messaging - Enviar y recibir mensajes
  • pages_manage_metadata - Administrar metadatos de página
  • pages_read_engagement - Leer datos de participación en la página
  • pages_show_list - Lista de acceso a páginas
Puede verificar los permisos en: https://developers.facebook.com/tools/debug/accesstoken/

​
4. Configurar webhooks en la metaaplicación

Los webhooks permiten a Meta enviar mensajes entrantes a ZappWay en tiempo real.

​
4.1 Configurar la URL del webhook

  1. In your Meta App’s Messenger settings, locate the “Webhooks” section.
  2. Click “Add Callback URL” (or “Edit Callback URL” if one exists).
  3. You’ll need two pieces of information from ZappWay (obtained in Step 5):
    • Callback URL: https://app.zappway.ai/api/integrations/messenger/webhook?service_provider_id=<SERVICE_PROVIDER_ID>
    • Verify Token: A unique string generated by ZappWay
Nota: Obtendrá estos valores después de crear la integración en ZappWay (Paso 5), por lo que es posible que deba volver a este paso.

​
4.2 Suscribirse a campos de webhook

Después de verificar la URL de devolución de llamada, suscríbase a estos campos de webhook:
  • ✅ mensajes - Recibir mensajes entrantes
  • ✅ messaging_postbacks - Reciba clics en botones y devoluciones de datos
  • ✅ messaging_optins - Recibir eventos de suscripción
  • ✅ message_deliveries - Seguimiento del estado de entrega del mensaje
  • ✅ message_reads - Realiza un seguimiento de cuándo se leen los mensajes
Haga clic en “Suscribirse” para activar las suscripciones a webhooks.

​
5. Conecte su metaaplicación a ZappWay

Siga estos pasos dentro del panel de ZappWay para completar la integración.

​
Paso 1: Requisitos

  1. Log in to your ZappWay dashboard.
  2. Navigate to Integrations → Messenger.
  3. Click “Add Messenger Integration.”
  4. Review the requirements and click “Continue.”

​
Paso 2: Token de acceso a la página

  1. Paste the Page Access Token you generated in Step 3.
  2. Click “Continue.”
    • ZappWay will validate the token by making a request to Meta’s Graph API.
    • The system will automatically detect your Page ID and Page Name.
    • If validation fails, verify that your token is valid and has the required permissions.

​
Paso 3: Selección de página

  1. ZappWay will display the detected Page Name and Page ID.
  2. If this is correct, click “Continue.”
  3. If you need to use a different page:
    • Generate a new token for that page in the Meta App dashboard
    • Return to Step 2 with the new token

​
Paso 4: Configuración del webhook

ZappWay mostrará dos valores que debes configurar en Meta:
  1. Callback URL (example: https://app.zappway.ai/api/integrations/messenger/webhook?service_provider_id=abc123)
  2. Verify Token (a unique string generated by ZappWay)
Acción requerida:
  1. Copie estos valores.
  2. Regrese a la configuración de Messenger de su Meta App (Paso 4).
  3. Pegue la URL de devolución de llamada y el token de verificación.
  4. Haga clic en “Verificar y guardar” en el panel Meta.
  5. Asegúrese de que todos los campos del webhook estén suscritos (mensajes, mensajes_postbacks, etc.).
  6. Regrese a ZappWay y haga clic en “Finalizar”.

​
6. Controles finales y seguimiento

​
6.1 Verificar el estado de la conexión

  • En la página Integraciones de ZappWay, la integración de Messenger debe mostrar el estado “Conectado”.
  • El nombre de la página debe mostrarse correctamente.

​
6.2 Flujo de mensajes de prueba

  1. Open Messenger and send a test message to your Facebook Page.
  2. Verify that the message appears in ZappWay’s Inbox.
  3. Check that your AI Employee responds according to configured rules.
Si los mensajes no llegan:
  • Verifique que la URL de devolución de llamada del webhook esté configurada correctamente en Meta
  • Verifique que los campos del webhook estén suscritos (especialmente “mensajes”)
  • Revisar los registros de webhook en el panel de Meta App para detectar errores de entrega
  • Asegúrese de que su token de acceso a la página no haya caducado

​
6.3 Monitorear problemas comunes

Caducidad del token (401 no autorizado):
  • Los tokens de acceso a la página pueden caducar después de 60 días
  • Utilice un token de usuario del sistema para obtener acceso que nunca caduca
  • Actualizar el token en ZappWay antes de que caduque
Errores de verificación del webhook:
  • Verifique que la URL de devolución de llamada y el token de verificación coincidan exactamente
  • Verifique que los servidores de ZappWay sean accesibles desde las IP de Meta
  • Revise los registros del webhook del panel de Meta App para obtener detalles del error
Mensajes no enviados:
  • Verificar los permisos del token de acceso a la página
  • Verifique los límites de tasa en el panel de Meta App
  • Revisar los registros de ZappWay para detectar errores de API
Detección de spam:
  • Meta puede marcar tu página si demasiados usuarios la bloquean o denuncian
  • Asegúrese de que sus respuestas de IA sean útiles y apropiadas
  • Evite enviar mensajes no solicitados

​
6.4 Límites de tarifas

  • Messenger tiene límites de tarifas según el nivel de verificación de tu aplicación
  • Límite de tarifa estándar: 200 llamadas API por hora por usuario
  • Límites más altos disponibles después de la verificación de la aplicación
  • Monitorear el uso en el panel de Meta App

​
✅ Mejores prácticas

​
Seguridad

  • Nunca compartas tu token de acceso a la página públicamente
  • Almacenar tokens en variables de entorno o administrador de secretos
  • Rotar tokens periódicamente (cada 60 días mínimo)
  • Utilice tokens de usuario del sistema para entornos de producción.

​
Cumplimiento

  • Siga las Políticas de plataforma y la Política de plataforma de Messenger de Meta
  • Obtener el consentimiento del usuario antes de enviar mensajes.
  • Proporcionar mecanismos claros de exclusión voluntaria
  • Respetar las preferencias y la privacidad del usuario.

​
Experiencia de usuario

  • Mantenga los tiempos de respuesta por debajo de 3 segundos
  • Proporcionar respuestas útiles y contextuales.
  • Utilice respuestas rápidas para acciones comunes
  • Implementar indicadores de mecanografía para respuestas más largas.

​
Monitoreo

  • Configurar alertas para fallas de webhooks
  • Monitorear las tasas de entrega de mensajes
  • Seguimiento de las métricas de participación del usuario
  • Revisar los registros de errores periódicamente

​
🔗 Enlaces útiles

¿Necesitar ayuda? Si tiene problemas durante la configuración, comuníquese con el soporte de ZappWay o visite nuestra documentación en docs.zappway.ai