Den Chatbot anpassen
Diese Anleitung zeigt dir, wie du die Bot-App beim Anbieter umgestaltest, ohne Control Center zu verlassen.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- Die Rolle
owneroderadminim Arbeitsbereich - Ein verbundener Anbieter. Die Zeile Bot anpassen erscheint erst, wenn der Arbeitsbereich verbunden ist
- Eine App, die Control Center verwalten kann. Bei Slack heißt das, die Verbindung hält ein Refresh-Token der App-Konfiguration (
xoxe-…); fehlt es, sagt die Zeile das und bleibt deaktiviert
Was du ändern kannst
Abschnitt betitelt „Was du ändern kannst“| Feld | Bedeutung | Grenze |
|---|---|---|
| App-Name | Wie der Anbieter die App auflistet | 1–35 Zeichen |
| Bot-Name (was man nach @ tippt) | Was Mitglieder nach @ tippen |
1–80 Zeichen |
| Kurzbeschreibung | Eine Zeile, die der Anbieter zeigt | höchstens 140 Zeichen |
| Was der Bot über seine Fähigkeiten sagt | Steht über einer DM mit dem Bot | höchstens 300 Zeichen |
| Slash-Befehl | Der Befehl, den Mitglieder aufrufen, ohne den Schrägstrich | kleingeschrieben, nur a–z 0–9 _ -, bei 32 Zeichen abgeschnitten |
| Direktnachrichten | Ob der Bot die DM- und Agenten-Erfahrung anbietet | An oder aus |
Control Center prüft die vier Textfelder, bevor es den Anbieter aufruft, deshalb bekommst du “the app name must be between 1 and 35 characters” statt eines undurchsichtigen invalid_manifest von einem Server, den du nicht siehst. Der Befehl wird nicht abgelehnt, sondern normalisiert: Ein führender Schrägstrich wird entfernt, der Rest wird kleingeschrieben, alles außerhalb von a–z 0–9 _ - wird gestrichen, und ein leeres Ergebnis fällt auf cc zurück.
Den Bot bearbeiten
Abschnitt betitelt „Den Bot bearbeiten“- Geh zu Einstellungen → Arbeitsbereich → Allgemein und weiter zur Karte Chat-Brücken
- Klicke im Block des Anbieters auf Bot anpassen
- Der Dialog öffnet sich mit den aktuellen Werten der App, zurückgelesen vom Anbieter — eine Änderung, die jemand in der eigenen Oberfläche von Slack gemacht hat, ist das, womit du anfängst
- Bearbeite, was du brauchst, und speichere
Diese aktuellen Werte zu lesen kostet bei Slack eine Token-Rotation. Deshalb ist die Zeile ein bewusster Klick und nichts, was die Seite beim Laden von selbst tut.
Der Schreibvorgang legt deine Änderungen über die aktuelle Definition der App. Was Control Center nicht modelliert — ein zweiter Slash-Befehl, den du in Slack ergänzt hast, ein Workflow-Schritt, eine Einstellung, die nichts damit zu tun hat — bleibt unangetastet. Scopes und Ereignisse werden zusammengeführt, nie abgezogen.
Nach dem Speichern liest Control Center die Identität des Bots neu, damit der Name in den Einstellungen zum Namen in der Chat-App passt.
Neu installieren, wenn sich Berechtigungen ändern
Abschnitt betitelt „Neu installieren, wenn sich Berechtigungen ändern“Ändert ein Speichern die Berechtigungen, bleibt der Dialog offen und sagt „Slack hat die Berechtigungen der App geändert. Installiere die App neu, damit sie wirksam werden.“, mit der Schaltfläche App neu installieren. Die öffnet die Seite von Slack, auf der diese App im Team installiert wird. In Slack heißt das Install App → Reinstall to Workspace.
Den Slash-Befehl umbenennen
Abschnitt betitelt „Den Slash-Befehl umbenennen“Ändere Slash-Befehl und speichere. Die Brücke schreibt Anweisungen danach mit dem Befehl, mit dem sie zuletzt aufgerufen wurde, sodass Hilfetext und Verknüpfungsanweisungen der Umbenennung folgen, statt einen Befehl zu nennen, den es nicht mehr gibt.
Das Umbenennen bricht bestehende Threads der Brücke nicht: Threads sind an die Unterhaltung gebunden, nicht an den Befehl.
Was Control Center nicht ändert
Abschnitt betitelt „Was Control Center nicht ändert“- Strukturelle Einstellungen. Der Transport (Socket Mode), die erforderlichen Scopes und die Ereignisabonnements werden durchgesetzt, nicht angeboten. Eine App, die sich von einem Einstellungsbildschirm aus stumm schalten lässt, ist ein Fall für den Support, keine Funktion
- Das Bot-Symbol. Ändern kann es nur die eigene App-Einstellung des Anbieters, und der Dialog sagt das
- Die Feature-Migrationen des Anbieters. Eine App, die schon auf der alten Assistant-Form von Slack liegt, bleibt dort; dieser Dialog bearbeitet eine Beschreibung und migriert die App nicht
Fehlersuche
Abschnitt betitelt „Fehlersuche“Die Zeile Bot anpassen fehlt ganz
Abschnitt betitelt „Die Zeile Bot anpassen fehlt ganz“Der Arbeitsbereich ist noch nicht verbunden. Die Zeile erscheint erst, wenn der Block des Anbieters eine aktive Verbindung zeigt. Siehe Slack-Integration einrichten.
Die Zeile Bot anpassen ist deaktiviert
Abschnitt betitelt „Die Zeile Bot anpassen ist deaktiviert“Die Verbindung hat keine Zugangsdaten zur App-Verwaltung. Der Untertitel der Zeile sagt „Control Center braucht ein App-Konfigurationstoken, um den Bot zu bearbeiten. Verbinde neu und gib eines mit an.“ Für Slack erzeugst du auf api.slack.com/apps ein Paar App-Konfigurationstoken und verbindest neu, mit ausgefülltem Refresh-Token. Das ist bei einer von Hand gebauten App oder einer App über In Slack erstellen zu erwarten, weil Slack nie meldet, welche App erstellt wurde.
“Control Center does not know which app to edit”
Abschnitt betitelt „“Control Center does not know which app to edit”“Die gespeicherte Verbindung trägt keine App-ID, typischerweise bei einer App, die von Hand verbunden wurde, bevor eine ID festgehalten wurde. Verbinde den Arbeitsbereich neu, oder lege die App aus Control Center an.
Der neue Name des Bots erscheint im Chat nicht
Abschnitt betitelt „Der neue Name des Bots erscheint im Chat nicht“Anbieter cachen die App-Metadaten kurz. Ist der Name nach einer Minute immer noch veraltet, prüfe, ob dich das Speichern gebeten hat, die App neu zu installieren.