Messenger de Meta

Con la integración de Dialogflow Meta Messenger, puedes crear un Meta. Bot de mensajería para interactuar con los usuarios finales.

Cómo funciona

La integración funciona de la siguiente manera:

• Creas una app de Meta que usa la Plataforma de Meta Messenger.
• Configura la integración de Dialogflow y la app de Meta para que comunicarse entre sí.
• La integración de Dialogflow envía mensajes al usuario final mediante la API de Meta Messenger.
• La integración de Dialogflow recibe mensajes del usuario final actuando como el Meta Webhooks para la plataforma de Messenger.

Configuración

Para configurar la integración, debes realizar las siguientes acciones:

1. Sigue los pasos para crear una app de Meta: Meta App Development.

2. Configura la app de Meta para que use la plataforma de Meta Messenger. Sigue el pasos en la Meta Webhooks para la plataforma Messenger documentación para lograr lo siguiente:

   • Agrega la plataforma Messenger a tu app de Meta.
   • Suscribir tu app a una página meta. Asegúrate de que messages y messaging_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.

3. Configura la integración desde la consola de Dialogflow:

   1. Ir a la consola de Dialogflow CX
   2. Haz clic en la pestaña Administrar en el panel izquierdo.
   3. Haz clic en Integrations, en el menú de la barra lateral izquierda.
   4. Haz clic en el botón Conectar en el mosaico de Meta Messenger.

   5. Se abrirá un cuadro de diálogo de configuración:

      • Secreto de app: Ingresa el secreto de la app en Configuración básica del panel de la app.

      • Verify Token: Puede ingresar el token privado que desees. Copia este valor. Se usará para configurar Meta Messenger Webhook

      • Token de acceso a la página: Ingresa el token de acceso que copiaste durante la Configuración de la app de Meta que se muestra arriba.

      • Habilita el botón Comenzar: Consulta la sección botón Comenzar.

      • URL de webhook: Copia este valor. que se usará para configurar el Webhook de Meta Messenger.

      • Start: Haz clic a fin de iniciar este servicio de integración para tu agente.

4. Finaliza la configuración de la app de Meta y pruébala. Sigue los pasos que se indican en el Meta Webhooks para la plataforma Messenger documentación para lograr lo siguiente:

   • Configura el webhook de Meta para tu app. Usa la URL de webhook y Los valores de token de verificación que copiaste anteriormente. Asegúrate de habilitar messages y messaging_postbacks en la suscripción de la página.
   • Probar tu app.

Eventos

Esta integración invoca los siguientes eventos: Puedes crear controladores de eventos personalizados para definir qué hacer cuando se activen los eventos.

Botón Comenzar

Para configurar Botón para comenzar de Meta Messenger:

1. 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 mediante una llamada 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}"
     

2. Crea un controlador de eventos personalizado para el evento FACEBOOK_WELCOME.

Para probarla, haz lo siguiente:

1. Borra la conversación anterior con tu página de Meta (si corresponde).

   • El botón Comenzar solo aparece en las conversaciones nuevas.

2. Inicia una conversación nueva con tu página de Meta.

3. Haz clic en el botón Comenzar y verifica la respuesta del controlador de eventos personalizados.

Puedes llamar cuando quieras API de perfil de Messenger para administrar el botón Comenzar. 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 Enviar objeto de mensaje de parámetros de API para 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 configuren, las respuestas específicas del canal con el canal DF_CX_FB_MESSENGER se usarán automáticamente cuando el agente responda los mensajes de Meta Messenger.