Messenger de Facebook

Mediante la integración de Facebook Messenger en Dialogflow, puedes crear un bot de Facebook 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.

Limitaciones

Esta integración solo admite el idioma predeterminado del agente.

Cómo funciona

La integración funciona de la siguiente manera:

• Crea una app de Facebook que use la plataforma de Facebook Messenger.
• Configura la integración de Dialogflow y la app de Facebook para que se comuniquen entre sí.
• La integración de Dialogflow envía mensajes al usuario final mediante la API de Facebook Messenger.
• La integración de Dialogflow actúa como un Webhook de Facebook Messenger para recibir mensajes del usuario final.

Configuración

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

1. Sigue los pasos para crear una app de Facebook: Desarrollo de aplicaciones de Facebook.

2. Configura la app de Facebook para usar la plataforma de Facebook Messenger. Sigue los pasos que se indican en la documentación sobre la Configuración de tu aplicación de Facebook para lograr lo siguiente:

   • Agregar la plataforma de Messenger a tu app de Facebook.
   • Suscribir tu app a una página de Facebook. 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. Ve a la consola de Dialogflow ES.
   2. Haz clic en Integrations, en el menú de la barra lateral izquierda.
   3. Haz clic en Facebook Messenger.

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

      • Show old callback URL: Si se muestra esta opción, se desactivará de forma predeterminada. Esta es una opción temporal para incorporar una modificación reciente a la API de Facebook Messenger. No cambies esta opción, a menos que el equipo de asistencia de Dialogflow te lo indique. Después de que se hayan actualizado todos los agentes, se quitará esta opción.
      • Callback URL: Copia este valor. Se usará para configurar el webhook de Facebook Messenger.
      • Verify Token: Puede ingresar el token privado que desees. Copia este valor. Se usará para configurar el webhook de Facebook Messenger.
      • Page Access Token: Ingresa el token de acceso que copiaste cuando creaste la página de Facebook.
      • Start: Haz clic a fin de iniciar este servicio de integración para tu agente.

4. Finaliza la configuración de la app de Facebook y pruébala. Sigue los pasos que se indican en la documentación sobre la Configuración de tu aplicación de Facebook para lograr lo siguiente:

   • Configurar el webhook de Facebook para tu app. Usa los valores de Callback URL y Verify Token que copiaste antes. Asegúrate de habilitar messages y messaging_postbacks.
   • Probar tu app.

Eventos

Esta integración invoca los siguientes eventos:

Evento	Descripción
FACEBOOK_WELCOME	Se activa cuando un usuario final inicia una conversación con el bot.

Mensajes de respuesta enriquecida

Esta integración traduce algunos mensajes de respuesta enriquecida a los tipos de mensajes de la plataforma de Facebook Messenger.

Respuestas de imagen

Las respuestas de imagen se envían a Facebook Messenger como mensajes de archivos adjuntos de Facebook Messenger. El valor message.attachment.type se establece como image. Se admiten los siguientes formatos:

• jpg
• png
• GIF estático
• GIF animado

Respuestas con tarjeta

Las respuestas con tarjeta se envían a Facebook Messenger como plantillas genéricas de Facebook Messenger.

Respuestas rápidas

Las respuestas rápidas se envían a Facebook Messenger como respuestas rápidas de Facebook Messenger.

Respuestas con carga útil personalizada

Para enviar otros tipos de mensajes de Facebook Messenger, puedes usar una carga útil personalizada.

El formato general de la carga útil personalizada se ve de la siguiente manera:

{
  "facebook": {
    message
  }
}

En lugar de message, proporciona el objeto message de Facebook Messenger. Para obtener detalles del objeto message, consulta la Referencia de la API de Facebook Messenger.

Por ejemplo:

• Enviar un vínculo de audio:

  {
    "facebook": {
      "attachment": {
        "type": "audio",
        "payload": {
          "url": "https://example.com/audio/test.mp3"
        }
      }
    }
  }
      

• Envía un video reproducible:

  {
    "facebook": {
      "attachment": {
        "type": "video",
        "payload": {
          "url": "https://example.com/video.mp4"
        }
      }
    }
  }
      

• Envía un archivo:

  {
    "facebook": {
      "attachment": {
        "type": "file",
        "payload": {
          "url": "https://example.com/file.pdf"
        }
      }
    }
  }