In Slack integrieren

IBM Cloud

Slack ist eine cloudbasierte Messaging-Anwendung zur Unterstützung der Onlinezusammenarbeit von Benutzern.

Nachdem Sie eine Aktion erstellt haben, können Sie Ihren Assistenten in Slack integrieren.

Nach der Integration kann Ihr Assistent abhängig von den Ereignissen, für deren Unterstützung Sie den Assistenten konfigurieren, auf Fragen antworten, die in direkten Nachrichten oder in Kanälen, in denen der Assistent direkt erwähnt wird, gestellt werden.

Ein Beispiel und Anweisungen zum Erstellen eines Slackbot mit watsonx Assistant, Slack und Db2 finden Sie im Lösungslernprogramm Datenbankgesteuerten Slackbot erstellen.

Vorbereitende Schritte

Um Slack in Ihren Assistenten zu integrieren, müssen Sie über eine Slack-App und die erforderlichen Rollen und Berechtigungen verfügen:

Rollen Berechtigungen
Arbeitsbereich oder
-Organisationseigner		 Informationen anzeigen
Informationen veröffentlichen
Aktionen ausführen

Um eine Slack-App zu erstellen, siehe Quickstart: Starten Sie einen Workflow.

Weitere Informationen zu Rollen und Berechtigungen finden Sie unter Slack - Erste Schritte.

Slack-Integration hinzufügen

  1. Rufen Sie die Seite Integrationen auf, indem Sie im linken Menü auf das Integrationssymbol (Symbol für Integrationen) klicken.

  2. Klicken Sie auf der Kachel Slack auf Hinzufügen.

  3. Klicken Sie dann erneut auf "Hinzufügen ".

Erste Schritte

Die Einrichtung von Slack erfolgt in vier Schritten:

  • Einrichten Ihres Slack-Bots
  • Verbinde watsonx Assistant mit Slack
  • Konfigurieren Sie Ihren Slack-Bot
  • Verbinden Sie Ihren Assistenten

Einrichten Ihres Slack-Bots

  1. Gehen Sie auf die Seite Ihre Apps auf der Slack-Website und klicken Sie dann auf die App, die Sie verwenden möchten, oder erstellen Sie eine neue App.

Verbinde watsonx Assistant mit Slack

  1. Gehen Sie auf der Einstellungsseite der Slack-App zur Registerkarte "Grundlegende Informationen " und scrollen Sie nach unten zum Abschnitt "App-Zugangsdaten ".

  2. Kopieren Sie Ihr Verifizierungs-Token und fügen Sie es auf der Seite Assistenteneinrichtung ein.

  3. Auf der Seite Slack-App-Einstellungen gehen Sie zu Features > OAuth & Permissions und scrollen Sie nach unten zum Abschnitt Bot Token Scopes.

  4. Klicken Sie auf "OAuth-Bereich hinzufügen " und wählen Sie die folgenden Bereiche aus:

    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write

  5. Scrollen Sie auf der Seite nach oben zum Abschnitt Authentifizierungstoken für Ihren Arbeitsbereich und klicken Sie auf Anwendung im Arbeitsbereich installieren und dann auf Zulassen.

    Sie sollten zurück zur Seite OAuth & Permissions geleitet werden.

  6. Kopieren Sie Ihr OAuth-Zugangs-Token für den Bot-Benutzer und fügen Sie es auf der Seite Assistenteneinrichtung ein.

  7. Klicken Sie auf Weiter, um den Vorgang fortzusetzen.

Konfigurieren Sie Ihren Slack-Bot

  1. Kopieren Sie Erzeugte Anfrage URL.

  2. Gehen Sie auf der Seite Slack-App-Einstellungen zu Funktionen > Ereignisabonnements und schalten Sie den Ereignisse aktivieren Schalter on um.

  3. Fügen Sie URL unter URL ein.

    Warten Sie, bis neben URL (URL anfordern) "Verified" (Verifiziert ) mit einem grünen Häkchen angezeigt wird.

  4. Scrollen Sie nach unten und klicken Sie auf Abonnieren Sie Bot-Events.

  5. Wählen Sie die Veranstaltungstypen aus, die Sie abonnieren möchten. Sie müssen mindestens einen der folgenden Typen auswählen:

    • message.im: Überwacht Nachrichtenereignisse, die in einem Direktnachrichtenkanal übergeben werden.

    • app_mention: Überwacht nur Nachrichtenereignisse, die Ihre App oder Ihren Bot erwähnen.

      Wählen Sie den Eintrag app_mention in Normalschrift aus und nicht den Eintrag 'app_mention' in Fettschrift.

  6. Klicken Sie auf Änderungen speichern.

  7. Klicken Sie auf der Seite Assistenteneinrichtung auf Weiter.

