Lugar de trabajo de Facebook

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

Cómo funciona

La integración funciona de la siguiente manera:

  • Debes crear una aplicación de Workplace que use la plataforma Workplace.
  • Configura la integración de Dialogflow y la aplicación de Workplace para que se comuniquen entre sí.
  • La integración de Dialogflow envía mensajes al usuario final mediante la API de Messenger de Facebook.
  • La integración de Dialogflow recibe mensajes del usuario final cuando actúa como Workhook de trabajo de Facebook.

Inicio

Para iniciar la integración, haz lo siguiente:

  1. Crea una aplicación de Workplace 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.
    2. Haz clic en Integrations, en el menú de la barra lateral izquierda.
    3. Haz clic en Facebook Workplace.
    4. Haz clic en INICIAR 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.
  3. Probar tu app:

    1. Ve a Workplace y accede a la cuenta.
    2. Busca Dialogflow 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.

  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.

  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:

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

Limitaciones

  1. Un agente de Dialogflow solo se puede instalar en un grupo de Workplace y solo puede tener una instancia, pero puedes instalar varios agentes de Dialogflow en un grupo 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 vas a migrarla a la integración de Workplace, deberás hacer lo siguiente:

  1. Detén la integración con Chat en grupo.

  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.