Messenger from Facebook

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

Limitaciones

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

Cómo funciona

Así funciona la integración:

Configuración

Para configurar la integración, haz lo siguiente:

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

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

    • Añade la plataforma Messenger a tu aplicación de Facebook.
    • Suscribe tu aplicación a una página de Facebook. 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 Dialogflow.
    • No configures el webhook ni pruebes la integración todavía.

  3. Configura la integración desde la consola de Dialogflow:

    1. Ve a la consola de Dialogflow ES.
    2. En el menú de la barra lateral de la izquierda, haz clic en Integraciones.
    3. Haz clic en Facebook Messenger.

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

      • Mostrar URL de retrollamada antigua: si se muestra este interruptor, estará desactivado de forma predeterminada. Se trata de una opción temporal para adaptarse a una modificación reciente de la API de Facebook Messenger. No cambies este interruptor a menos que te lo indique el equipo de Asistencia de Dialogflow. Cuando se hayan actualizado todos los agentes, se eliminará esta opción.
      • URL de retrollamada: copia este valor. Se usa para configurar el webhook de Facebook Messenger.
      • Verificar token: puedes introducir cualquier token privado que necesites. Copia este valor. Se usa para configurar el webhook de Facebook Messenger.
      • Token de acceso a la página: introduce el token de acceso que has copiado al crear la página de Facebook.
      • Iniciar: haz clic para iniciar este servicio de integración en tu agente.

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

    • Configura el webhook de Facebook para tu aplicación. Usa los valores de URL de retrollamada y Token de verificación que has copiado arriba. Asegúrate de habilitar messages y messaging_postbacks.
    • Prueba tu aplicación.

Eventos

Esta integración invoca los siguientes eventos:

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

Mensajes de respuesta enriquecidos

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

Respuestas con imágenes

Las respuestas con imágenes se envían a Facebook Messenger como mensajes con archivos adjuntos de Facebook Messenger. El valor de message.attachment.type se ha definido como image. Se admiten los siguientes formatos:

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

Respuestas de tarjeta

Las respuestas de 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 de carga útil personalizadas

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

El formato general de la carga útil personalizada es el siguiente:

{
  "facebook": {
    message
  }
}

En lugar de message, proporciona el objeto message de Facebook Messenger. Para obtener información sobre el objeto message, consulta la referencia de la API Messenger de Facebook.

Por ejemplo:

  • Enviar un enlace de audio: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • Enviar un vídeo reproducible: 
    {
  "facebook": {
    "attachment": {
      "type": "video",
      "payload": {
        "url": "https://example.com/video.mp4"
      }
    }
  }
}
  • Enviar un archivo: 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}