Messenger de Meta

Con la integración de Meta Messenger, puedes crear un bot de Meta Messenger para interactuar con tus usuarios finales.

Cómo funciona

Así funciona la integración:

• Creas una aplicación de Meta que usa la plataforma Meta Messenger.
• Configura la integración de Conversational Agents (Dialogflow CX) y la aplicación de Meta para que se comuniquen entre sí.
• La integración de agentes conversacionales (Dialogflow CX) envía mensajes al usuario final mediante la API Meta Messenger.
• La integración de agentes conversacionales (Dialogflow CX) recibe mensajes del usuario final actuando como webhooks de Meta para la plataforma Messenger.

Configuración

Para configurar la integración, haz lo siguiente:

1. Sigue los pasos para crear una aplicación de Meta: Desarrollo de aplicaciones de Meta.

2. Configura la aplicación Meta para usar la plataforma Meta Messenger. Sigue los pasos que se indican en la documentación de Webhooks de Meta para la plataforma Messenger para hacer lo siguiente:

   • Añade Messenger Platform a tu aplicación de Meta.
   • Suscribe tu aplicación a una página de Meta. Asegúrate de que messages y messaging_postbacks estén habilitados en la suscripción de la página.
   • En este paso, se te proporciona un token de acceso. Copia este valor. Este token se usa para configurar la integración desde la consola de Conversational Agents (Dialogflow CX).
   • No configures el webhook ni pruebes la integración todavía.

3. Configura la integración desde la consola de agentes conversacionales (Dialogflow CX):

   1. Ve a la consola de Dialogflow CX.
   2. En el panel de la izquierda, haga clic en la pestaña Gestionar.
   3. En el menú de la barra lateral de la izquierda, haz clic en Integraciones.
   4. Haz clic en el botón Conectar de la tarjeta Meta Messenger.

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

      • Secreto de la aplicación: introduce el secreto de la aplicación desde Configuración básica del panel de aplicaciones.

      • Verificar token: puedes introducir el token privado que quieras. Copia este valor. Se usa para configurar el webhook de Meta Messenger.

      • Token de acceso de la página: introduce el token de acceso que has copiado durante la configuración de la aplicación de Meta anterior.

      • Habilitar el botón Empezar: consulta la sección Botón Empezar.

      • URL del webhook: copia este valor. Se usa para configurar el webhook de Meta Messenger.

      • Iniciar: haz clic para iniciar este servicio de integración en tu agente.

4. Completa la configuración de la aplicación Meta y pruébala. Sigue los pasos que se indican en la documentación de webhooks de Meta para la plataforma Messenger para hacer lo siguiente:

   • Configura el webhook de Meta para tu aplicación. Usa los valores de URL de webhook y Token de verificación que has copiado más arriba. Asegúrate de habilitar messages y messaging_postbacks en la suscripción de la página.
   • Prueba tu aplicación.

Eventos

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

Botón de empezar

Para configurar el botón Empezar de Meta Messenger, sigue estos pasos:

1. Activa Habilitar botón de inicio al habilitar este servicio de integración.

   • Este servicio de integración habilita el botón llamando a la API 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 probarlo, sigue estos pasos:

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

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

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

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

Siempre puedes llamar a la API Messenger Profile para gestionar el botón Empezar. Esto puede ser útil para hacer pruebas.

Por ejemplo, la siguiente solicitud comprueba el estado del botón Empezar:

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 Empezar:

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 enriquecidos

Los mensajes de respuesta enriquecidos se admiten a través de Carga útil personalizada en Cumplimiento. Consulta el formato del mensaje en Send API Parameters Message Object (Objeto de mensaje de parámetros de la API Send).

Por ejemplo, la siguiente carga útil personalizada proporciona un mensaje de texto sencillo:

{
  "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 de un canal

Una vez que hayas configurado las respuestas específicas de cada canal, el canal DF_CX_FB_MESSENGER se usará automáticamente cuando el agente responda a los mensajes de Meta Messenger.