Zum Hauptinhalt springen

Slack-Integration - Einrichtungsanleitung

Verbinde dein Slack-Konto mit Goodweek, um Nachrichten zu senden, Unterhaltungen zu lesen und Kanäle direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Slack-Konto mit Goodweek, um Nachrichten zu senden, Unterhaltungen zu lesen und Kanäle direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die dem Benutzer in Slack gewährten Zugriffsebenen und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Benutzers variieren.

📋 Voraussetzungen

Bevor ein Benutzer die Slack-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek Admin-Panel unter dem Tab Integrationen aktivieren.

Admin-Einrichtung

Die Slack-Integration nutzt OAuth 2.0. In den meisten Workspaces kann sich jedes Mitglied direkt verbinden. Wenn in deinem Slack-Workspace jedoch die App-Genehmigung aktiviert ist, muss zunächst ein Workspace-Owner oder App-Manager Composio genehmigen.

Szenario 1 — Standard (keine App-Genehmigung erforderlich)

Jeder Benutzer kann sein Slack-Konto direkt verbinden. Folge den unten stehenden Schritten zur Benutzerverbindung.

Szenario 2 — Die App-Genehmigung ist aktiviert

Wenn in deinem Workspace „Require App Approval" (App-Genehmigung erforderlich) aktiviert ist, muss zunächst ein Workspace-Owner oder App-Manager Composio genehmigen:

  1. Klicke in Slack auf den Namen deines Workspace → Tools & Einstellungen → Apps verwalten → Einstellungen für App-Verwaltung.

  2. Suche in den ausstehenden App-Anfragen nach Composio oder füge es manuell hinzu, und genehmige es.

Falls Composio noch nicht in den ausstehenden Anfragen erscheint, muss ein Benutzer zunächst versuchen, sich von Goodweek aus zu verbinden — dadurch wird eine Installationsanfrage generiert, die der Administrator anschließend genehmigen kann. Nicht-administrative Benutzer sehen ihre Anfrage bis zum Handeln des Administrators im Status „Anfrage gesendet".

Szenario 3 — Enterprise Grid-Workspaces

In Slack Enterprise Grid-Organisationen werden App-Verwaltungsrichtlinien von Org-Ownern auf Organisationsebene festgelegt. Wenn deine Organisation eine App-Genehmigungsrichtlinie hat, muss der Org-Owner Composio auf Organisationsebene genehmigen:

  1. Klicke auf den Namen deines Workspace → Einstellungen & Verwaltung → Organisationseinstellungen.

  2. Gehe zum Tab Einstellungen → Organisationsrichtlinien → Apps und genehmige die Composio-App-Anfrage.

⚠️ Enterprise Grid-Plananforderung für einige Tools

Bestimmte Slack-Tools auf Administratorebene (Workspace-Verwaltung, erweiterte Konversationsverwaltung) erfordern einen Enterprise Grid-Plan. Wenn du einen Free-, Pro- oder Business+-Plan hast, stehen diese spezifischen Tools nicht zur Verfügung, aber die Standard-Tools für Nachrichten und Kanäle funktionieren normal.

Benutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Slack und klicke auf Verbinden.

  3. Du wirst zu Slack weitergeleitet, wo du dich anmelden und den Zugriff autorisieren musst.

  4. Wähle den Workspace, den du verbinden möchtest, und klicke auf Zulassen, um zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Benutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf Kanäle und Unterhaltungen zugreifen, in denen dein individuelles Benutzerkonto Mitglied ist. Private Kanäle, zu denen du nicht eingeladen wurdest, sind nicht zugänglich.

  • Wenn du mehreren Slack-Workspaces angehörst, musst du jeden Workspace separat verbinden.

  • Du kannst den Zugriff von Goodweek jederzeit über deinen Slack-Workspace → Apps → Composio → App entfernen widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

Nachricht senden

Postet eine Nachricht in einem Slack-Kanal, einer DM oder einer privaten Gruppe.

Schreiben

Temporäre Nachricht senden

