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

Configura Slack

A fin de configurar la integración de Slack para tu agente, necesitarás lo siguiente:

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

Crea un bot de Slack

  1. Navega a tus Apps de Slack.
  2. Crea una nueva app de Slack a partir de un manifiesto de la app. 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 tu aplicación en el espacio de trabajo que elijas.
    • Token de OAuth de usuario bot
      • Navega a Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token.
    • Token de firma
      • Navega a Información básica > Credenciales de la app > Secreto de firma.

Configura Conversational Agents (Dialogflow CX)

  1. Haz clic en la pestaña Administrar en el panel izquierdo.
  2. Haz clic en Integraciones en el menú de la izquierda.
  3. Haz clic en el botón Conectar en el mosaico Slack.
  4. Completa la siguiente información:
    • Token de acceso
    • Token de firma
  5. Elige un entorno, según corresponda.
  6. Haz clic en Start.
  7. Copia la URL de webhook.

Habilita webhook en Slack

Regresa a tu app de Slack y pega la URL del webhook en Suscripciones a eventos > Habilitar eventos > URL de solicitud.

Prueba

Para probar la app configurada, menciónala en un canal de grupo o envíale un MD en el espacio de trabajo en el que la instalaste.

Mensajes de respuesta enriquecida

Los mensajes de respuesta enriquecida son compatibles con la carga útil personalizada en Entregas. Consulta la API de mensajes de Slack para conocer el formato del mensaje.

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

{
  "text": "Hello, world"
}

Respuestas específicas del canal

Después de configurar las respuestas específicas del canal, el canal DF_CX_SLACK se usa automáticamente cuando el agente responde a los mensajes de Slack.