Mit deinem KI-Agenten in Slack antworten

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.

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. 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 erreicht hat, postet „This chat has reached its limit for now“. Siehe Pläne und 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.

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 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, Abläufe, die Übergabe per E-Mail und Bestellabfragen funktionieren wie im Widget. Client-seitige Aktionen, 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 an, gibt der Agent das Gespräch wie im Widget an dein Team weiter, und das Gespräch kommt in die 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 kann es verlängern. Lange Antworten werden auf mehrere Nachrichten aufgeteilt.
• Ein privater Agent 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, im MCP-Server, im Kanalfilter der Inbox und in Gespräche befragen.

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.
• 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):

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.