Verbinden mit Slack

Vorbereitende Schritte

Um mit der Integration zu beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Ein Slack-Arbeitsbereich mit Berechtigung zum Erstellen oder Verwalten von Apps.

• Eine Slack-App, die innerhalb Ihres Arbeitsbereichs erstellt wurde. Hier kannst du eine Slack-App erstellen.

• Zugriff auf die Authentifizierungsdaten der App, darunter:

  • Client-ID : Eine eindeutige Kennung für Ihre Slack-App, die zur Authentifizierung von API-Anfragen verwendet wird.

  • Client Secret : Ein vertraulicher Schlüssel, der zur Überprüfung der Identität Ihrer Slack-App während der Authentifizierung verwendet wird.

  • Signing Secret : Ein geheimes Token, mit dem sichergestellt werden kann, dass eingehende Anfragen an Ihre App tatsächlich von Slack stammen.

  • Bot-Benutzer- OAuth -Token : Das Bot-Zugriffstoken (beginnt mit ), das für API-Aufrufe im Namen Ihres Bots verwendet wird.
  • Team-ID : Die ID Ihres Slack-Workspaces (beginnt mit T), die Sie unter URL oder in den Einstellungen Ihres Workspaces finden.

So findest du diese Anmeldedaten in deiner Slack-App:

• Client-ID, Client-Secret und Signing-Secret : Gehen Sie zu „Grundlegende Informationen“ > „App-Anmeldeinformationen“
• Bot-Benutzer- OAuth -Token : Gehe zu OAuth & Berechtigungen > Bot-Benutzer- OAuth -Token (beginnt mit xoxb-)
• Team-ID : Diese findest du in deiner Slack-ID (beginnt mit T„“, zu finden unter „Workspace- URL “ oder in den Einstellungen)

Richten Sie die Slack-Integration ein

Befolgen Sie diese Schritte, um Slack als Kommunikationskanal zu integrieren:

1. Gehen Sie auf https://api.slack.com/apps und wählen Sie Ihre App aus.
2. Gehen Sie zu Kanäle > Slack.
3. Wählen Sie die Umgebung (Entwurf oder Live) aus und klicken Sie auf „Neu erstellen “.
4. Lesen Sie auf der Seite „Erste Schritte “ die Anweisungen durch und führen Sie alle relevanten Schritte aus. Klicken Sie dann auf Weiter.
5. Gehen Sie auf der Seite " Erstellen Sie Ihre Slack-App " die bereitgestellten Anleitungen durch und wenden Sie alle relevanten Schritte an. Klicken Sie anschließend auf Weiter.
6. Geben Sie auf der Seite „Mit Slack verbinden “ die zuvor Client IDgespeicherten, Client secret, und Signing secret ein.

   Führen Sie die Schritte auf der Seite „Mit Slack verbinden“ aus. Zu den Schritten gehören unter anderem die Aktivierung von „ OAuth “, die Konfiguration der erforderlichen Bereiche und die Festlegung der entsprechenden Weiterleitungs-URLs. Die Einzelheiten zu den einzelnen Bereichen findest du in der Slack-Dokumentation.

   • app_mentions:read
   • chat:write
   • im:history
   • im:write
   • users.profile:read
   • users:read(Ermöglicht es dem Agenten, die Profile der Mitglieder im Arbeitsbereich einzusehen; dies ist erforderlich, damit der Agent die Namen der Mitglieder anstelle der unlesbaren Slack-IDs anzeigen kann.)
   • users:read.email(Ermöglicht dem Mitarbeiter bei Bedarf den Zugriff auf die E-Mail-Adressen der Mitglieder.)
7. Klicken Sie auf Weiter.
8. Klicken Sie auf der Seite Installieren (Agent, Bot) in Slack auf Einrichten, um die Slack-App in Ihrem Arbeitsbereich zu installieren. Folgen Sie den Anweisungen auf dem Bildschirm. Nachdem die Installation abgeschlossen ist, klicken Sie auf Weiter.
   Hinweis: Wenn du ein Entwickler bist und keine Administratorrechte im Slack-Workspace hast, fordert Slack dich auf, eine Installationsanfrage zu stellen, sobald du versuchst, die App hinzuzufügen. Reichen Sie die Anfrage ein und warten Sie, bis ein Workspace-Administrator sie genehmigt hat. Nachdem die App genehmigt wurde, kehren Sie zum Einrichtungsablauf zurück und führen Sie die gleichen Schritte aus, um die Installation abzuschließen.
