Slack

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Mit der Slack-Integration von Dialogflow können Sie mühelos Slack-Bots mit Natural Language Understanding basierend auf Dialogflow-Technologie erstellen.

Hinweis: Wenn Sie eine Drittanbieterintegration verwenden, werden Anfragen und Endnutzerdaten sowohl an Google als auch an den Drittanbieter gesendet. Für das Bearbeiten dieser Anfragen durch Google gelten die Nutzungsbedingungen, das SLA, die Preise und die Kontingente für Ihre Agent-Edition. Für das Bearbeiten dieser Anfragen durch den Drittanbieter gelten die Nutzungsbedingungen, das SLA, die Preise und die Kontingente des Drittanbieters.

Beschränkungen

• Von dieser Integration wird nur die Texteingabe in der Standardsprache des Agents unterstützt.

Slack einrichten

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

• Ein Slack-Konto
• Ein Slack-Arbeitsbereich

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. Prüfen Sie, ob 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 Arbeitsbereich Ihrer Wahl
   • OAuth-Token des Bot-Nutzers
     • Gehen Sie zu „Install App“ > „OAuth Tokens for Your Workspace“ > „Bot User OAuth Token“.
   • Signaturtoken
     • Gehen Sie zu „Allgemeine Informationen“ > „App-Anmeldedaten“ > „Signatur-Secret“.

Dialogflow 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 URL unter Webhook URL (Webhook-URL).

Webhook in Slack aktivieren

Kehren Sie zu Ihrer Slack-App zurück und fügen Sie Ihre Webhook-URL unter Event Subscriptions > Enable Events > Request URL (Ereignisabos > Ereignisse aktivieren > Anfrage-URL) ein.

Testen

Hinweis: Achten Sie darauf, dass die Abrechnung für Ihr Projekt aktiviert ist, bevor Sie die Integration testen.

Wenn Sie die konfigurierte Anwendung testen möchten, erwähnen Sie sie in einem Gruppenkanal oder senden Sie eine DM in dem Arbeitsbereich, in dem Sie sie installiert haben.

Rich-Media-Antworten

Rich-Media-Antworten werden unterstützt überBenutzerdefinierte Nutzlast inAuftragsausführung finden Sie weitere Informationen. Das Nachrichtenformat finden Sie unter Slack Message API.

Hinweis: Wenn es nicht in der benutzerdefinierten Nutzlast angegeben ist, wird das Kanalfeld automatisch mit der Kanal-ID der Eingabenachricht eingeschleust.

Die folgende benutzerdefinierte Nutzlast liefert beispielsweise eine einfache Slack-Textnachricht:

{
  "text": "Hello, world"
}

Kanalspezifische Antworten

Nach der Konfiguration werden kanalspezifische Antworten mit dem Kanal DF_CX_SLACK automatisch verwendet, wenn der Agent auf Slack-Nachrichten antwortet.