Slack

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

Beschränkungen

Slack einrichten

Sie benötigen Folgendes, um die Slack-Integration für Ihren Agent einzurichten:

  • 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. Unten sehen Sie ein Beispielmanifest. Achten Sie darauf, dass die Felder oath_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 Anwendung im gewünschten Workspace.
    • OAuth-Token des Bot-Nutzers
      • Rufen Sie „App installieren“ > „OAuth-Tokens für Ihren Workspace“ > „OAuth-Token des Bot-Nutzers“ auf.
    • Signiertoken
      • Rufen Sie „Grundlegende Informationen“ > „App-Anmeldedaten“ > „Signierungs-Secret“ auf.

Dialogflow CX einrichten

  1. Klicken Sie im linken Bereich auf den Tab Verwalten.
  2. Klicken Sie im linken Menü auf Integrations (Integrationen).
  3. Klicken Sie in der Kachel Slack auf die Schaltfläche Verbinden.
  4. Geben Sie die folgenden Informationen an:
    • Zugriffstoken
    • Signiertoken
  5. Wählen Sie gegebenenfalls eine Umgebung aus.
  6. Klicken Sie auf Start.
  7. Kopieren Sie die Webhook-URL.

Webhook in Slack aktivieren

Kehren Sie zu Ihrer Slack-App zurück und fügen Sie die Webhook URL unter Event Subscriptions > Enable Events > Request URL ein.

Test

Wenn Sie die konfigurierte App testen möchten, erwähnen Sie sie in dem Workspace, in dem Sie sie installiert haben, in einem Gruppenkanal oder senden Sie ihr eine Direktnachricht.

Rich-Media-Antworten

Rich-Media-Antworten werden über Benutzerdefinierte Nutzlast in der Auftragsausführung unterstützt. Informationen zum Nachrichtenformat finden Sie in der Slack Message API.

Die folgende benutzerdefinierte Nutzlast stellt beispielsweise eine einfache 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.