Mediante la integración de Dialogflow Meta Messenger, puedes crear un bot de Meta Messenger para interactuar con los usuarios finales.
Cómo funciona
La integración funciona de la siguiente manera:
- Creas una app de Meta que use la plataforma de Meta Messenger.
- Configura la integración de Dialogflow y la app de Meta para que se comuniquen entre sí.
- La integración de Dialogflow envía mensajes al usuario final mediante la API de Meta Messenger.
- La integración de Dialogflow actúa como Meta Webhooks para Messenger Platform 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 metadatos: Desarrollo de apps de metadatos.
Configura la app de Meta para usar la plataforma de Meta Messenger. Sigue los pasos detallados en la documentación de Meta Webhooks para la plataforma de Messenger a fin de lograr lo siguiente:
- Agrega la plataforma Messenger a la app de Meta.
- Suscribe tu app a una página meta. Asegúrate de que
messages
ymessaging_postbacks
estén habilitados en la suscripción a la página. - 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:
- Ir a la consola de Dialogflow CX
- Haz clic en la pestaña Administrar en el panel izquierdo.
- Haz clic en Integrations, en el menú de la barra lateral izquierda.
- Haz clic en el botón Conectar en el mosaico Meta Messenger.
Se abrirá un cuadro de diálogo de configuración:
Secreto de app: Ingresa el secreto de la app desde la Configuración básica del panel de apps.
Verify Token: Puede ingresar el token privado que desees. Copia este valor. Se usará para configurar el webhook de Meta Messenger.
Token de acceso a la página: Ingresa el token de acceso que copiaste durante la configuración anterior de la app de Meta.
Habilita el botón Comenzar: Consulta la sección botón Comenzar.
URL de webhook: Copia este valor. Se usará para configurar el webhook de Meta Messenger.
Start: Haz clic a fin de iniciar este servicio de integración para tu agente.
Finaliza la configuración de la app de Meta y pruébala. Sigue los pasos que se indican en la documentación de Metawebhooks para la plataforma de Messenger a fin de lograr lo siguiente:
- Configura el webhook de metadatos para tu app. Usa los valores de URL de webhook y Verificar token que copiaste anteriormente. Asegúrate de habilitar
messages
ymessaging_postbacks
en la suscripción de la página. - Probar tu app.
- Configura el webhook de metadatos para tu app. Usa los valores de URL de webhook y Verificar token que copiaste anteriormente. Asegúrate de habilitar
Eventos
Esta integración invoca los siguientes eventos: Puedes crear controladores de eventos personalizados para definir qué hacer cuando se activen los eventos.
Evento | Descripción |
---|---|
FACEBOOK_WELCOME |
Se activa cuando un usuario final hace clic en el botón Comenzar de Meta Messenger. |
FACEBOOK_MEDIA |
Se activa cuando el mensaje de un usuario final contiene adjuntos (p. ej., audio, imagen, video, etcétera). |
Botón Comenzar
Para configurar el botón Comenzar de Meta Messenger, haz lo siguiente:
Activa el botón Habilitar el botón Comenzar cuando habilites este servicio de integración.
Este servicio de integración habilitará el botón por ti llamando a la API de Messenger Profile.
curl -X POST \ -H "Content-Type: application/json" \ -d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \ "https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"
Crea un controlador de eventos personalizado para el evento
FACEBOOK_WELCOME
.
Para probarla, haz lo siguiente:
Borra la conversación anterior con la página meta (si corresponde).
- El botón Comenzar solo aparece en las conversaciones nuevas.
Inicia una nueva conversación con la página meta.
Haz clic en el botón Comenzar y verifica la respuesta del controlador de eventos personalizados.
Puedes llamar a la API de perfil de Messenger para administrar el botón Comenzar en cualquier momento. Esto puede ser útil para realizar pruebas.
Por ejemplo, la siguiente solicitud verifica el estado del botón Comenzar:
curl -X GET \ "https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"
La siguiente solicitud inhabilita el botón Comenzar:
curl -X DELETE \ -H "Content-Type: application/json" \ -d '{"fields": ["get_started"]}' \ "https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"
Mensajes de respuesta enriquecida
Los mensajes de respuesta enriquecida son compatibles con la carga útil personalizada en Entregas. Consulta Send API Parameters Message Object para conocer el formato del mensaje.
Por ejemplo, la siguiente carga útil personalizada proporciona un mensaje de texto simple:
{ "text": "Hello, world" }
La siguiente carga útil personalizada proporciona un mensaje de imagen:
{ "attachment": { "type": "image", "payload": { "url": "https://example.com/test.jpg" } } }
Respuestas específicas del canal
Cuando se configura, las respuestas específicas del canal con el canal DF_CX_FB_MESSENGER
se usarán automáticamente cuando el agente responda a los mensajes de Meta Messenger.