Workplace from Facebook

Con la integración de Dialogflow con Workplace de Facebook, puedes crear un bot de Workplace de Facebook 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:

  • Configura la integración de Dialogflow y la instancia de Workplace para que se comuniquen entre sí.
  • La integración de Dialogflow envía mensajes al usuario final mediante la API Messenger de Facebook.
  • La integración de Dialogflow recibe mensajes del usuario final actuando como webhook de Workplace de Facebook.

Iniciar

Para iniciar la integración, sigue estos pasos:

  1. Registra una instancia de Workplace si no tienes ninguna y asegúrate de que eres el administrador del sistema del grupo.

  2. Habilita 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 Workplace de Facebook.
    4. Haz clic en INICIAR y se te redirigirá a Workplace para finalizar la instalación:
      • Inicia sesión en tu cuenta de Workplace. La cuenta debe ser de administrador del sistema en Workplace para instalar integraciones.
      • En la ventana emergente que te pide que instales la integración de Dialogflow, haz clic en Añadir a Workplace. También puedes personalizar el nombre del bot.

  3. Prueba tu aplicación:

    1. Ve a Workplace e inicia sesión en la cuenta.
    2. Busca Dialogflow (o el nombre personalizado de tu bot) en Bots (Bots) de la sección Home (Inicio) de la barra lateral y empieza a chatear con el bot.

Cancelar

Si has hecho clic en el botón INICIAR, pero no quieres terminar la instalación en Workplace:

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

    1. Si aparece el botón CANCELAR, haz clic en él para cancelar la instalación.
    2. Si ves el botón DETENER, sigue las instrucciones que se indican a continuación para desinstalar la integración.

Detener

Para detener una integración que se haya instalado correctamente, sigue estos pasos:

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

  4. Haz clic en DETENER y se te redirigirá a Workplace para finalizar la instalación:

    1. Inicia sesión en tu cuenta de Workplace. La cuenta debe tener el rol de administrador del sistema en Workplace para desinstalar integraciones.
    2. Busca y selecciona la integración de Dialogflow en las integraciones instaladas en Workplace y haz clic en Desinstalar para completar la desinstalación.

  5. Se desinstalará la integración de Dialogflow.

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

Limitaciones

  1. Un agente de Dialogflow solo se puede instalar en una instancia de Workplace, pero puedes instalar varios agentes de Dialogflow en una instancia de Workplace.

  2. Para eliminar una instalación fallida, debes cancelar la instalación en Dialogflow y eliminarla en Workplace.

Migración

Si utilizas la integración de Messenger y vas a migrar a la integración de Workplace, tendrás que hacer lo siguiente:

  1. Detén la integración de Messenger.

  2. Elimina la callback_url de la aplicación de Facebook invirtiendo los pasos de la sección Configurar tu aplicación de Facebook.

  3. Inicia la integración de Workplace siguiendo los pasos anteriores.