Integration mit Slack

Mit der Slack-Integration für awork kannst du Projektaktualisierungen in Slack-Kanälen veröffentlichen, Aufgaben erstellen und Zeiten erfassen. Zusätzlich kannst du Slack als Konnektor mit awork Agents verbinden, damit sie Slack-Nachrichten suchen, Verläufe lesen und freigegebene Aktionen ausführen können.

Die Projektverknüpfung und der Agent-Konnektor werden getrennt eingerichtet. Wähle die Einrichtung passend zu deinem Anwendungsfall.

Slack mit awork Agents verwenden

Über den Slack-Konnektor kann ein Agent Informationen aus Slack für deine Arbeit in awork verwenden. Welche Daten und Aktionen verfügbar sind, hängt von den erteilten Scopes, den aktivierten Tools und den Berechtigungen des verbundenen Slack-Kontos ab.

• Nachrichten und Informationen finden: Nachrichten, Dateien, Personen und Channels durchsuchen.
• Unterhaltungen lesen: Zugängliche Channel- und Thread-Verläufe lesen und zusammenfassen.
• Aktionen ausführen: Nachrichten senden oder entwerfen, Conversations erstellen, Reaktionen hinzufügen, Canvases und Lists verwalten sowie Dateien hochladen, sofern die erforderlichen Berechtigungen erteilt wurden.

Slack als Agent-Konnektor einrichten

1. Öffne die AI Library und wähle Konnektoren.
2. Wähle einen vorhandenen Slack-Konnektor aus oder füge Slack über + Konnektor aus dem Katalog hinzu.
3. Vervollständige die angezeigten Konnektor-Einstellungen und füge eine Verbindung hinzu. Melde dich bei Slack an und prüfe die angeforderten Berechtigungen. Falls OAuth Client ID und Client Secret angefordert werden, folge der Slack-Konfiguration im Konnektoren-Katalog.
4. Füge den Konnektor in der Konfiguration deines Agents hinzu. Das Hinzufügen des Konnektors allein erstellt noch keine authentifizierte Verbindung. Weitere Informationen findest du unter Eigene AI-Agents erstellen.
5. Starte den Agenten in awork und beschreibe, welche Slack-Informationen er verwenden oder welche Aktion er ausführen soll.

Eine Verbindung erweitert nicht automatisch deine Zugriffsrechte. Ein Agent kann nur die Slack-Daten und Aktionen verwenden, die die verwendete Verbindung und deine Berechtigungen erlauben. Das Teilen eines Agents gibt anderen Personen nicht automatisch Zugriff auf dein Slack-Konto.

Beispiele für Anfragen an den Agenten

• „Fasse die Diskussion der letzten Woche im Channel #projekt-alpha zusammen und nenne die offenen Fragen.“
• „Suche nach Nachrichten zum Freigabetermin für Projekt Alpha und verlinke die relevanten Fundstellen.“
• „Entwirf ein Projektupdate für #projekt-alpha auf Basis unserer aktuellen awork-Aufgaben.“

Für diese Nutzung muss kein Slack-Kanal mit einem awork-Projekt verknüpft sein. Die folgenden Abschnitte beschreiben die separate Einrichtung für Projektupdates, Aufgabenaktionen und Zeiterfassung in Slack.

---

Hauptvorteile und Anwendungsfälle

Bringe deine Projektarbeit näher an den Ort, an dem die Kommunikation stattfindet:

• Veröffentliche Projektaktualisierungen in Slack-Kanälen, wenn Ereignisse in einem verknüpften awork-Projekt stattfinden
• Erstelle Aufgaben direkt aus Slack in dem Projekt, das mit dem Kanal verknüpft ist
• Bearbeite Aufgaben aus Slack-Benachrichtigungen über Schaltflächen in der Aufgaben-Nachricht
• Erfasse Zeiten aus Slack heraus mit Slash Commands
• Erhalte awork-Benachrichtigungen in Slack über die awork-App innerhalb von Slack
• Nutze Slack mit awork Agents, um Nachrichten zu suchen, Channel- und Thread-Verläufe zu lesen und freigegebene Slack-Aktionen auszuführen

---

So funktioniert die Integration für Slack

Die Slack-Integration einrichten

1. Gehe zu den Einstellungen (Zahnradsymbol links unten im Hauptmenü) > Integrationen
2. Öffne die Integrationsbibliothek und wähle Slack
3. Gib in Slack den Namen deines Slack-Workspaces ein und erlaube den Zugriff
4. Du wirst automatisch zurück zu deinem awork-Workspace weitergeleitet

Dein Slack-Konto mit deinem awork-Konto verknüpfen

Projektaktualisierungen können auch ohne Account Matching an Slack gesendet werden. Wenn du jedoch aus Slack heraus mit awork interagieren möchtest, musst du deine Konten verknüpfen.

• Interagiere zum ersten Mal mit der Integration in Slack und folge der Aufforderung zur Kontoverknüpfung
• Oder gib in Slack /connect ein, um dein Slack-Konto mit deinem awork-Konto zu verbinden

---

Ein awork-Projekt mit einem Slack-Kanal verknüpfen

Wenn ein Projekt mit einem Slack-Kanal verknüpft ist, kann awork Projektereignisse und Aktualisierungen (zum Beispiel Statusänderungen von Aufgaben) in diesem Kanal veröffentlichen. Außerdem kannst du Aufgaben für das Projekt direkt aus dem Slack-Kanal erstellen.

Die Verknüpfung zwischen Projekt und Slack-Kanal einrichten

1. Öffne die Projektdetails

2. Klicke auf die Aktionsschaltfläche des Projekts und wähle Mit Slack verknüpfen

