Slack

La integración de Slack te permite crear fácilmente bots de Slack con comprensión del lenguaje natural basada en la tecnología de agentes conversacionales (Dialogflow CX).

Limitaciones

Configurar Slack

Para configurar la integración de Slack en tu agente, necesitas lo siguiente:

  • Una cuenta de Slack
  • Un espacio de trabajo de Slack

Crear un bot de Slack

  1. Ve a Aplicaciones de Slack.
  2. Crea una aplicación de Slack a partir de un manifiesto de aplicación. A continuación, se muestra un ejemplo de manifiesto. Asegúrate de que los campos oath_config y event_subscriptions coincidan con el manifiesto de ejemplo.
    display_information:
      name: Conversational Agents (Dialogflow CX)
      description: Conversational Agents (Dialogflow CX) integration
      background_color: "#1148b8"
    features:
      app_home:
        home_tab_enabled: false
        messages_tab_enabled: true
        messages_tab_read_only_enabled: false
      bot_user:
        display_name: CX
        always_online: true
    oauth_config:
      scopes:
        bot:
          - app_mentions:read
          - chat:write
          - im:history
          - im:read
          - im:write
          - incoming-webhook
    settings:
      event_subscriptions:
        request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
        bot_events:
          - app_mention
          - message.im
      org_deploy_enabled: false
      socket_mode_enabled: false
      token_rotation_enabled: false
    
  3. Instala la aplicación en el espacio de trabajo que quieras.
    • Token de OAuth de usuario bot
      • Ve a Instalar aplicación > Tokens de OAuth para tu espacio de trabajo > Token de OAuth de usuario bot.
    • Token de firma
      • Vaya a Información básica > Credenciales de la aplicación > Secreto de firma.

Configurar agentes conversacionales (Dialogflow CX)

  1. En el panel de la izquierda, haga clic en la pestaña Gestionar.
  2. En el menú de la izquierda, haz clic en Integraciones.
  3. Haz clic en el botón Conectar de la tarjeta Slack.
  4. Rellena la siguiente información:
    • Token de acceso
    • Token de firma
  5. Elige un entorno, si procede.
  6. Haz clic en Empezar.
  7. Copia la URL del webhook.

Habilitar webhook en Slack

Vuelve a tu aplicación de Slack y pega la URL del webhook en Suscripciones a eventos > Habilitar eventos > URL de solicitud.

Pruebas

Para probar la aplicación que has configurado, menciónala en un canal de grupo o envíale un mensaje directo en el espacio de trabajo en el que la hayas instalado.

Mensajes de respuesta enriquecidos

Los mensajes de respuesta enriquecidos se admiten a través de Carga útil personalizada en Cumplimiento. Consulta el formato de los mensajes de la API de Slack.

Por ejemplo, la siguiente carga útil personalizada proporciona un mensaje de texto sencillo de Slack:

{
  "text": "Hello, world"
}

Respuestas específicas de un canal

Una vez que hayas configurado las respuestas específicas de cada canal, el canal DF_CX_SLACK se usará automáticamente cuando el agente responda a los mensajes de Slack.