HansaChat

Documentation

Sõnumid ja reaktsioonid

Lugege, otsige, saatke, muutke ja kustutage sõnumeid ning avaldage reaktsioone.

Lugemine

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 aktsepteerib väärtusi 1–100. Lehtede asemel liigute kanali järjestusnumbrite järgi, mis jäävad stabiilseks:

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>

Vastus sisaldab meta koos järgmise kursoriga (next_before_sequence või next_after_sequence), nii et skriptid saavad ajalugu usaldusväärselt läbi käia.

Saatmine

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

Lihttekst muudetakse automaatselt tööruumi rikaste dokumentide vormingusse. Tooret juhtimiseks saate dokumendi JSON-i otse edastada:

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

Lisasuvandid: --parent <message-id> vastuse jaoks, --mention <user-id> (korduv) inimeste mainimiseks ja --file <file-id> (korduv) üleslaaditud failide manustamiseks (vt kutsed ja failide üleslaadimine).

Saatmine on teadlikult mitte-idempotentne. Iga käivitamine loob uue sõnumi — käsu kahekordne käivitamine saadab kaks sõnumit. See on täpselt see, mida teavitusi postitavad skriptid tavaliselt tahavad; kõik muu CLI-s läheneb soovitud olekule.

Muutmine ja kustutamine

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

Sama sisu kahekordne muutmine on teisel korral toimetu ja juba kustutatud sõnumi kustutamine õnnestub muutumatuna. Mõlemad ootavad, kuni muudatus on API kaudu nähtav; lisage --no-wait, et kohe tagasi pöörduda vastuvõetud käsuga.

Reaktsioonid

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

CLI pöördub taustsüsteemi poole ainult siis, kui soovitud olemasolu erineb praegusest olekust, nii et korduvad käsud on ohutud.