3. Wähle den Slack-Kanal aus, in dem Nachrichten veröffentlicht werden sollen

4. Lege fest, welche Ereignisse im Slack-Kanal veröffentlicht werden sollen

Der verknüpfte Slack-Kanal wird in den Projektdetails angezeigt.

Einen geschlossenen Slack-Kanal verknüpfen

Geschlossene Slack-Kanäle können nur direkt innerhalb des jeweiligen Kanals verknüpft werden.

1. Öffne den geschlossenen Slack-Kanal, den du verknüpfen möchtest

2. Lade den awork-Bot ein, indem du @awork in den Kanal schreibst, und bestätige die Einladung

3. Gib /link ein, um die Projektauswahl zu öffnen

4. Wähle das awork-Projekt aus, das mit dem Kanal verknüpft werden soll

Um die Verknüpfung eines geschlossenen Kanals wieder zu entfernen, verwende /unlink. Die Benachrichtigungseinstellungen können im awork-Projekt konfiguriert werden.

---

Aufgaben aus Slack bearbeiten

Wenn eine Aufgabenbenachrichtigung in Slack erscheint, kannst du die Aufgabe direkt aus Slack bearbeiten. Über die Schaltflächen unter der Aufgaben-Nachricht kannst du:

• Den Status ändern
• Eine Person zuweisen
• Ein Fälligkeitsdatum festlegen
• Einen Kommentar zur Aufgabe hinzufügen

---

Aufgaben erstellen und Zeiten aus Slack erfassen (Slash Commands)

Um Aktionen in awork direkt aus Slack auszuführen, stehen folgende Slash Commands zur Verfügung:

• /add [Aufgabe] erstellt eine neue Aufgabe im awork-Projekt
• /comment [Aufgabe]:[Text] erstellt einen Kommentar zur angegebenen Aufgabe
• /connect verbindet dein Slack-Konto mit deinem awork-Konto
• /disconnect trennt die Verbindung zwischen deinem Slack- und awork-Konto
• /link [Projekt] verknüpft ein awork-Projekt mit dem aktuellen Slack-Kanal
• /start [Aufgabe/Projekt] startet die Zeiterfassung für eine Aufgabe oder ein Projekt
• /stop beendet die laufende Zeiterfassung
• /unlink entfernt die Verknüpfung zwischen awork-Projekt und Slack-Kanal

Beispiel: Veröffentliche /add Logo-Design erstellen in Slack, um eine Aufgabe mit dem Namen Logo-Design erstellen im verknüpften Projekt anzulegen.

---

awork-Benachrichtigungen in Slack erhalten

Nachdem du dein Slack-Konto mit deinem awork-Konto verknüpft hast, findest du awork in Slack unter Apps. Deine awork-Benachrichtigungen können dort angezeigt werden, sobald du dies in awork konfigurierst.

Du kannst dort außerdem alle /-Befehle verwenden, private Aufgaben erstellen oder die Zeiterfassung starten.

---

FAQ

Kann ein awork Agent Slack-Nachrichten lesen?

Ja. Wenn du den Slack-Konnektor mit einer authentifizierten Verbindung eingerichtet und dem Agenten hinzugefügt hast, kann er zugängliche Nachrichten und Channel- oder Thread-Verläufe lesen. Der Zugriff richtet sich nach den erteilten Scopes und den Berechtigungen des verbundenen Kontos. Die optionale Echtzeitsuche erfordert zusätzlich deine persönliche Autorisierung der angeforderten Benutzer-Token-Scopes in Slack.

Muss ein Slack-Kanal für den Agenten mit einem awork-Projekt verknüpft sein?

Nein. Der Agent-Konnektor und die Verknüpfung eines Projekts mit einem Slack-Kanal sind separate Funktionen. Die Projektverknüpfung dient Projektupdates und Aufgabenaktionen im verknüpften Kanal.

Welche Aktionen kann ein Agent in Slack ausführen?

Abhängig von den erteilten Scopes und aktivierten Tools kann ein Agent Informationen suchen und lesen, Nachrichten senden oder entwerfen, Conversations erstellen, Reaktionen hinzufügen, Canvases und Lists verwalten sowie Dateien hochladen. Er kann nur Aktionen ausführen, die die verwendete Verbindung und die Slack-Berechtigungen erlauben.

Wie richte ich die Slack-Integration ein?

Gehe zu Einstellungen > Integrationen, öffne die Integrationsbibliothek, wähle Slack aus und gib anschließend den Namen deines Slack-Workspaces ein. Erlaube den Zugriff, wenn du zu Slack weitergeleitet wirst.

Wie verknüpfe ich mein Slack-Konto mit meinem awork-Konto?

Du wirst dazu aufgefordert, wenn du zum ersten Mal mit der Integration in Slack interagierst. Alternativ kannst du in Slack /connect eingeben.

Warum werden awork-Nachrichten in Slack in einer bestimmten Sprache angezeigt?

Nachrichten von awork werden in der Sprache der Person versendet, die die Verknüpfung erstellt hat.

Kann ich mehrere Slack-Kanäle mit einem awork-Projekt verknüpfen (oder einen Kanal mit mehreren Projekten)?

Nein. Jeder Slack-Kanal kann nur mit einem awork-Projekt verknüpft werden und pro Projekt kann nur ein Slack-Kanal verknüpft werden.

Wie verknüpfe ich einen geschlossenen Slack-Kanal?

Öffne den geschlossenen Kanal in Slack, lade den Bot mit @awork ein und bestätige die Einladung. Verwende anschließend /link, um das Projekt auszuwählen. Zum Trennen der Verbindung verwende /unlink.