A csatornaparancsok előbb beolvassák a jelenlegi állapotot, majd a kért állapotra konvergálnak: egy már hatályba lépett parancs megismétlése changed: false értékkel sikeres, ahelyett hogy hibázna vagy duplikálna.
hansa chat channels list # your channels
hansa chat channels browse # public channels you have not joined
hansa chat channels get --channel general # one channel by slug or ID
Csatornák létrehozása és módosítása
# Return "Marketing" and create it only if it does not exist yet
hansa chat channels ensure --name Marketing --type public
# Rename or change the type; a no-op when nothing changes
hansa chat channels set --channel marketing --name Marketing EU --type private
# Archive a channel (idempotent)
hansa chat channels archive --channel marketing
A hivatkozások a backend slugját vagy azonosítóját használják, sosem a megjelenített nevet egyeztetik. Ne feledje, hogy egy csatorna átnevezése megváltoztatja a slugját — szkriptekben azonosítsa a csatornát azonosító alapján, vagy oldja fel újra az átnevezés után.
Tagság
hansa chat channels join --channel general # no-op when already a member
hansa chat channels leave --channel general # no-op when not a member
hansa chat channels members --channel general # list channel members
hansa chat channels invite --channel general --member 42
Közvetlen üzenetek
hansa chat channels dm --member 42
A parancs visszaadja a meglévő közvetlen csatornát az adott felhasználóval, vagy létrehozza azt; a backend ezt a műveletet idempotensként kezeli.
Olvasási állapot
A csatornák és üzenetek olvasása sosem módosítja az olvasottként számított állapotot. Az egyetlen parancs, amely ezt teszi:
hansa chat channels mark-read --channel general
Workspace-tagok
hansa chat members list --query igor # search members by text
hansa chat members get --member 42 # one member by user ID