HansaChat

Documentation

Messages et réactions

Lisez, recherchez, envoyez, modifiez et supprimez des messages, et réagissez à ceux-ci.

Lecture

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 accepte de 1 à 100. Au lieu des pages, vous naviguez par numéros de séquence de canal, qui restent stables :

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>

La réponse inclut meta avec le curseur suivant (next_before_sequence ou next_after_sequence) afin que les scripts puissent parcourir l’historique de manière fiable.

Envoi

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

Le texte brut devient automatiquement le format de document enrichi de l’espace de travail. Pour un contrôle total, vous pouvez passer le JSON du document directement :

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

Options supplémentaires : --parent <message-id> pour une réponse, --mention <user-id> (répétable) pour mentionner des personnes et --file <file-id> (répétable) pour joindre des fichiers téléversés (voir Invitations et téléversement de fichiers).

L’envoi n’est délibérément pas idempotent. Chaque invocation crée un nouveau message — exécuter la commande deux fois envoie deux messages. C’est ce que veulent généralement les scripts qui publient des notifications ; tout le reste du CLI converge vers l’état souhaité.

Modification et suppression

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

Modifier deux fois le même contenu est un no-op la seconde fois, et supprimer un message déjà supprimé réussit sans changement. Les deux attendent que le changement soit visible via l’API ; ajoutez --no-wait pour obtenir un retour immédiat avec la commande acceptée.

Réactions

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

Le CLI n’appelle le backend que lorsque la présence demandée diffère de l’état actuel, donc les commandes répétées sont sans risque.