HansaChat

Documentation

Convites e carregamentos de ficheiros

Convide pessoas e transfira ficheiros a partir da linha de comandos.

Convites

Os comandos de convite são para administradores do workspace; o backend impõe-no.

hansa chat invitations list

Criar um convite funciona por estado pretendido: um convite pendente para o mesmo e-mail é devolvido sem alterações, com changed: false; apenas os que faltam são criados. Vários e-mails utilizam a API em massa:

hansa chat invitations create --email new@example.com --role member
hansa chat invitations create --email a@example.com --email b@example.com

Um --expires-at opcional aceita um carimbo de data/hora RFC3339.

hansa chat invitations resend --invitation <id>    # send the email again
hansa chat invitations revoke --invitation <id>    # idempotent
hansa chat invitations get --code <code>           # look up a code, no login needed

O código do convite é impresso por list e create. Uma pessoa nova pode registar-se diretamente pela CLI:

echo '{"name": "Ada", "password": "…"}' \
  | hansa chat invitations register --code inv_42_… --credentials-stdin

Um utilizador existente aceita um convite pelo qual foi convidado:

hansa chat invitations accept --code inv_42_…

Carregamentos de ficheiros

hansa chat files upload --file report.pdf

A CLI calcula o checksum SHA-256, reserva o carregamento, transfere os bytes e conclui o carregamento — devolvendo o registo do ficheiro com o seu ID. O backend limita os carregamentos a 32 MiB. Se a quota de armazenamento do workspace bloquear o carregamento, o comando falha com os detalhes da quota e uma ligação de gestão.

Anexe ficheiros a uma mensagem com o ID do ficheiro:

hansa chat files upload --file report.pdf
hansa chat messages send --channel general --text "Report is ready." --file <file-id>

Um carregamento de que já não precise pode ser descartado:

hansa chat files abort --file <file-id>