Verbinden Sie Ihren Assistenten

  1. Gehen Sie auf der Seite Slack-App-Einstellungen zu Features > AppHome und klicken Sie auf Edit neben App Display Name.

  2. Klicken Sie auf Speichern, sobald Sie die Änderungen vorgenommen haben.

  3. Schalten Sie den Schalter Meinen Bot immer als online anzeigen auf on um.

  4. Gehen Sie zum Abschnitt Registerkarten anzeigen und schalten Sie die Registerkarte Nachrichten auf on um.

  5. Aktivieren Sie das Kontrollkästchen Benutzern das Senden von Slash-Befehlen und Nachrichten über die Registerkarte Nachrichten erlauben.

  6. Wenn Sie Unterstützung für die Anzeige von Schaltflächen, Menüs und Disambiguierungsoptionen in der Slack-App hinzufügen möchten, führen Sie die folgenden Schritte aus:

    1. Gehen Sie zur Registerkarte Interaktivität & Shortcuts und aktivieren Sie die Funktion
    2. Fügen Sie URL Ihrer Anfrage in das dafür vorgesehene Texteingabefeld ein.
    3. Klicken Sie auf Änderungen speichern.

  7. Klicken Sie auf der Seite Assistenteneinrichtung auf Beenden.

Wenn ein für die Authentifizierung erforderliches token-Feld geändert wird, müssen alle Einträge in zugehörigen Feldern ausgefüllt und erneut validiert werden.

Hinweise zu Aktionen

Die zahlreichen Antworten, die Sie zu einer Aktion hinzufügen, werden in einem Slack-Kanal angezeigt, mit folgenden Ausnahmen:

  • Mit einem Live-Berater verbinden: Diese Antwort wird ignoriert.

  • Option: Dieser Antworttyp zeigt eine Liste der Optionen, die für den Benutzer zur Auswahl stehen.

    • Nachdem ein Benutzer auf eine der Optionen geklickt hat, verschwindet die vorhandene Auswahl und wird durch die Benutzereingabe ersetzt, die durch die Auswahl des Benutzers erzeugt wird. Wenn Sie mehrere Antworttypen in eine einzige Antwort einbeziehen, müssen Sie die Option Antworttyp am Ende positionieren, um Verwirrungen aufgrund einer Mischung von Antworten und Benutzereingaben zu vermeiden.

    • Wenn die Optionen in einer Dropdown-Liste angezeigt werden, darf jeder Optionswert höchstens 75 Zeichen lang sein. Wenn eine Liste 5 oder mehr Optionen enthält, wird sie in einer Dropdown-Liste angezeigt.

Mit dem Assistenten chatten

So starten Sie einen Chat mit dem Assistenten:

  1. Öffnen Sie Slack und rufen Sie den Arbeitsbereich auf, der Ihrer App zugeordnet ist.
  2. Klicken Sie im Abschnitt für Anwendungen auf die Anwendung, die Sie erstellt haben.
  3. Chatten Sie mit dem Assistenten.

Die Begrüßungsaktion wird von der Slack-Integration nicht verarbeitet. Die Begrüßungsnachricht wird im Slack-Kanal nicht wie in der Vorschau des Assistenten angezeigt. Dies liegt daran, dass Knoten mit der Sonderbedingung welcome in den von Benutzern gestarteten Aktionsabläufen übersprungen werden. Slack wartet, bis der Benutzer das Dialogmodul startet.

Der Aktionsablauf für die aktuelle Sitzung wird nach 60 Minuten Inaktivität erneut gestartet (5 Minuten für Lite- und Standardpläne). Mit anderen Worten: Wenn ein Benutzer 60 bzw. 5 Minuten lang nicht mit dem Assistenten interagiert, werden alle während des vorherigen Dialogs gesetzten Werte für Kontextvariablen auf null oder auf die jeweiligen Standardwerte zurückgesetzt.