HansaChat

Documentation

Wiadomości i reakcje

Czytaj, wyszukuj, wysyłaj, edytuj i usuwaj wiadomości oraz dodawaj reakcje.

Czytanie

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

Opcja --limit przyjmuje wartości 1–100. Zamiast stron nawigujesz numerami sekwencyjnymi kanału, które pozostają stabilne:

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>

Odpowiedź zawiera meta z kolejnym kursorem (next_before_sequence lub next_after_sequence), dzięki czemu skrypty mogą niezawodnie przechodzić przez historię.

Wysyłanie

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

Zwykły tekst jest automatycznie zamieniany na format dokumentu rozszerzonego przestrzeni roboczej. Aby mieć pełną kontrolę, możesz przekazać JSON dokumentu bezpośrednio:

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

Dodatkowe opcje: --parent <message-id> dla odpowiedzi, --mention <user-id> (wielokrotna) do dodawania wzmianek o osobach oraz --file <file-id> (wielokrotna) do załączania przesłanych plików (zobacz zaproszenia i przesyłanie plików).

Wysyłanie celowo nie jest idempotentne. Każde wywołanie tworzy nową wiadomość — dwukrotne wykonanie polecenia wyśle dwie wiadomości. Tego zwykle chcą skrypty publikujące powiadomienia; wszystko inne w CLI doprowadza do żądanego stanu.

Edytowanie i usuwanie

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

Dwukrotna edycja tej samej treści za drugim razem nic nie zmienia, a usunięcie już usuniętej wiadomości kończy się bez zmian. Obie operacje czekają, aż zmiana będzie widoczna przez API; dodaj --no-wait, aby otrzymać wynik natychmiast po przyjęciu polecenia.

Reakcje

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

CLI odwołuje się do backendu tylko wtedy, gdy żądana obecność reakcji różni się od bieżącego stanu, więc powtarzanie poleceń jest bezpieczne.