Mediante la integración de Facebook Messenger en Dialogflow, puedes crear un bot de Facebook Messenger para interactuar con los usuarios finales.
Limitaciones
Solo los idioma predeterminado del agente es compatible con esta integración.
Cómo funciona
La integración funciona de la siguiente manera:
- Crea una app de Facebook que use la plataforma de Facebook Messenger.
- Configura la integración de Dialogflow y la app de Facebook para que se comuniquen entre sí.
- La integración de Dialogflow envía mensajes al usuario final mediante la API de Facebook Messenger.
- La integración de Dialogflow actúa como un Webhook de Facebook Messenger para recibir mensajes del usuario final.
Configuración
Para configurar la integración, debes realizar las siguientes acciones:
Sigue los pasos para crear una app de Facebook: Desarrollo de aplicaciones de Facebook.
Configura la app de Facebook para usar la plataforma de Facebook Messenger. Sigue los pasos que se indican en el Configurar tu aplicación de Facebook documentación para lograr lo siguiente:
- Agregar la plataforma de Messenger a tu app de Facebook.
- Suscribir tu app a una página de Facebook. En este paso, se te proporciona un token de acceso. Copia este valor. Este token se usará para configurar la integración desde la consola de Dialogflow.
- Aún no debes configurar el webhook ni probar tu integración.
Configura la integración desde la consola de Dialogflow:
- Ve a la consola de Dialogflow ES.
- Haz clic en Integrations, en el menú de la barra lateral izquierda.
- Haz clic en Facebook Messenger.
Se abrirá un cuadro de diálogo de configuración:
- Show old callback URL: Si se muestra esta opción, se desactivará de forma predeterminada. Esta es una opción temporal para incorporar una modificación reciente a la API de Facebook Messenger. No cambies esta opción, a menos que el equipo de asistencia de Dialogflow te lo indique. Después de actualizar todos los agentes, se quitará esta opción.
- Callback URL: Copia este valor. Se usará para configurar el webhook de Facebook Messenger.
- Verify Token: Puede ingresar el token privado que desees. Copia este valor. Se usará para configurar el webhook de Facebook Messenger.
- Page Access Token: Ingresa el token de acceso que copiaste cuando creaste la página de Facebook.
- Start: Haz clic a fin de iniciar este servicio de integración para tu agente.
Finaliza la configuración de la app de Facebook y pruébala. Sigue los pasos que se indican en el Configurar tu aplicación de Facebook documentación para lograr lo siguiente:
- Configurar el webhook de Facebook para tu app. Usa los valores de Callback URL y Verify Token que copiaste antes. Asegúrate de habilitar messages y messaging_postbacks.
- Probar tu app.
Eventos
Esta integración invoca los siguientes eventos:
Evento | Descripción |
---|---|
FACEBOOK_WELCOME |
Se activa cuando un usuario final inicia una conversación con el bot. |
Mensajes de respuesta enriquecida
Esta integración traduce algunos mensajes de respuesta enriquecida a los tipos de mensajes de la plataforma de Facebook Messenger.
Respuestas de imagen
Las respuestas de imagen se envían a Facebook Messenger como mensajes de archivos adjuntos de Facebook Messenger.
El valor message.attachment.type
se establece como image
.
Se admiten los siguientes formatos:
- jpg
- png
- GIF estático
- GIF animado
Respuestas con tarjeta
Las respuestas con tarjeta se envían a Facebook Messenger como plantillas genéricas de Facebook Messenger.
Respuestas rápidas
Las respuestas rápidas se envían a Facebook Messenger como respuestas rápidas de Facebook Messenger.
Respuestas con carga útil personalizada
Para enviar otros tipos de mensajes de Facebook Messenger, puedes usar una carga útil personalizada.
El formato general de la carga útil personalizada se ve de la siguiente manera:
{ "facebook": { message } }
En lugar de message
, proporciona el objeto message
de Facebook Messenger.
Para obtener detalles del objeto message
, consulta la Referencia de la API de Facebook Messenger.
Por ejemplo:
- Enviar un vínculo de audio:
{ "facebook": { "attachment": { "type": "audio", "payload": { "url": "https://example.com/audio/test.mp3" } } } }
- Envía un video reproducible:
{ "facebook": { "attachment": { "type": "video", "payload": { "url": "https://example.com/video.mp4" } } } }
- Envía un archivo:
{ "facebook": { "attachment": { "type": "file", "payload": { "url": "https://example.com/file.pdf" } } } }