9. Befolgen Sie auf der Seite „Agent in Slack konfigurieren“ die Anweisungen, um Ihre Slack-App-Einstellungen zu aktualisieren. Die empfohlenen Änderungen anwenden und speichern.
10. Klicken Sie auf Fertigstellen.
11. Stellen Sie Ihren Agenten bereit und kopieren Sie die Ereignis- URL en aus der Bereitstellungsausgabe.
12. Aktualisieren Sie die Ereignis- URL en in den Einstellungen für Ereignisabonnements Ihrer Slack-App.
    Wichtig: Kopieren Sie nach der Bereitstellung Ihres Agenten den Ereignis- URL -Link aus der Bereitstellungsausgabe und aktualisieren Sie ihn in den Einstellungen für Ereignisabonnements Ihrer Slack-App. Die Ereignis- URL en ändern sich bei jeder Bereitstellung.
13. Überprüfen Sie, ob Ihre Entwurfs- oder Live-Umgebung verbunden ist. Melden Sie sich bei Slack an und fügen Sie die neu erstellte Anwendung zu Ihrem Arbeitsbereich hinzu. Sie müssen in der Lage sein, über die Slack-App mit dem Agenten zu kommunizieren.

Nachdem die Integration gespeichert wurde, können Sie sie jederzeit entsprechend Ihren Anforderungen bearbeiten oder löschen.

Aktivieren Sie die E-Mail-Sichtbarkeit auf Slack

Slack blendet die E-Mail-Adressen der Benutzer aus, wenn die Einstellung „E-Mail-Anzeige“ in Ihrem Arbeitsbereich deaktiviert ist. In diesem Fall kann die users.profile.get API keine E-Mail-Werte zurückgeben. watsonx Orchestrate nutzt die E-Mail-Adresse des Benutzers, um Teilnehmer zu identifizieren und Kontextvariablen zu verwalten; daher muss diese Einstellung aktiviert sein, damit die Integration ordnungsgemäß funktioniert. Um diese Probleme zu vermeiden, stellen Sie sicher, dass die Einstellung „E-Mail-Anzeige“ in Ihrem Slack-Workspace aktiviert ist, damit der Agent über die Slack-API auf die E-Mail-Adressen der Benutzer zugreifen kann. So aktivieren Sie die E-Mail-Sichtbarkeit in Slack:

1. Klicken Sie in Slack auf das Symbol „Admin-Tools “ im linken Menü und wählen Sie die Option „Arbeitsbereichseinstellungen “.

2. Suchen Sie auf der Seite „Einstellungen & Berechtigungen“ den Abschnitt „E-Mail-Anzeige“ und klappen Sie ihn auf, um die aktuelle Konfiguration für die Frage „Wer kann die E-Mail-Adressen der Mitglieder von _[Name des Arbeitsbereichs]_ sehen?“ anzuzeigen

3. Wählen Sie eine der folgenden Optionen aus:

   • Mitglieder und Gäste von _[Name des Arbeitsbereichs]_

   • Mitglieder und Gäste von _[Name des Arbeitsbereichs]_ sowie Personen aus externen Organisationen, mit denen Sie in Verbindung stehen

Durch Auswahl einer der beiden Optionen kann „ watsonx Orchestrate “ die E-Mail-Adressen der Benutzer über die Slack-API abrufen.

Direkte Kommunikation mit der App in Slack aktivieren

Standardmäßig können Benutzer nur dann mit einer Slack-App interagieren, wenn die App zu einem Kanal hinzugefügt und explizit mit dem Symbol @ erwähnt wird. Damit Benutzer direkt mit Ihrer Slack-App kommunizieren können, müssen Sie die Berechtigungen und Konfigurationseinstellungen der App aktualisieren.

Nächste Schritte

Um kanalspezifische Kontextvariablen für Slack hinzuzufügen, befolgen Sie die Anweisungen unter Slack-Kontextvariablen.

Weitere Informationen zu KI-Apps in Slack findest du unter „KI-Apps in Slack verstehen“ ↗.