HansaChat

Documentation

Nachrichten und Reaktionen

Nachrichten lesen, suchen, senden, bearbeiten, löschen und Reaktionen setzen.

Lesen

hansa chat messages list --channel general --limit 50
hansa chat messages get --message <nachrichten-id>
hansa chat messages search --query "standup notes" --channel general

--limit akzeptiert 1–100. Statt Seiten navigieren Sie über stabile Kanal-Sequenznummern:

hansa chat messages list --channel general --before-sequence 120
hansa chat messages list --channel general --after-sequence 100
hansa chat messages list --channel general --around-message <nachrichten-id>

Die Antwort enthält meta mit dem nächsten Cursor (next_before_sequence oder next_after_sequence), damit Skripte den Verlauf zuverlässig durchlaufen können.

Senden

hansa chat messages send --channel general --text "Deployment fertig."

Klartext wird automatisch in das Rich-Text-Dokumentformat des Workspaces umgewandelt. Für volle Kontrolle übergeben Sie das Dokument-JSON direkt:

hansa chat messages send --channel general --content-json '{"type":"doc","content":[…]}'
hansa chat messages send --channel general --content-file nachricht.json

Weitere Optionen: --parent <nachrichten-id> für eine Antwort, --mention <benutzer-id> (wiederholbar) zum Erwähnen von Personen und --file <datei-id> (wiederholbar) für hochgeladene Dateien (siehe Einladungen und Datei-Uploads).

Das Senden ist bewusst nicht idempotent. Jeder Aufruf erzeugt eine neue Nachricht — der Befehl zweimal ausgeführt sendet zwei Nachrichten. Genau das wollen Skripte, die Benachrichtigungen posten; alles andere in der CLI führt zum angeforderten Zustand.

Bearbeiten und Löschen

hansa chat messages edit --message <id> --text "Deployment erfolgreich."
hansa chat messages delete --message <id>

Doppelt gleiches Bearbeiten ist beim zweiten Mal ein No-Op, und das Löschen einer bereits gelöschten Nachricht bleibt erfolgreich ohne weitere Änderung. Beide warten, bis die Änderung über die API sichtbar ist; mit --no-wait kehren Sie sofort mit dem angenommenen Befehl zurück.

Reaktionen

hansa chat reactions set --message <id> --emoji "👍" --present=true
hansa chat reactions set --message <id> --emoji "👍" --present=false

Die CLI ruft das Backend nur auf, wenn die gewünschte Anwesenheit vom aktuellen Zustand abweicht — wiederholte Befehle sind also sicher.