HansaChat

Documentation

Üzenetek és reakciók

Üzenetek olvasása, keresése, küldése, szerkesztése, törlése és reakciók kezelése.

Olvasás

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

A --limit 1–100 közötti értéket fogad el. Oldalak helyett a csatorna sorszámaival navigálhat, amelyek stabilak maradnak:

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 <message-id>

A válasz tartalmazza a meta mezőt a következő kurzorral (next_before_sequence vagy next_after_sequence), így a szkriptek megbízhatóan bejárhatják az előzményeket.

Küldés

hansa chat messages send --channel general --text "Deploy finished."

Az egyszerű szöveg automatikusan a workspace rich dokumentumformátumává alakul. Teljes körű irányításhoz közvetlenül is átadhatja a dokumentum JSON-át:

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

További kapcsolók: --parent <message-id> válaszhoz, --mention <user-id> (ismételhető) személyek megemlítéséhez, valamint --file <file-id> (ismételhető) feltöltött fájlok csatolásához (lásd a meghívókról és fájlfeltöltésekről szóló útmutatót).

A küldés szándékosan nem idempotens. Minden meghívás új üzenetet hoz létre — a parancs kétszeri futtatása két üzenetet küld. Ez általában pontosan azt jelenti, amire az értesítéseket küldő szkripteknek szükségük van; a CLI minden más eleme a kívánt állapotra konvergál.

Szerkesztés és törlés

hansa chat messages edit --message <id> --text "Deploy finished successfully."
hansa chat messages delete --message <id>

Ugyanazon tartalom kétszeri szerkesztése a második alkalommal nem végez módosítást, és egy már törölt üzenet törlése változatlanul sikeres. Mindkettő megvárja, amíg a módosítás az API-n keresztül láthatóvá válik; a --no-wait kapcsolóval a parancs az elfogadott paranccsal azonnal visszatér.

Reakciók

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

A CLI csak akkor hívja a backendet, ha a kért jelenlét eltér a jelenlegi állapottól, így a parancsok megismétlése biztonságos.