Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Slack-Integration
Mit dem Slack Action Connector können Sie in natürlicher Sprache direkt in Amazon Quick auf die Slack-Plattform zugreifen. Sie können Nachrichten senden, Kanäle verwalten, Inhalte durchsuchen und mit Benutzern und Benutzergruppen interagieren, ohne Amazon Quick verlassen zu müssen.
Amazon Quick unterstützt mehrere Authentifizierungsmethoden für Slack. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.
-
Standard-OAuth-Anwendung — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Du authentifizierst dich direkt bei deinem Slack-Workspace.
-
Benutzerdefinierte OAuth-App — Verwendet eine vom Kunden verwaltete Slack-App. Diese Option gibt deiner Organisation die volle Kontrolle über die OAuth-Konfiguration.
-
Bearer-Token — Verwendet ein Slack-Bot-Token zur Authentifizierung. Diese Methode eignet sich für den Zugriff auf einen Workspace auf Bot-Ebene.
Weitere Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unterAuthentifizierungsmethoden.
Bevor Sie beginnen
Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.
-
Ein Slack-Workspace mit Zugriff auf die Kanäle und Daten, die du verwenden möchtest.
-
Für benutzerdefinierte OAuth-Apps: Zugriff auf das Slack-API-Dashboard auf der Slack-Website
, um eine App zu erstellen. -
Für Bearer-Token: Ein Bot-Token (beginnt mit
xoxb-) aus einer Slack-App. Weitere Informationen findest du unter Einstellungen der Schnellstart-Appauf der Slack-Website. -
Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.
Konfigurieren von Slack
Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden, überspringen Sie diesen Abschnitt und wechseln Sie zu. Den Connector in Amazon Quick einrichten
Führe für die benutzerdefinierte OAuth-App- oder Bearer-Token-Authentifizierung die entsprechenden Schritte in Slack durch, bevor du Amazon Quick konfigurierst.
Erstelle eine Slack-App für eine benutzerdefinierte OAuth-App oder ein Bearer-Token
Erstelle eine Slack-App, um die Kundenanmeldedaten oder das Bot-Token zu erhalten, die du für Amazon Quick benötigst.
-
Gehe zum Slack-API-Dashboard
auf der Slack-Website und wähle Neue App erstellen. -
Wähle Von Grund auf neu.
-
Gib einen App-Namen ein und wähle deinen Slack-Workspace aus. Wählen Sie Create app (App erstellen).
-
Wähle in der linken Seitenleiste OAuth & Permissions.
-
Wählen Sie unter Weiterleitungs-URLs die Option Neue Weiterleitungs-URL hinzufügen und geben Sie die Amazon Quick Callback-URL ein:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallbackWählen Sie „Hinzufügen“ und anschließend „URLs speichern“.
-
Fügen Sie unter Bereiche die Bot-Token-Bereiche hinzu, die für Ihre Integration erforderlich sind. Die empfohlenen Bereiche finden Sie unter. Empfohlene Bereiche
-
Wählen Sie in der linken Seitenleiste die Option Basisinformationen aus. Notieren Sie sich unter App-Anmeldeinformationen die folgenden Werte:
-
Kunden-ID
-
Clientschlüssel
-
-
Für Bearer Token: Installieren Sie die App über die Seite OAuth & Permissions in Ihrem Workspace. Kopieren Sie nach der Installation das Bot-Benutzer-OAuth-Token (beginnt mit).
xoxb-
Empfohlene Bereiche
Die folgenden Bereiche werden abgefragt, wenn du eine Verbindung zu Slack herstellst. Wenn du eine benutzerdefinierte Slack-App erstellst, füge diese Bereiche auf der Seite OAuth & Permissions hinzu. Füge für benutzerdefinierte OAuth-Apps sie als Benutzer-Token-Bereiche hinzu. Fügen Sie sie für Bearer Token als Bot Token Scopes hinzu.
| Scope | Description |
|---|---|
calls:read |
Liest Anrufinformationen. |
calls:write |
Erstellt und verwaltet Anrufe. |
channels:history |
Liest den Nachrichtenverlauf in öffentlichen Kanälen. |
channels:read |
Liest Informationen über öffentliche Kanäle. |
channels:write |
Verwaltet öffentliche Kanäle. |
chat:write |
Sendet Nachrichten an Kanäle und Konversationen. |
dnd:read |
Liest die „Bitte nicht stören“ -Einstellungen vor. |
dnd:write |
Aktualisiert die „Bitte nicht stören“ -Einstellungen. |
emoji:read |
Liest benutzerdefinierte Emojis. |
files:read |
Liest in Kanälen geteilte Dateien. |
files:write |
Lädt Dateien hoch und verwaltet sie. |
groups:history |
Liest den Nachrichtenverlauf in privaten Kanälen. |
groups:read |
Liest Informationen über private Kanäle. |
groups:write |
Verwaltet private Kanäle. |
im:history |
Liest den Nachrichtenverlauf in Direktnachrichten. |
im:read |
Liest Informationen über Direktnachrichten. |
im:write |
Startet Direktnachrichten. |
links:read |
Liest Linkvorschauen. |
links:write |
Verwaltet Linkvorschauen. |
mpim:history |
Liest den Nachrichtenverlauf in Gruppendirektnachrichten. |
mpim:read |
Liest Informationen über Gruppendirektnachrichten. |
mpim:write |
Startet Gruppendirektnachrichten. |
pins:read |
Liest angeheftete Nachrichten. |
pins:write |
Heftet Nachrichten an und entfernt sie. |
reactions:read |
Liest Emoji-Reaktionen auf Nachrichten. |
reactions:write |
Fügt Emoji-Reaktionen hinzu und entfernt sie. |
reminders:read |
Liest Erinnerungen. |
reminders:write |
Erstellt Erinnerungen. |
remote_files:read |
Liest entfernte Dateien. |
remote_files:share |
Teilt entfernte Dateien. |
search:read |
Durchsucht Nachrichten und Dateien. |
stars:read |
Liest Objekte, die mit einem Stern markiert sind. |
stars:write |
Objekte mit Sternen markieren und die Sterne entfernen. |
team:read |
Liest Informationen zum Arbeitsbereich. |
usergroups:read |
Liest Informationen zu Benutzergruppen. |
usergroups:write |
Verwaltet Benutzergruppen. |
users:read |
Liest Benutzerinformationen. |
users:read.email |
Liest Benutzer-E-Mail-Adressen. |
users:write |
Aktualisiert Benutzerinformationen. |
users.profile:read |
Liest Benutzerprofilinformationen. |
users.profile:write |
Aktualisiert die Benutzerprofilinformationen. |
Anmerkung
Nicht alle Bereiche sind sowohl für Benutzer-Token-Bereiche als auch für Bot-Token-Bereiche verfügbar. Einige Bereiche, wie z. B. search:read undstars:read, sind nur als Benutzer-Token-Bereiche verfügbar. Wenn du Bereiche für die Bearer-Token-Authentifizierung konfigurierst, überprüfe die Verfügbarkeit von Bereichen in der Slack-API-Bereichsreferenz auf der Slack-Website
Den Connector in Amazon Quick einrichten
Über den Tab „Verfügbar“ eine Connect
Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über die Registerkarte Verfügbar eine Verbindung herstellen.
-
Wählen Sie in der Amazon Quick-Konsole Connectors aus.
-
Suche auf dem Tab „Verfügbar“ nach Slack und wähle Connect aus.
-
Schließe den Anmeldevorgang bei Slack ab und erteile die angeforderten Berechtigungen.
Um stattdessen einen Connector mit einer benutzerdefinierten OAuth-App oder einem Bearer-Token zu konfigurieren, verwende den Tab „Für dein Team erstellen“, wie unten beschrieben.
Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“
Nachdem Sie alle erforderlichen Slack-Konfigurationen abgeschlossen haben, erstellen Sie den Connector in Amazon Quick.
-
Wählen Sie in der Amazon Quick-Konsole Connectors aus.
-
Wählen Sie den Tab „Für Ihr Team erstellen“.
-
Finde Slack und wähle es aus.
Anmerkung
Wenn ein Slack-Connector bereits existiert, erscheint ein Dialog mit deinen bestehenden Connectoren. Um einen vorhandenen Konnektor zu verwenden, wähle ihn aus. Um einen neuen zu erstellen, wählen Sie Nein, neu erstellen.
-
Geben Sie einen Namen für Ihren Connector ein. Wählen Sie optional + Beschreibung hinzufügen, um eine Beschreibung hinzuzufügen.
-
Wählen Sie als Verbindungstyp die Option Öffentliches Netzwerk aus.
-
Wählen Sie für die OAuth-Konfiguration eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.
-
Für die Standard-OAuth-App:
Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie Next (Weiter), um fortzufahren.
-
Konfigurieren Sie für die benutzerdefinierte OAuth-App die folgenden Felder:
-
Basis-URL (optional) — Die Basis-URL der Slack-API. Beispiel:
https://slack.com/api -
Client-ID — Die Client-ID aus deiner Slack-App.
-
Kundengeheimnis — Das geheime Client-Geheimnis aus deiner Slack-App.
-
Token-URL — Der Token-Endpunkt. Beispiel:
https://slack.com/api/oauth.v2.access -
Autorisierungs-URL — Der Autorisierungsendpunkt. Beispiel:
https://slack.com/oauth/v2/authorize -
Weiterleitungs-URL — Pre-filled mit der Amazon Quick Callback-URL.
-
-
Konfigurieren Sie für Bearer Token die folgenden Felder:
-
Basis-URL (optional) — Die Basis-URL der Slack-API. Beispiel:
https://slack.com/api -
Bot-Token — Dein Slack-Bot-Token (beginnt mit
xoxb-).
-
-
-
Wählen Sie Weiter aus.
-
Wenn du die Standard-OAuth-App oder die benutzerdefinierte OAuth-App ausgewählt hast, wird ein Slack-Autorisierungsfenster geöffnet. Überprüfe die angeforderten Berechtigungen, wähle deinen Workspace aus und wähle Zulassen.
-
Überprüfe auf der Seite „Überprüfen“ die verfügbaren Aktionen für den Connector. Wählen Sie Weiter aus.
-
Wählen Sie auf der Seite „Veröffentlichen“ aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.
-
Wählen Sie Publish.
Verfügbare Aktionen
Nachdem Sie den Connector eingerichtet haben, sind die folgenden Aktionen verfügbar.
| Kategorie | Action | Description |
|---|---|---|
| Nachrichten | Nachricht posten im Chat | Sendet eine Nachricht in einem Kanal, einer Direktnachricht oder einer privaten Gruppe. |
| Nachrichten | Schick mir eine Nachricht | Sendet eine Aktionsnachricht einer dritten Person an einen Kanal. |
| Nachrichten | Nachricht abrufen Permalink | Ruft eine Permalink-URL für eine bestimmte Nachricht ab. |
| Kanäle | Konversationen Erstellen | Erzeugt einen öffentlichen oder privaten Kanal. |
| Kanäle | Verlauf der Konversationen | Ruft den Nachrichtenverlauf von einem Kanal ab. Gibt nur Nachrichten aus der Haupt-Timeline zurück, keine Thread-Antworten. |
| Kanäle | Konversationen, Antworten | Ruft Thread-Antworten auf eine bestimmte übergeordnete Nachricht ab. |
| Kanäle | Konversationen laden ein | Lädt Benutzer zu einem vorhandenen Kanal ein. |
| Kanäle | Konversationen beitreten | Tritt einem bestehenden Kanal bei. |
| Kanäle | Konversationen beginnen | Entfernt einen Benutzer aus einem Kanal. |
| Kanäle | Konversationen gehen | Verlässt einen Kanal. |
| Kanäle | Konversationen Mitglieder | Listet Mitglieds-IDs für einen Kanal auf. |
| Kanäle | Konversationen werden geöffnet | Öffnet eine Direktnachricht oder eine Direktnachricht an mehrere Personen oder setzt sie fort. |
| Kanäle | Konversationen Thema festlegen | Legt das Thema für einen Kanal fest oder aktualisiert es. |
| Kanäle | Konversation einleiten | Ruft Metadaten für einen Kanal anhand der ID ab. |
| Kanäle | Kanäle auflisten | Listet Kanäle auf, die dem Benutzer zur Verfügung stehen. |
| Kanäle | Konversationen für den Benutzer auflisten | Listet Kanäle und Direktnachrichten auf, auf die ein Benutzer zugreifen kann. |
| Reaktionen | Reaktion erzeugen | Fügt einer Nachricht eine Emoji-Reaktion hinzu. |
| Reaktionen | Reaktion löschen | Entfernt eine Emoji-Reaktion aus einer Nachricht. |
| Reaktionen | Reaktionen auflisten | Listet Reaktionen auf eine Nachricht, Datei oder einen Dateikommentar auf. |
| Dateien | Datei hochladen oder erstellen | Lädt Dateien oder Medien auf Kanäle oder Threads hoch. |
| Dateien | Auf externe URL hochladen | Fügt einen Verweis auf eine externe Datei hinzu, die in Slack geteilt werden soll. |
| Dateien | Datei herunterladen | Lädt eine in Slack geteilte Datei herunter. |
| Dateien | Informationen zu Dateien | Ruft Metadaten und Kommentare zu einer Datei ab. |
| Dateien | Liste der Dateien | Listet Dateien in einem Arbeitsbereich mit optionalen Filtern auf. |
| Suchen | Alle durchsuchen | Durchsucht Nachrichten und Dateien im gesamten Workspace. |
| Suchen | Suchen Sie nach Nachrichten | Durchsucht Nachrichten mit Datumsbereichen und Filtern. |
| Suchen | Kanäle durchsuchen | Durchsucht Kanäle nach Namen, Thema oder Zweck. |
| Suchen | Sucht nach Benutzern | Sucht Benutzer nach E-Mail, Namen oder Anzeigenamen. |
| Suchen | Suchkontext | Sucht in Nachrichten, Dateien, Kanälen und Benutzern. Unterstützt die semantische Suche in Workspaces mit Slack AI. |
| Suchen | Suchkonfiguration abrufen | Prüft, ob die semantische Suche im Workspace verfügbar ist. |
| Benutzer | Benutzerdetails erhalten | Ruft Informationen für einen Benutzer anhand der ID ab. |
| Benutzer | Benutzerprofil abrufen | Ruft Profilinformationen für einen Benutzer ab. |
| Benutzer | Benutzerprofilsatz | Aktualisiert die Profilfelder eines Benutzers. |
| Benutzer | Liste der Benutzer | Listet alle Benutzer im Workspace auf. |
| Benutzergruppen | Benutzergruppen: Erstellen | Erstellt eine neue Benutzergruppe. |
| Benutzergruppen | Liste der Benutzergruppen | Listet Benutzergruppen im Workspace auf. |
| Benutzergruppen | Benutzergruppen: Benutzer aktualisieren | Ersetzt alle Mitglieder einer Benutzergruppe. |
| Erinnerungen | Erinnerungen Hinzufügen | Erstellt eine Erinnerung mit dem angegebenen Text und der angegebenen Uhrzeit. |
| Workspace | Holen Sie sich das Team | Ruft Metadaten über den Slack-Workspace ab. |
Anmerkung
Die Aktionen, die du verwenden kannst, hängen von den Bereichen ab, die für deine Slack-App konfiguriert sind, und von den Kanälen, auf die der authentifizierte Benutzer zugreifen kann.
Verwaltung und Problembehebung
Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unterVerwaltung vorhandener Integrationen.
Probleme bei der Authentifizierung
-
Sign-in schlägt fehl (Standard-OAuth-App oder benutzerdefinierte OAuth-App) — Stelle sicher, dass dein Slack-Workspace aktiv ist und dass du dich direkt auf der Slack-Website anmelden kannst.
Vergewissere dich für die benutzerdefinierte OAuth-App, dass die Weiterleitungs-URL in deiner Slack-App mit der Amazon Quick Callback-URL übereinstimmt. -
Ungültige Kundenanmeldedaten (benutzerdefinierte OAuth-App) — Stelle sicher, dass die Client-ID und der geheime Kundenschlüssel mit den Werten im Abschnitt Grundinformationen deiner Slack-App übereinstimmen.
-
Träger-Token abgelehnt — Stelle sicher, dass dein Bot-Token aktiv ist und mit beginnt.
xoxb-Tokens können über das Slack-API-Dashboard gesperrt werden. -
Unzureichende Berechtigungen — Stelle sicher, dass die für deine Slack-App konfigurierten Bereiche die für die Aktionen, die du verwenden möchtest, erforderlichen Berechtigungen enthalten. Siehe Empfohlene Bereiche.
-
Kanal nicht gefunden oder nicht im Kanal — Stelle sicher, dass der Bot dem Kanal hinzugefügt wurde. Laden Sie den Bot in den Kanal ein, bevor Sie versuchen, Nachrichten zu posten oder den Verlauf zu lesen.
