Messenger de Meta

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Mediante la integración de Dialogflow Meta Messenger, puedes crear un bot de Meta Messenger para interactuar con los usuarios finales.

Nota: Cuando se usa una integración de terceros, las solicitudes y los datos del usuario final se envían a Google y al tercero. Las Condiciones del Servicio, el ANS, los precios y las cuotas de tu edición de agente se aplican a la administración de estas solicitudes por parte de Google. Las Condiciones del Servicio, el ANS, los precios y las cuotas del tercero se aplican a la administración de estas solicitudes por parte del tercero.

Cómo funciona

Nota: Esta integración no es compatible con Workplace from Meta.

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

Nota: Asegúrate de habilitar la facturación en el proyecto antes de probar la integración.

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

1. Sigue los pasos para crear una app de metadatos: Desarrollo de apps de metadatos.

2. 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 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 Meta Messenger.

   5. 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.

4. 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 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.

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:

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 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}"
     

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

Para probarla, haz lo siguiente:

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

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

2. Inicia una nueva conversación con la página meta.

3. 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.