Sendet eine Nachricht, die nur für einen bestimmten Benutzer in einem Kanal sichtbar ist — andere Mitglieder können sie nicht sehen.

Schreiben

Nachricht planen

Plant eine Nachricht an einen Slack-Kanal oder eine DM für einen zukünftigen Zeitpunkt.

Lesen

Slack-Nachricht aktualisieren

Aktualisiert eine bestehende Slack-Nachricht anhand ihres Zeitstempels.

Lesen

Auf Thread antworten

Postet eine Nachricht als Antwort innerhalb eines bestehenden Threads.

Schreiben

Unterhaltungsverlauf abrufen

Ruft eine chronologische Liste der Nachrichten und Ereignisse einer bestimmten Slack-Unterhaltung ab.

Lesen

Unterhaltungsantworten abrufen

Ruft Antworten auf eine bestimmte übergeordnete Nachricht in einer Slack-Unterhaltung ab.

Lesen

Nachrichten suchen

Durchsucht Nachrichten im gesamten Workspace mit Datumsbereichen und Filtern wie in:#kanal oder from:@benutzer.

Lesen

Echtzeitsuche

Durchsucht Slack-Nachrichten, Dateien, Kanäle und Benutzer über die Echtzeitsuche-API.

Lesen

Ungelesene Nachrichten eines Benutzers abrufen

Ruft ungelesene Direktnachrichten eines bestimmten Benutzers ab.

Lesen

Ungelesene Kanalnachrichten auflisten

Listet alle ungelesenen Nachrichten in einem angegebenen Slack-Kanal für den authentifizierten Benutzer auf.

Lesen

Alle Kanäle auflisten

Listet die für den Benutzer verfügbaren Unterhaltungen mit verschiedenen Filtern auf.

Lesen

Unterhaltungsinformationen abrufen

Ruft Metadaten für eine Slack-Unterhaltung anhand ihrer ID ab (Name, Zweck, Erstellungsdatum usw.).

Lesen

Kanäle finden

Findet Kanäle in einem Slack-Workspace nach Name, Thema, Zweck oder Beschreibung.

Lesen

Unterhaltungsmitglieder abrufen

Ruft eine paginierte Liste der aktiven Mitglieds-IDs für einen angegebenen Kanal ab.

Lesen

Kanal erstellen

Erstellt einen neuen öffentlichen oder privaten Slack-Kanal.

Schreiben

Benutzer in Kanal einladen

Lädt Benutzer anhand ihrer Slack-Benutzer-IDs in einen bestehenden Slack-Kanal ein.

Schreiben

Reaktion zu Nachricht hinzufügen

Fügt einer bestehenden Nachricht in einem Slack-Kanal eine Emoji-Reaktion hinzu.

Schreiben

Reaktion von Element entfernen

Entfernt eine Emoji-Reaktion von einer Nachricht, Datei oder einem Dateikommentar.

⚠️ Destruktiv

Datei in Slack hochladen oder erstellen

Lädt Dateien, Bilder oder Dokumente in Slack-Kanäle oder -Threads hoch.

Schreiben

Slack-Dateien auflisten

Listet Dateien und ihre Metadaten innerhalb eines Slack-Workspace auf, filterbar nach Benutzer, Kanal oder Typ.

Lesen

Slack-Datei herunterladen

Lädt den Inhalt einer Slack-Datei herunter und wandelt ihn in eine öffentlich zugängliche URL um.

Lesen

Slack Canvas erstellen

Erstellt ein neues Slack Canvas mit einem angegebenen Titel und optionalem Inhalt.

Schreiben

Slack Canvas bearbeiten

Bearbeitet ein Slack Canvas mit detaillierter Kontrolle über die Platzierung des Inhalts (ersetzen, einfügen usw.).

Lesen

Benutzer finden

Findet Benutzer in einem Slack-Workspace anhand von E-Mail, Name, Anzeigename oder anderem Text.

Lesen

Detaillierte Benutzerinformationen abrufen

Ruft umfassende Informationen für eine gültige Slack-Benutzer-ID ab.

Lesen

Benutzerprofilinformationen abrufen

Ruft Profilinformationen für einen angegebenen Slack-Benutzer ab.

