# Mit deinem KI-Agenten in Slack antworten

> Füge deinen intoCHAT-Agenten zu einem Slack-Workspace hinzu, damit er @Erwähnungen in Channels und Direktnachrichten in Threads beantwortet: Pläne, Verbinden, Threads, Übernahme durch dein Team aus der Inbox, Grenzen und Datenschutz.

Dein Agent kann in **Slack** antworten: Erwähne ihn in einem Channel oder schick ihm eine Direktnachricht, und er antwortet im Thread, mit demselben Wissen, denselben Anweisungen, Aktionen und Regeln wie im Widget. Jeder Slack-Thread ist ein Gespräch im Tab **Conversations** des Agenten, mit dem Badge **Slack**, und dein Team kann es aus der Inbox übernehmen.

> Auf dieser Seite geht es um einen Agenten, der in Slack chattet. Um eine Slack-Nachricht zu bekommen, wenn ein neuer Lead eintrifft oder ein Besucher nach einer Person fragt, nutze stattdessen die [Slack-Benachrichtigungen](/de/docs/lead-alerts-and-export#slack-benachrichtigungen). Beides ist voneinander getrennt und lässt sich zusammen nutzen.

## Plan

Den Slack-Agenten gibt es ab **Starter**. Im Free-Plan zeigt die Karte **Slack** einen Hinweis zum Upgrade, und es lässt sich kein Workspace verbinden. Nach einem Downgrade auf Free bleibt ein verbundener Workspace gespeichert, aber der Agent antwortet dort nicht mehr, und dein Team kann aus intoCHAT nicht in seinen Threads antworten, bis du wieder upgradest.

Jede KI-Antwort in Slack zählt für deinen Plan genau wie im Widget: **eine Nachricht** mit dem Standardmodell, mehrere mit einem [größeren Modell](/de/docs/choose-a-model). Die Antworten deines Teams zählen nicht. Sind deine Nachrichten aufgebraucht, postet der Agent den Hinweis, den auch das Widget zeigt, in den Thread („Message limit reached…“), höchstens einmal alle 10 Minuten pro Thread; ein Agent, der sein [monatliches Limit](/de/docs/limits-and-access) erreicht hat, postet „This chat has reached its limit for now“. Siehe [Pläne und Limits](/de/docs/plans-and-limits).

## Slack verbinden

Du brauchst die Berechtigung, Apps in deinem Slack-Workspace zu installieren. Manche Workspaces lassen neue Apps erst von einem Admin genehmigen.

1. Öffne deinen Agenten, wechsle zum Tab **Share** und such die Karte **Slack**.
2. Klicke auf **Add to Slack**. Der Installationsbildschirm von Slack öffnet sich.
3. Wähle deinen Workspace, falls du zu mehreren gehörst, prüf, was intoCHAT tun darf, und klicke auf **Allow**.
4. Du kommst zurück zum Tab **Share**, der „Slack connected“ und den Namen des Workspace zeigt.

Dann probier es aus:

- **Direktnachricht**: Öffne die intoCHAT-App in Slack (unter **Apps** in der Seitenleiste) und schick ihr eine Frage.
- **Channel**: Lade die App mit `/invite @intochat` in einen Channel ein und erwähne sie dann: `@intochat what are your opening hours?`

Brichst du auf dem Bildschirm von Slack ab, wird nichts verbunden. Brauchst du dort länger als 10 Minuten, fang erneut mit **Add to Slack** an.

Verbinden und Trennen erfordern die Stufe **Manage** für Integrationen, das können also der Owner und Admins. Alle im Konto sehen, welcher Workspace verbunden ist. Siehe [Teammitglieder und Rollen](/de/docs/team).

**Ein Workspace, ein Agent.** Ein Slack-Workspace antwortet jeweils für einen Agenten, und ein Agent hat höchstens einen Workspace. Einen Workspace zu verbinden, der bereits für einen anderen intoCHAT-Agenten antwortet, wird mit „This Slack workspace is already connected to another intoCHAT agent“ abgelehnt; trenne ihn dort zuerst. Geht das nicht, weil dieser Agent zum Konto von jemand anderem gehört, entferne die intoCHAT-App in Slack unter **Manage apps** und klicke dann erneut auf **Add to Slack**: Ein Workspace, dessen App entfernt wurde, ist nicht mehr an den anderen Agenten gebunden. Um einen Agenten in einen anderen Workspace umzuziehen, trenne den ersten.

## Was er beantwortet

- **Direktnachrichten** an die App: jede Nachricht.
- **Channels**: nur Nachrichten, die die App erwähnen (`@intochat …`), in öffentlichen und privaten Channels, in die die App eingeladen wurde. Innerhalb eines Threads erwähnst du sie bei jeder Frage erneut; Nachrichten ohne Erwähnung werden nicht gelesen.
- Nachrichten anderer Apps und Bots, die eigenen Nachrichten der App, bearbeitete und gelöschte Nachrichten sowie eine Nachricht, die nur aus der Erwähnung ohne Frage besteht, bekommen keine Antwort.

Die Erwähnung wird entfernt, bevor der Agent die Nachricht liest. Andere Erwähnungen, Channel-Namen und Links werden als lesbarer Text weitergegeben.

Der Agent schreibt **Text**:

- Antworten nutzen die Formatierung von Slack: Fett, Aufzählungen, Code und anklickbare Links.
- Buttons und Produktkarten aus deinen Aktionen werden als Links unter der Antwort gepostet, [Rich Replies](/de/docs/rich-replies) als reiner Text.
- Formulare, das Lead-Formular, Warenkörbe, Buchungszeiten, Folgefragen und Quellenlinks lassen sich in Slack nicht anzeigen, deshalb bietet der Agent sie dort nicht an. Serverseitige [API-Aktionen](/de/docs/api-actions), [Abläufe](/de/docs/procedures), die [Übergabe per E-Mail](/de/docs/handoff) und Bestellabfragen funktionieren wie im Widget. [Client-seitige Aktionen](/de/docs/client-actions), die auf einer Webseite laufen, werden nicht angeboten.
- Der Agent liest nur den Text einer Nachricht. Dateien und Bilder in Slack-Nachrichten werden ignoriert.

## Threads

Der Agent antwortet immer **in einem Thread**: unter der Nachricht, in der er gefragt wurde, oder in dem Thread, in dem die Frage gestellt wurde.

- **Ein Thread ist ein Gespräch.** Folgefragen im selben Thread beantwortet er mit Blick auf die früheren Nachrichten dieses Threads, wie im Widget. Eine neue Nachricht auf oberster Ebene (eine neue Direktnachricht oder eine neue Erwähnung im Channel) beginnt ein neues Gespräch.
- Wer den Thread begonnen hat, ist der Besucher des Gesprächs; die Inbox zeigt seinen Anzeigenamen in Slack. Schreibt jemand anderes in den Thread, wird seine Nachricht mit seinem Namen davor gespeichert.

## Übergabe und Übernahme durch dein Team

Fragt jemand nach einer Person und ist die [Übergabe per E-Mail](/de/docs/handoff) an, gibt der Agent das Gespräch wie im Widget an dein Team weiter, und das Gespräch kommt in die [Inbox](/de/docs/inbox). Du kannst auch jedes Slack-Gespräch selbst in die Inbox verschieben.

Öffne ein Slack-Gespräch in der Inbox oder im Tab **Conversations**. Unter dem Verlauf:

- Das **Antwortfeld** postet deine Nachricht im Slack-Thread **als intoCHAT-App, mit deinem Vornamen fett davor**, zum Beispiel „**Anna:** Ich habe deine Bestellung erstattet.“ Sie wird mit deinem Namen und „team, Slack“ im Verlauf gespeichert und pausiert die KI.
- **Pause AI** hält den Agenten davon ab, in diesem Thread zu antworten. Neue Nachrichten werden weiterhin gespeichert, sodass dein Team sie sieht, bekommen aber keine KI-Antwort. **Resume AI** gibt ihn zurück.
- Die KI **setzt 24 Stunden** nach der letzten Pause oder Antwort deines Teams **von selbst wieder ein**, bei der nächsten Nachricht im Thread.

Pausieren, Fortsetzen und Antworten dürfen alle, die Gespräche bearbeiten dürfen: der Owner, Admins und Editoren. Slack hat kein Antwortfenster, dein Team kann einen Thread also jederzeit beantworten, solange Slack verbunden ist.

## Grenzen

- Ein Workspace kann dem Agenten bis zu **300 Nachrichten pro Stunde** schicken. Weitere Nachrichten in dieser Stunde werden ohne KI-Antwort für dein Team gespeichert. Die allgemeinen Limits deines Agenten gelten weiterhin.
- Nachrichten werden beantwortet, sobald sie eintreffen, meist innerhalb weniger Sekunden; eine langsame Aktion oder ein [größeres Modell](/de/docs/choose-a-model) kann es verlängern. Lange Antworten werden auf mehrere Nachrichten aufgeteilt.
- Ein [privater Agent](/de/docs/limits-and-access) antwortet nicht in Slack; die Karte **Slack** weist nach der ersten Nachricht darauf hin.
- Wird die App aus dem Workspace entfernt oder ihr Zugriff in Slack widerrufen, zeigt die Karte **Needs attention** mit dem Grund von Slack. Trenne die Verbindung und klicke erneut auf **Add to Slack**.
- Slack-Gespräche zeigen `channel` als `slack` in der [REST API](/de/docs/rest-api), im [MCP-Server](/de/docs/mcp-server), im Kanalfilter der Inbox und in [Gespräche befragen](/de/docs/ask-your-conversations).

## Datenschutz

- intoCHAT liest nur, was Slack schickt: Nachrichten, die die App erwähnen, und Direktnachrichten an die App. Andere Nachrichten in Channels liest es nicht, und es importiert nicht deinen Slack-Verlauf.
- Für jedes Gespräch speichert intoCHAT die Nachrichten, die es beantwortet oder empfangen hat, die Slack-Benutzer-ID der Person, die den Thread begonnen hat, und ihren Anzeigenamen (abgefragt mit `users.info` von Slack). Sie werden wie jedes andere Gespräch aufbewahrt und gelöscht.
- Die Nachrichten gehen an das KI-Modell, das die Antwort schreibt, genau wie Nachrichten aus dem Widget. Siehe [So entstehen Antworten](/de/docs/how-answers-work).
- Das Slack-Token der App wird verschlüsselt gespeichert, nie im Dashboard angezeigt und nur genutzt, um Antworten zu posten und Anzeigenamen abzufragen.
- **Disconnect** in der Karte **Slack** widerruft das Token bei Slack und löscht es. Der Agent antwortet in diesem Workspace nicht mehr; frühere Gespräche bleiben im Tab **Conversations**. Du kannst die App auch in Slack unter **Manage apps** entfernen.

## Für den Plattformbetreiber: die Slack-App

Dieser Abschnitt richtet sich an alle, die den intoCHAT-Server betreiben, nicht an Besitzer von Agenten. Die App wird aus dem Manifest in `integrations/slack/manifest.json` erstellt; `integrations/slack/README.md` beschreibt die Schritte.

**Umgebungsvariablen** (nur Namen; schreib die Werte nie in den Code):

| Variable | Was sie ist |
| --- | --- |
| `SLACK_CLIENT_ID` | Die Client-ID der Slack-App (OAuth) |
| `SLACK_CLIENT_SECRET` | Das Client-Secret: tauscht den Installationscode gegen das Bot-Token |
| `SLACK_SIGNING_SECRET` | Prüft die `X-Slack-Signature` jedes Events, das Slack schickt |
| `TOKEN_ENCRYPTION_KEY` | Verschlüsselt die gespeicherten Tokens (fällt auf `NEXTAUTH_SECRET` zurück) |

Ohne die drei `SLACK_`-Variablen wird die Karte **Slack** nicht angezeigt, und die Events-URL antwortet mit 404. Die OAuth-Redirect-URL wird aus `NEXT_PUBLIC_APP_URL` gebildet und muss mit der in der App übereinstimmen: `https://<your domain>/api/integrations/slack/callback`. Events gehen an `https://<your domain>/api/integrations/slack/events`.

Die App lässt sich über den eigenen Button **Add to Slack** von intoCHAT installieren, sobald in den Einstellungen der App die öffentliche Verteilung eingeschaltet ist. Ein Eintrag im Slack Marketplace und die Prüfung durch Slack dafür sind nicht nötig.
