Bot-Karten & Buttons

Was ein Webhook, ein Slash-Befehl oder ein Bot-Konto postet, muss kein bloßer Text sein. Es kann eine Karte sein, eine strukturierte Nachricht, die man auf einen Blick erfasst, mit Buttons darunter.

Karten

Eine Karte kann haben:

• einen farbigen Rand: blau (Standard), grün, rot, orange, gelb oder lila
• einen Titel (optional als Link), einen Untertitel und eine Beschreibung in Markdown
• Felder: Zeilen mit Bezeichnung und Wert, die Mitglieder mit einem Tipp kopieren
• Bilder: ein Bild oder eine Galerie
• einen Ladezustand: einen Spinner mit deiner eigenen Zeile, etwa "Denke nach…", den du durch das Ergebnis ersetzt, sobald es da ist

Die Antwort auf einen Slash-Befehl kann mehr zeigen: eine Status-Pille wie Open, Merged oder Passing, ein Abzeichen im Kopf, hinzugefügte und entfernte Zeilen und eine Begründung, die hinter einem Umschalter eingeklappt ist. Eine Karte über einen Webhook lässt das weg, und ihr Kopf zeigt immer den eigenen Namen des Webhooks.

Denk an Pull Requests, Deploys und Supporttickets: auf einen Blick erfassbar statt als Textwand.

Buttons

Buttons sitzen unter der Karte. Ihr type entscheidet, was ein Druck bewirkt:

• url:{url} öffnet einen Link.
• webhook_action führt die Schritte aus, die du mit dem Button gespeichert hast: die Karte aktualisieren, sie entfernen, eine Reaktion hinzufügen oder eine Antwort posten. Sie laufen auf dem mssgs-Server, und alle im Kanal sehen das Ergebnis, also braucht "Freigeben" oder "Tor öffnen" keinen eigenen Server.
• trigger:{guid} startet einen der Trigger deiner Community mit den Daten des Buttons, als hätte jemand den Befehl getippt. Die Antwort kommt als neue Karte.

Was zurückkommt

Ein Webhook-Post mit Buttons bekommt eine stream_url zurück, und jede Anfrage eines Slash-Befehls enthält eine: einen Live-Stream der Buttondrücke, Reaktionen und Antworten auf diese Nachricht. Er bleibt 10 Minuten offen (auf Wunsch eine Stunde, bei Webhook-Posts) und hebt nichts für später auf, also verbinde dich sofort. Um die Nachricht danach zu ändern, nimm ihre callback_url, die 30 Minuten lang gilt. Ein Bot-Konto erfährt über den MCP-Server, was mit seinen Karten passiert.

Jedes Kartenfeld, mit einem Live-Kartenbaukasten, steht unter Nachrichtenkarten. Button-Schritte, Ereignisse und Fehler stehen unter Buttons, der Stream und die Callback-URL unter Live-Updates.