Slack

Mit der Slack-Integration können Sie mühelos Slack-Bots mit Natural Language Understanding basierend auf der Conversational Agents-Technologie (Dialogflow CX) erstellen.

Beschränkungen

Slack einrichten

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

  • Ein Slack-Konto
  • Ein 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. Achte darauf, dass die Felder oath_config und event_subscriptions mit dem Beispielmanifest übereinstimmen. 
    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. Anwendung im gewünschten Arbeitsbereich installieren
    • OAuth-Token des Bot-Nutzers
      • Gehen Sie zu „App installieren“ > „OAuth-Tokens für Ihren Arbeitsbereich“ > „OAuth-Token des Bot-Nutzers“.
    • Signiertes Token
      • Rufen Sie „Allgemeine Informationen“ > „App-Anmeldedaten“ > „Signierungs-Secret“ auf.

Konversations-Agents einrichten (Dialogflow CX)

  1. Klicken Sie im linken Bereich auf den Tab Verwalten.
  2. Klicken Sie im linken Menü auf Integrations (Integrationen).
  3. Klicken Sie auf 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 URL unter Webhook URL (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 Gruppenchannel oder senden Sie ihr eine Direktnachricht.

Rich-Media-Antworten

Rich-Media-Antworten werden unterstützt überBenutzerdefinierte Nutzlast inAuftragsausführung finden Sie weitere Informationen. Informationen zum Nachrichtenformat finden Sie unter 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.