Messenger de Meta

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

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 admite Workplace de Meta.

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 CX y la app de Meta para que se comuniquen entre sí.
• La integración de Dialogflow CX envía mensajes a tus usuarios con la API de Meta Messenger.
• La integración de Dialogflow CX recibe mensajes de tus usuarios actuando como los webhooks de Meta para Messenger Platform.

Configuración

Asegúrate de que la facturación esté habilitada en tu 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 Meta: Desarrollo de apps de Meta.
2. Configura la app de Meta para usar la plataforma de Meta Messenger. Sigue los pasos de la documentación de Webhooks de Meta para Messenger Platform para lograr lo siguiente:
   • Agrega la plataforma de Messenger a tu app de Meta.
   • Suscribe tu app a una página de Meta. Asegúrate de que messages y messaging_postbacks estén habilitados en la suscripción a la página.
   • Copia el token de acceso que se proporciona en este paso. Este token se usa para configurar la integración desde la consola de Dialogflow CX.
   • No configures el webhook ni pruebes la integración todavía.
3. Configura la integración desde la consola de Dialogflow CX:
   1. Ve a la consola de Dialogflow CX.
   2. Selecciona la pestaña Administrar en el menú de navegación.
   3. Selecciona Integraciones.
   4. Haz clic en el botón Conectar en la tarjeta de Meta Messenger.
   5. Completa los campos del diálogo de configuración:
      • Secreto de la app: Ingresa el secreto de la app desde la configuración básica del panel de la app.
      • Verificar token: Ingresa cualquier token privado que necesites. Copia este valor. Esto se usa 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 de la app de Meta.
      • Habilitar el botón Comenzar: Selecciona esta casilla de verificación para habilitar el botón Comenzar.
      • URL de webhook: Copia este valor. Se usa para configurar el webhook de Meta Messenger.
      • Iniciar: Selecciona esta casilla de verificación para iniciar el servicio de integración de 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 Webhooks de Meta para Messenger Platform para lograr lo siguiente:
   • Configura el webhook de Meta para tu app. Usa los valores de URL de webhook y Verificar token que copiaste antes. 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 para comenzar de Meta Messenger.
FACEBOOK_MEDIA	Se activa cuando el mensaje de un usuario final contiene archivos adjuntos (por ejemplo, audio, imagen o video).

Botón para comenzar

Configura el botón para comenzar de Meta Messenger:

1. Activa Habilitar el botón Comenzar cuando habilites este servicio de integración.

   • Este servicio de integración te permite habilitar el botón 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. Si corresponde, borra la conversación anterior con tu página de Meta.
   • El botón Comenzar solo aparece en las conversaciones nuevas.
2. Inicia una nueva conversación 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 a la API de Messenger Profile para administrar el botón Get Started. Esto puede ayudar con las pruebas.

Para verificar el estado del botón Comenzar, usa la siguiente solicitud:

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

Puedes usar la siguiente solicitud para inhabilitar 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 se admiten con la carga útil personalizada en el cumplimiento. Para obtener más información, consulta la documentación del objeto de mensaje de parámetros de la API de envío para conocer el formato del mensaje.

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

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

Después de configurar las respuestas específicas del canal, el agente usa automáticamente el canal DF_CX_FB_MESSENGER para responder a los mensajes de Meta Messenger.