Slack

La integración de Slack te permite crear bots de Slack con comprensión del lenguaje natural basada en la tecnología de Dialogflow CX.

Limitaciones

Configura Slack

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

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

Crea un bot de Slack

  1. Ve a tus apps de Slack.
  2. Crea una app de Slack nueva a partir de un manifiesto de la app. El siguiente es un manifiesto de ejemplo. Asegúrate de que los campos oauth_config y event_subscriptions coincidan con el manifiesto de ejemplo:

    display_information:
      name: Dialogflow CX
      description: 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 app en el espacio de trabajo que elijas:

    • Token de OAuth del usuario bot: Ve a Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token.
    • Token de firma: Ve a Información básica > Credenciales de la app > Secreto de firma.

Configura Dialogflow CX

  1. Ve a la pestaña Administrar en el menú de navegación.
  2. Selecciona Integraciones.
  3. Haz clic en el botón Conectar en la tarjeta de Slack.
  4. Proporciona la siguiente información:
    • Token de acceso
    • Token de firma
  5. Selecciona un entorno, según corresponda.
  6. Haz clic en Iniciar.
  7. Copia la URL de webhook.

Habilita el webhook en Slack

Ve a Slack Apps y pega tu URL de webhook en Event Subscriptions > Enable Events > Request URL.

Pruebas

Para probar la app configurada en tu espacio de trabajo, menciónala en un canal de grupo o envía un mensaje directo.

Mensajes de respuesta enriquecida

Los mensajes de respuesta enriquecida se admiten con la carga útil personalizada en el cumplimiento. Para obtener más información, consulta la API de mensajes de Slack para conocer el formato de los mensajes.

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

{
  "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.