Lesen

Alle Benutzer auflisten

Ruft eine paginierte Liste aller Benutzer mit Profildetails und Teamzugehörigkeiten in einem Workspace ab.

Lesen

Benutzerstatus festlegen

Legt manuell den Slack-Status eines Benutzers fest (aktiv/abwesend).

Lesen

Nicht-stören-Dauer festlegen

Aktiviert den Nicht-stören-Modus für den aktuellen Benutzer oder ändert dessen Dauer.

Lesen

Erinnerung erstellen

Erstellt eine Slack-Erinnerung mit angegebenem Text und Zeitpunkt in natürlicher Sprache oder als Zeitstempel.

Schreiben

Erinnerungen auflisten

Listet alle Erinnerungen des authentifizierten Slack-Benutzers auf.

Lesen

Slack-Liste erstellen

Erstellt eine neue Slack-Liste mit einem Namen und optionaler Beschreibung.

Schreiben

Slack-Listenelement erstellen

Erstellt ein neues Element (Zeile) in einer Slack-Liste.

Schreiben

Slack-Listenelement aktualisieren

Aktualisiert eine oder mehrere Zellen einer bestehenden Zeile in einer Slack-Liste.

Schreiben

Öffentlichen oder privaten Kanal löschen

Löscht einen Kanal einschließlich aller Nachrichten und Dateien dauerhaft. Diese Aktion ist unumkehrbar.

⚠️ Destruktiv

Benutzer aus Unterhaltung entfernen

Entfernt einen angegebenen Benutzer aus einem Slack-Kanal.

⚠️ Destruktiv

Datei anhand der ID löschen

Löscht eine bestehende Datei aus einem Slack-Workspace dauerhaft. Diese Aktion ist unumkehrbar.

⚠️ Destruktiv

Anwendungsfälle

  • Nachrichten von Goodweek aus senden und verwalten. Poste Nachrichten in Kanälen, antworte auf Threads oder sende Direktnachrichten, ohne zu Slack zu wechseln — und behalte die Kommunikation im Kontext deiner Arbeit.

  • Nachrichten und Dateien suchen und abrufen. Finde bestimmte Unterhaltungen, Nachrichten oder Dateien in deinem Slack-Workspace direkt aus einer Goodweek-Unterhaltung heraus, ohne manuell durch Kanäle zu scrollen.

  • Kanalmitgliedschaft und -struktur verwalten. Erstelle Kanäle, lade Benutzer ein und verwalte Kanaleinstellungen direkt aus Goodweek heraus, wenn du neue Projekte oder Teams einrichtest.

  • Slack Canvases und Listen erstellen und aktualisieren. Erstelle strukturierte Slack Canvases oder verwalte Listenelemente aus Goodweek heraus, um das Teamwissen und die Aufgabenverfolgung aktuell zu halten.


Fehlerbehebung

Meine Verbindungsanfrage bleibt bei „Anfrage gesendet" hängen

In deinem Slack-Workspace ist die App-Genehmigung aktiviert, und ein Workspace-Owner oder App-Manager hat Composio noch nicht genehmigt. Wende dich an deinen Slack-Administrator und bitte ihn, die Composio-App zu genehmigen.

Der Administrator hat Composio genehmigt, aber Benutzer können sich weiterhin nicht verbinden

In Enterprise Grid-Organisationen reicht eine Genehmigung auf Workspace-Ebene möglicherweise nicht aus. Der Org-Owner muss Composio dann möglicherweise auf Organisationsebene gemäß Szenario 3 oben genehmigen.

Verbindung erfolgreich, aber bestimmte Tools funktionieren nicht

Einige erweiterte Slack-Tools erfordern einen Enterprise Grid-Plan. Bei einem niedrigeren Plan funktionieren diese Tools nicht. Die Standard-Tools für Nachrichten und Kanäle sollten normal funktionieren.

Die Integration ist in Goodweek nicht sichtbar

Stelle sicher, dass der Administrator deiner Organisation die Slack-Integration im Goodweek Admin-Panel unter dem Tab Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?