Slack

Mit der Slack-Integration können Sie Slack-Bots mit Natural Language Understanding auf Basis der Dialogflow CX-Technologie erstellen.

Beschränkungen

Slack einrichten

Für die Einrichtung der Slack-Integration für Ihren Agenten benötigen Sie Folgendes:

  • Ein Slack-Konto.
  • Einen Slack-Workspace.

Slack-Bot erstellen

  1. Rufen Sie Ihre Slack-Apps auf.
  2. Erstellen Sie eine neue Slack-App aus einem App-Manifest. Hier sehen Sie ein Beispielmanifest. Achten Sie darauf, dass die Felder oauth_config und event_subscriptions mit dem Beispielmanifest übereinstimmen:

    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. Installieren Sie die App im Arbeitsbereich Ihrer Wahl:

    • Bot User OAuth Token: Gehen Sie zu Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token.
    • Signaturtoken: Gehen Sie zu Basic Information (Grundlegende Informationen) > App Credentials (App-Anmeldedaten) > Signing Secret (Signatur-Secret).

Dialogflow CX einrichten

  1. Rufen Sie im Navigationsmenü den Tab Verwalten auf.
  2. Wählen Sie Integrationen aus.
  3. Klicken Sie auf der Kachel Slack auf den Button Verbinden.
  4. Geben Sie die folgenden Informationen an:
    • Zugriffstoken
    • Signaturtoken
  5. Wählen Sie gegebenenfalls eine Umgebung aus.
  6. Klicken Sie auf Start.
  7. Kopieren Sie die URL unter Webhook URL (Webhook-URL).

Webhook in Slack aktivieren

Rufen Sie Slack-Apps auf und fügen Sie Ihre Webhook-URL unter Ereignisabos > Ereignisse aktivieren > Anfrage-URL ein.

Test

Wenn Sie die konfigurierte App in Ihrem Arbeitsbereich testen möchten, erwähnen Sie sie in einem Gruppenkanal oder senden Sie eine Direktnachricht.

Rich-Media-Antworten

Rich-Response-Nachrichten werden mit Benutzerdefinierte Nutzlast in Fulfillment unterstützt. Weitere Informationen zum Nachrichtenformat finden Sie in der Slack Message API.

Die folgende benutzerdefinierte Nutzlast stellt beispielsweise eine Slack-Textnachricht bereit:

{
  "text": "Hello, world"
}

Kanalspezifische Antworten

Nachdem Sie die kanalspezifischen Antworten konfiguriert haben, wird der Kanal DF_CX_SLACK automatisch verwendet, wenn der Agent auf Slack-Nachrichten antwortet.