Einführung
Verbinden Sie Slack, damit der KI-Assistent und die Agenten ausgewählte Kanäle durchsuchen können, sobald ein Benutzer eine Frage stellt.
Dies ist ein Live-Konnektor. Es wird nichts aus Slack in Docebo kopiert, indiziert oder gespeichert. Wenn ein Benutzer eine Frage stellt, durchsucht Docebo zu diesem Zeitpunkt die Kanäle, die Sie verfügbar gemacht haben, und verwendet dabei das eigene Slack-Konto des Benutzers.
So funktionieren die Berechtigungen für Slack: Jeder Kollege verbindet sein eigenes Slack-Konto, sobald dies zum ersten Mal erforderlich ist. Jede Suche wird anschließend als dieser Benutzer ausgeführt, sodass er nur Inhalte sieht, die er selbst in Slack öffnen könnte. Das Konto, das Sie während der Einrichtung verwenden, dient nur zum Einrichten der Verbindung und zum Auflisten der Kanäle, aus denen Sie auswählen können.
1. Voraussetzungen im Quellsystem
Erforderliche Rolle
Sie benötigen die Berechtigung, Apps in Ihrem Slack-Arbeitsbereich zu erstellen. Wenn in Ihrem Arbeitsbereich für neue Apps eine Administratorgenehmigung erforderlich ist, muss ein Arbeitsbereichsadministrator die App einmal genehmigen (siehe Schritt 3).
Erforderliche Einstellungen
Das Konto, mit dem Sie die Autorisierung durchführen, muss Mitglied jedes privaten Kanals sein, den Sie verfügbar machen möchten.
2. Vorbereitung im Quellsystem
Sie können entweder eine neue Slack-App aus dem von Docebo bereitgestellten Manifest erstellen (empfohlen) oder eine bereits vorhandene App wiederverwenden.
Slack-App aus dem Manifest erstellen
- Kopieren Sie auf der Registerkarte Autorisieren in Docebo das Manifest über die Kopierschaltfläche.
- Öffnen Sie Eine Slack-App erstellen (api.slack.com/apps) und melden Sie sich bei Slack an, falls Sie dazu aufgefordert werden.
- Wählen Sie Aus einem Manifest, wählen Sie Ihren Arbeitsbereich aus und klicken Sie auf Weiter.
- Stellen Sie den Editor auf JSON um, ersetzen Sie den Inhalt durch das Manifest und klicken Sie anschließend auf Weiter sowie auf Erstellen und Installieren.
Slack öffnet die Seite Grundlegende Informationen der neuen App. Das Manifest enthält bereits die Berechtigungen und die Weiterleitungs-URL, sodass nichts weiter konfiguriert werden muss.
Das Manifest fordert die folgenden Benutzer-Token-Bereiche an:
| Bereich | Ermöglicht |
|---|---|
| channels:read | Grundlegende Informationen zu öffentlichen Kanälen anzeigen |
| channels:history | Nachrichten und andere Inhalte in öffentlichen Kanälen anzeigen |
| groups:read | Grundlegende Informationen zu privaten Kanälen anzeigen, auf die Sie Zugriff haben |
| groups:history | Nachrichten und andere Inhalte in privaten Kanälen anzeigen, auf die Sie Zugriff haben |
| search:read.public | Nachrichten und Dateien in öffentlichen Kanälen durchsuchen |
| search:read.private | Nachrichten und Dateien in privaten Kanälen durchsuchen, auf die Sie Zugriff haben |
| search:read.users | Nach Personen im Arbeitsbereich suchen |
| users:read | Personen im Arbeitsbereich anzeigen |
Sie haben bereits eine Slack-App? Verwenden Sie sie stattdessen wieder
Überspringen Sie das Manifest und richten Sie Ihre vorhandene App ein:
- Öffnen Sie die App unter api.slack.com/apps und wechseln Sie zu OAuth und Berechtigungen.
- Fügen Sie unter Weiterleitungs-URLs die in Docebo angezeigte Callback-URL hinzu und klicken Sie auf URLs speichern. Sie folgt diesem Muster: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, zum Beispiel https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- Fügen Sie unter Bereiche → Benutzer-Token-Bereiche jeden oben aufgeführten Bereich hinzu.
- Lassen Sie die Tokenrotation deaktiviert. Auf der Seite Agenten muss nichts aktiviert werden. Lassen Sie daher den Schalter Slack-MCP-Server deaktiviert.
- Wenn Slack Sie auffordert, die App erneut zu installieren, tun Sie dies und fahren Sie anschließend mit dem nächsten Abschnitt fort.
3. Erforderliche Aktionen in Docebo
| Einzugebende Informationen | Wo Sie sie finden |
|---|---|
| Client-ID | Slack-App → Grundlegende Informationen → App-Anmeldedaten |
| Client-Secret | Slack-App → Grundlegende Informationen → App-Anmeldedaten. Klicken Sie neben dem Client-Secret auf Anzeigen. Verwenden Sie nicht das Signaturgeheimnis. |
Konnektor autorisieren
- Gehen Sie zu Add-ons und Integrationen → Wissenskonnektoren → Erstellen → Slack. Dieses Menü ist nur für Superadmins sichtbar. Überprüfen Sie auf der Registerkarte Overview, was durchsucht wird, und wählen Sie Get started.
- Folgen Sie auf der Registerkarte Autorisieren den Schritten zum Erstellen oder Wiederverwenden Ihrer Slack-App (siehe Vorbereitung).
- Kopieren Sie auf der Seite Grundlegende Informationen Ihrer App unter App-Anmeldedaten die Client-ID und das Client-Secret in die Felder auf der Registerkarte Autorisieren.
- Wählen Sie Authentifizieren, melden Sie sich mit dem Slack-Konto an, das Mitglied jedes privaten Kanals ist, den Sie verfügbar machen möchten, und klicken Sie auf Zulassen. Wenn in Ihrem Arbeitsbereich für neue Apps eine Administratorgenehmigung erforderlich ist, zeigt Slack stattdessen einen Genehmigungsbildschirm an. Ein Arbeitsbereichsadministrator genehmigt die App einmal. Wählen Sie anschließend erneut Authentifizieren.
- Wählen Sie auf der Registerkarte Kanäle die Kanäle aus, die Sie verfügbar machen möchten, und speichern Sie anschließend Ihre Auswahl.