HansaChat

Documentation

Ziņojumi un reakcijas

Lasiet, meklējiet, sūtiet, rediģējiet un dzēsiet ziņojumus, kā arī pievienojiet reakcijas.

Lasīšana

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

--limit pieņem 1–100. Lappušu vietā jūs pārvietojaties pēc kanāla secības numuriem, kuri paliek stabili:

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>

Atbilde ietver meta ar nākamo kursoru (next_before_sequence vai next_after_sequence), lai skripti varētu droši iet cauri vēsturei.

Sūtīšana

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

Vienkāršs teksts automātiski kļūst par darbavietas bagātinātā dokumenta formātu. Tiešai kontrolei varat padot dokumenta JSON:

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

Papildu opcijas: --parent <message-id> atbildei, --mention <user-id> (atkārtojams) cilvēku pieminēšanai un --file <file-id> (atkārtojams) augšupielādētu failu pievienošanai (skatiet Uzaicinājumi un failu augšupielādes).

Sūtīšana apzināti nav idempotenta. Katrs izsaukums izveido jaunu ziņojumu — komandas palaišana divas reizes nosūta divus ziņojumus. Tieši to parasti vēlas skripti, kuri publicē paziņojumus; viss pārējais CLI ved uz vēlamo stāvokli.

Rediģēšana un dzēšana

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

Tāda paša satura rediģēšana otro reizi ir darbība bez izmaiņām, un jau dzēsta ziņojuma dzēšana izdodas bez izmaiņām. Abas gaida, līdz izmaiņa kļūst redzama caur API; pievienojiet --no-wait, lai atgrieztos uzreiz ar pieņemto komandu.

Reakcijas

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

CLI izsauc aizmugursistēmu tikai tad, kad pieprasītā klātbūtne atšķiras no pašreizējā stāvokļa, tāpēc atkārtotas komandas ir drošas.