Workplace de Facebook

Mediante la integración de Facebook Workplace de Dialogflow, puedes crear un Workplace desde el bot de Facebook para interactuar con tus usuarios finales.

Limitaciones

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

Cómo funciona

La integración funciona de la siguiente manera:

  • Debes configurar la instancia de Workplace y la integración de Dialogflow, de modo que se comunican entre sí.
  • La integración de Dialogflow envía mensajes al usuario final mediante la API de mensajería de Facebook.
  • La integración de Dialogflow recibe mensajes del usuario final cuando actúa como webhook de Workplace de Facebook.

Iniciar

Para iniciar la integración, haz lo siguiente:

  1. Registra una instancia de Workplace si no la tienes y asegúrate de ser 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. Haz clic en Integrations, en el menú de la barra lateral izquierda.
    3. Haz clic en Workplace de Facebook.
    4. Haz clic en COMENZAR y se te redireccionará a Workplace para finalizar la instalación:
      • Accede a tu cuenta de Workplace. La cuenta debe ser administrador del sistema en Workplace para instalar integraciones.
      • Haga clic en Agregar a en la ventana emergente que le solicita instalar la integración de Dialogflow. También tienes la opción de personalizar el nombre del bot.
  3. Probar tu app:

    1. Ve a Workplace y accede a la cuenta.
    2. Busca Dialogflow (o el nombre personalizado del bot) en Bots en la sección Página principal de la barra lateral y comienza a chatear con el bot.

Cancelar

Si hiciste clic en el botón INICIAR, pero no deseas finalizar la instalación en Workplace:

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

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

Detener

Para detener una integración instalada de forma adecuada, haz lo siguiente:

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

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

    1. Accede a tu cuenta de Workplace. La cuenta debe ser administrador del sistema en Workplace para desinstalar integraciones.
    2. Busca y selecciona la integración de Dialogflow entre las integraciones instaladas en Workplace. Luego, haz clic en Desinstalar para finalizar la desinstalación.
  5. Se desinstalará la integración de Dialogflow.

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

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 quitar una instalación con errores, debes cancelar la instalación en Dialogflow y quitar la instalación en Workplace.

Migración

Si usas la integración de Messenger y la migrarás a la integración de Workplace, deberás hacer lo siguiente:

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

  2. Para quitar la función de devolución de llamada en la app de Facebook, sigue los pasos que se indican en Configura tu app de Facebook.

  3. Comienza la integración de Workplace con los pasos anteriores.