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.

Limitaciones

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

Cómo funciona

La integración funciona de la siguiente manera:

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

  • Envía 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"
          }
        }
      }
    }