termo_core 0.1.13 → 0.1.15

package/dist/talk/rotas.d.ts

@@ -0,0 +1,235 @@
+import type * as tipos from "./tipos.js";
+import type { CredencialDeAcesso } from "../base/credencial.js";
+import { type OpcoesDaChamada } from "../base/requisicao.js";
+/**
+ * Parâmetros de consulta e de cabeçalho de `/conversa`.
+ */
+export interface ParametrosDeBuscarPeloFiltroConversa {
+    /**
+     * Trecho do nome da conversa ou do nome de um participante.
+     */
+    busca?: string;
+    /**
+     * `DIRETA`, `GRUPO` ou `ESPACO`.
+     */
+    tipo?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/conversa/explorar`.
+ */
+export interface ParametrosDeExplorarConversa {
+    /**
+     * Trecho do nome, do e-mail, do setor ou do cargo.
+     */
+    busca?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/conversa/pessoas`.
+ */
+export interface ParametrosDeBuscarPessoasConversa {
+    /**
+     * Trecho do nome, do e-mail, do setor ou do cargo.
+     */
+    busca?: string;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/conversa/{id}/mensagem`.
+ */
+export interface ParametrosDeBuscarPaginadorMensagem {
+    /**
+     * Traz as mensagens anteriores a esta (rolar para cima). Sem ele, as mais recentes.
+     */
+    antes?: string;
+    /**
+     * Traz as mensagens posteriores a esta (o que chegou depois de uma reconexão).
+     */
+    depois?: string;
+    /**
+     * As respostas da thread desta mensagem principal (a principal vem em `raiz`).
+     */
+    thread_id?: string;
+}
+/**
+ * Busca o link para baixar um anexo
+ *
+ * Devolve o anexo com `url_download`, o link assinado do TermoBucket, que vale 15 minutos. Só para quem participa da conversa do anexo (senão `404`).
+ *
+ * `GET /anexo/{id}`
+ */
+export declare function buscar_pelo_id_anexo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.AnexoComEndereco>;
+/**
+ * Lista as conversas de quem pediu
+ *
+ * Todas as conversas (diretas, grupos e espaços) de que a pessoa participa: as fixadas primeiro e depois pela última atividade. Cada uma traz a prévia da última mensagem, o estado da pessoa (`eu`), as não lidas (`nao_lidas`, mensagens principais de outras pessoas depois da última lida, até 100) e as menções (`mencoes`). Na direta e no grupo vêm os participantes; no espaço, só o total. `busca` procura no nome da conversa e no nome dos participantes; `tipo` filtra por `DIRETA`, `GRUPO` ou `ESPACO`.
+ *
+ * `GET /conversa`
+ */
+export declare function buscar_pelo_filtro_conversa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroConversa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Conversa>>;
+/**
+ * Cria uma conversa
+ *
+ * Livre para todo colaborador logado; quem cria entra sozinho. `DIRETA`: exatamente uma pessoa em `participante_ids`; se o par já tem conversa, devolve a que existe com `200`. `GRUPO`: uma ou mais pessoas (até 50 no total), `nome` opcional. `ESPACO`: `nome` obrigatório (até 80 caracteres), `descricao` até 1000, `visibilidade` `PUBLICO` (padrão, qualquer colaborador acha em explorar e entra) ou `PRIVADO` (só por convite); quem cria vira gestor. As mensagens chegam em tempo real em `GET /ws?token=<JWT>` (WebSocket com eventos JSON: `mensagem.criada`, `mensagem.atualizada`, `conversa.atualizada`, `conversa.removida`, `conversa.lida`, `digitando`, `presenca` e `presenca.inicial`).
+ *
+ * `POST /conversa`
+ */
+export declare function criar_conversa(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ConversaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
+/**
+ * Lista os espaços públicos para entrar
+ *
+ * Espaços `PUBLICO` em que a pessoa ainda não está, em ordem alfabética (até 200). `busca` procura no nome e na descrição.
+ *
+ * `GET /conversa/explorar`
+ */
+export declare function explorar_conversa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeExplorarConversa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.EspacoPublico>>;
+/**
+ * Busca colaboradores para conversar
+ *
+ * Colaboradores ativos (até 30), em ordem alfabética, para começar uma conversa ou chamar para um grupo ou espaço. `busca` procura no nome, no e-mail, no setor e no cargo.
+ *
+ * `GET /conversa/pessoas`
+ */
+export declare function buscar_pessoas_conversa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPessoasConversa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.ColaboradorPessoa>>;
+/**
+ * Mostra um colaborador
+ *
+ * O cartão da pessoa: nome, e-mail, telefone, setor e cargo. Vale também para quem já saiu da empresa, que continua nas mensagens antigas.
+ *
+ * `GET /conversa/pessoas/{id}`
+ */
+export declare function buscar_pessoa_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ColaboradorPessoa>;
+/**
+ * Busca uma conversa pelo id
+ *
+ * A conversa com todos os participantes (inclusive no espaço), o papel de cada um e o estado de quem pediu.
+ *
+ * `GET /conversa/{id}`
+ */
+export declare function buscar_pelo_id_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
+/**
+ * Atualiza o nome, a descrição ou a visibilidade
+ *
+ * No grupo, qualquer participante muda o `nome`. No espaço, só os gestores mudam `nome`, `descricao` (`null` apaga) e `visibilidade`. A conversa direta não tem nome (`400`).
+ *
+ * `PATCH /conversa/{id}`
+ */
+export declare function atualizar_pelo_id_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ConversaAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
+/**
+ * Exclui o espaço ou o grupo
+ *
+ * O espaço, só os gestores; o grupo, só quem criou. A conversa direta não se exclui (`400`). Todos os participantes recebem `conversa.removida`.
+ *
+ * `DELETE /conversa/{id}`
+ */
+export declare function deletar_pelo_id_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Envia um arquivo para uma mensagem
+ *
+ * Quem participa da conversa envia o arquivo (`conteudo` em base64, até 20 MB; `nome` com a extensão e `tipo` MIME). O arquivo vai direto ao TermoBucket como arquivo privado e nunca fica no banco; se o bucket falhar, responde `503`. O `id` devolvido vai em `anexo_ids` do `POST /conversa/{id}/mensagem` (até 10 por mensagem; o texto pode ficar vazio). Os tipos aceitos são os liberados no cadastro do app no TermoBucket.
+ *
+ * `POST /conversa/{id}/anexo`
+ */
+export declare function enviar_anexo(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.AnexoEnviar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Anexo>;
+/**
+ * Entra num espaço público
+ *
+ * A pessoa entra como membro. Espaço privado ou outra conversa responde `404`. Repetir não muda nada.
+ *
+ * `POST /conversa/{id}/entrar`
+ */
+export declare function entrar_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
+/**
+ * Marca a conversa como lida
+ *
+ * Marca como lida até `mensagem_id`; a leitura nunca volta para trás. As outras abas da pessoa recebem `conversa.lida`.
+ *
+ * `POST /conversa/{id}/lida`
+ */
+export declare function marcar_lida_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.LeituraMarcar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.MeuEstado>;
+/**
+ * Lista o histórico da conversa
+ *
+ * 50 mensagens por página, da mais antiga para a mais recente. Sem parâmetro, as últimas; `antes` traz as anteriores a uma mensagem (`tem_mais` diz se há mais); `depois` traz as que chegaram depois de uma (reconexão). Sem `thread_id`, só as mensagens principais (cada uma com `respostas`); com `thread_id`, as respostas daquela thread e a principal em `raiz`.
+ *
+ * `GET /conversa/{id}/mensagem`
+ */
+export declare function buscar_paginador_mensagem(credencial_de_acesso: CredencialDeAcesso, id: string, parametros?: ParametrosDeBuscarPaginadorMensagem, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaDeMensagens>;
+/**
+ * Envia uma mensagem
+ *
+ * `texto` obrigatório (até 10000 caracteres, com `*negrito*`, `_itálico_`, `~riscado~` e `` `código` ``). `thread_id` responde na thread de uma mensagem principal. `anexo_ids` liga arquivos já enviados em `POST /conversa/{id}/anexo` (até 10; com anexos o texto pode ficar vazio). `mencoes` são os ids citados com `@nome` (quem não está na conversa fica de fora) e `mencao_todos` cita `@todos`. Quem está conectado recebe `mensagem.criada` na hora (e, na resposta de thread, `mensagem.atualizada` com a principal).
+ *
+ * `POST /conversa/{id}/mensagem`
+ */
+export declare function criar_mensagem(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.MensagemCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Mensagem>;
+/**
+ * Chama pessoas para o grupo ou o espaço
+ *
+ * Qualquer participante chama; quem já está continua como estava. A conversa direta não ganha pessoas (`400`): crie um grupo. O grupo vai até 50 pessoas.
+ *
+ * `POST /conversa/{id}/participante`
+ */
+export declare function adicionar_participantes_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ParticipantesAdicionar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
+/**
+ * Muda o papel de alguém no espaço
+ *
+ * Só os gestores, só no espaço. `papel` é `GESTOR` ou `MEMBRO`; o espaço nunca fica sem gestor (`400`).
+ *
+ * `PATCH /conversa/{id}/participante/{colaborador_id}`
+ */
+export declare function atualizar_participante_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, colaborador_id: string, corpo_da_requisicao: tipos.ParticipanteAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
+/**
+ * Tira alguém do grupo ou do espaço
+ *
+ * No grupo, qualquer participante; no espaço, só os gestores. Para sair, use `/sair`. A pessoa tirada recebe `conversa.removida`.
+ *
+ * `DELETE /conversa/{id}/participante/{colaborador_id}`
+ */
+export declare function remover_participante_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, colaborador_id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Silencia ou fixa a conversa
+ *
+ * Só para quem pediu: `silenciado` (sem notificação, a não ser que citem a pessoa) e `fixado` (fica em cima na lista).
+ *
+ * `PATCH /conversa/{id}/preferencias`
+ */
+export declare function atualizar_preferencias_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.PreferenciasAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.MeuEstado>;
+/**
+ * Inicia uma reunião ou uma chamada no TermoMeet
+ *
+ * Cria no TermoMeet (com o token de quem pediu) uma reunião instantânea com o nome da conversa (ou "Reunião de"/"Chamada de" quem pediu) e manda o link na conversa como mensagem de quem pediu. `tipo` `REUNIAO` (padrão) manda "📹 Reunião no TermoMeet: <link>"; `CHAMADA` manda "📞 <nome> iniciou uma chamada no TermoMeet: <link>" e avisa por push quem não está no app. O corpo pode ir vazio. Quem está conectado recebe `mensagem.criada` na hora. A resposta traz o `codigo` e o `link` da sala para abrir na hora.
+ *
+ * `POST /conversa/{id}/reuniao`
+ */
+export declare function iniciar_reuniao_mensagem(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ReuniaoIniciar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ReuniaoIniciada>;
+/**
+ * Sai do grupo ou do espaço
+ *
+ * Da conversa direta não se sai (`400`). Se sair o último gestor do espaço, quem está há mais tempo vira gestor.
+ *
+ * `POST /conversa/{id}/sair`
+ */
+export declare function sair_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Edita uma mensagem
+ *
+ * Só quem escreveu. Troca o `texto` (e, se vierem, as citações) e marca `editado_em`.
+ *
+ * `PATCH /mensagem/{id}`
+ */
+export declare function atualizar_pelo_id_mensagem(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.MensagemAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Mensagem>;
+/**
+ * Exclui uma mensagem
+ *
+ * Quem escreveu, ou um gestor do espaço. A principal com respostas fica no lugar como excluída, sem texto.
+ *
+ * `DELETE /mensagem/{id}`
+ */
+export declare function deletar_pelo_id_mensagem(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Reage a uma mensagem
+ *
+ * Põe a reação de quem pediu com o `emoji`; reagir de novo com o mesmo tira.
+ *
+ * `POST /mensagem/{id}/reacao`
+ */
+export declare function reagir_mensagem(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ReacaoAlternar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Mensagem>;

package/dist/talk/rotas.js

@@ -0,0 +1,386 @@
+// Gerado pelo gerador do TermoCore (`cargo run -p gerador`). Não edite à mão: a próxima geração sobrescreve.
+import { chamar_servico, codificar_parametro_de_caminho } from "../base/requisicao.js";
+import { TERMO_TALK as SERVICO_DESTA_API } from "../base/servicos.js";
+/**
+ * Busca o link para baixar um anexo
+ *
+ * Devolve o anexo com `url_download`, o link assinado do TermoBucket, que vale 15 minutos. Só para quem participa da conversa do anexo (senão `404`).
+ *
+ * `GET /anexo/{id}`
+ */
+export function buscar_pelo_id_anexo(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/anexo/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista as conversas de quem pediu
+ *
+ * Todas as conversas (diretas, grupos e espaços) de que a pessoa participa: as fixadas primeiro e depois pela última atividade. Cada uma traz a prévia da última mensagem, o estado da pessoa (`eu`), as não lidas (`nao_lidas`, mensagens principais de outras pessoas depois da última lida, até 100) e as menções (`mencoes`). Na direta e no grupo vêm os participantes; no espaço, só o total. `busca` procura no nome da conversa e no nome dos participantes; `tipo` filtra por `DIRETA`, `GRUPO` ou `ESPACO`.
+ *
+ * `GET /conversa`
+ */
+export function buscar_pelo_filtro_conversa(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/conversa",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Cria uma conversa
+ *
+ * Livre para todo colaborador logado; quem cria entra sozinho. `DIRETA`: exatamente uma pessoa em `participante_ids`; se o par já tem conversa, devolve a que existe com `200`. `GRUPO`: uma ou mais pessoas (até 50 no total), `nome` opcional. `ESPACO`: `nome` obrigatório (até 80 caracteres), `descricao` até 1000, `visibilidade` `PUBLICO` (padrão, qualquer colaborador acha em explorar e entra) ou `PRIVADO` (só por convite); quem cria vira gestor. As mensagens chegam em tempo real em `GET /ws?token=<JWT>` (WebSocket com eventos JSON: `mensagem.criada`, `mensagem.atualizada`, `conversa.atualizada`, `conversa.removida`, `conversa.lida`, `digitando`, `presenca` e `presenca.inicial`).
+ *
+ * `POST /conversa`
+ */
+export function criar_conversa(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/conversa",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista os espaços públicos para entrar
+ *
+ * Espaços `PUBLICO` em que a pessoa ainda não está, em ordem alfabética (até 200). `busca` procura no nome e na descrição.
+ *
+ * `GET /conversa/explorar`
+ */
+export function explorar_conversa(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/conversa/explorar",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca colaboradores para conversar
+ *
+ * Colaboradores ativos (até 30), em ordem alfabética, para começar uma conversa ou chamar para um grupo ou espaço. `busca` procura no nome, no e-mail, no setor e no cargo.
+ *
+ * `GET /conversa/pessoas`
+ */
+export function buscar_pessoas_conversa(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/conversa/pessoas",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Mostra um colaborador
+ *
+ * O cartão da pessoa: nome, e-mail, telefone, setor e cargo. Vale também para quem já saiu da empresa, que continua nas mensagens antigas.
+ *
+ * `GET /conversa/pessoas/{id}`
+ */
+export function buscar_pessoa_conversa(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/conversa/pessoas/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca uma conversa pelo id
+ *
+ * A conversa com todos os participantes (inclusive no espaço), o papel de cada um e o estado de quem pediu.
+ *
+ * `GET /conversa/{id}`
+ */
+export function buscar_pelo_id_conversa(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Atualiza o nome, a descrição ou a visibilidade
+ *
+ * No grupo, qualquer participante muda o `nome`. No espaço, só os gestores mudam `nome`, `descricao` (`null` apaga) e `visibilidade`. A conversa direta não tem nome (`400`).
+ *
+ * `PATCH /conversa/{id}`
+ */
+export function atualizar_pelo_id_conversa(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui o espaço ou o grupo
+ *
+ * O espaço, só os gestores; o grupo, só quem criou. A conversa direta não se exclui (`400`). Todos os participantes recebem `conversa.removida`.
+ *
+ * `DELETE /conversa/{id}`
+ */
+export function deletar_pelo_id_conversa(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Envia um arquivo para uma mensagem
+ *
+ * Quem participa da conversa envia o arquivo (`conteudo` em base64, até 20 MB; `nome` com a extensão e `tipo` MIME). O arquivo vai direto ao TermoBucket como arquivo privado e nunca fica no banco; se o bucket falhar, responde `503`. O `id` devolvido vai em `anexo_ids` do `POST /conversa/{id}/mensagem` (até 10 por mensagem; o texto pode ficar vazio). Os tipos aceitos são os liberados no cadastro do app no TermoBucket.
+ *
+ * `POST /conversa/{id}/anexo`
+ */
+export function enviar_anexo(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/anexo`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Entra num espaço público
+ *
+ * A pessoa entra como membro. Espaço privado ou outra conversa responde `404`. Repetir não muda nada.
+ *
+ * `POST /conversa/{id}/entrar`
+ */
+export function entrar_conversa(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/entrar`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Marca a conversa como lida
+ *
+ * Marca como lida até `mensagem_id`; a leitura nunca volta para trás. As outras abas da pessoa recebem `conversa.lida`.
+ *
+ * `POST /conversa/{id}/lida`
+ */
+export function marcar_lida_conversa(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/lida`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista o histórico da conversa
+ *
+ * 50 mensagens por página, da mais antiga para a mais recente. Sem parâmetro, as últimas; `antes` traz as anteriores a uma mensagem (`tem_mais` diz se há mais); `depois` traz as que chegaram depois de uma (reconexão). Sem `thread_id`, só as mensagens principais (cada uma com `respostas`); com `thread_id`, as respostas daquela thread e a principal em `raiz`.
+ *
+ * `GET /conversa/{id}/mensagem`
+ */
+export function buscar_paginador_mensagem(credencial_de_acesso, id, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/mensagem`,
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Envia uma mensagem
+ *
+ * `texto` obrigatório (até 10000 caracteres, com `*negrito*`, `_itálico_`, `~riscado~` e `` `código` ``). `thread_id` responde na thread de uma mensagem principal. `anexo_ids` liga arquivos já enviados em `POST /conversa/{id}/anexo` (até 10; com anexos o texto pode ficar vazio). `mencoes` são os ids citados com `@nome` (quem não está na conversa fica de fora) e `mencao_todos` cita `@todos`. Quem está conectado recebe `mensagem.criada` na hora (e, na resposta de thread, `mensagem.atualizada` com a principal).
+ *
+ * `POST /conversa/{id}/mensagem`
+ */
+export function criar_mensagem(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/mensagem`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Chama pessoas para o grupo ou o espaço
+ *
+ * Qualquer participante chama; quem já está continua como estava. A conversa direta não ganha pessoas (`400`): crie um grupo. O grupo vai até 50 pessoas.
+ *
+ * `POST /conversa/{id}/participante`
+ */
+export function adicionar_participantes_conversa(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/participante`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Muda o papel de alguém no espaço
+ *
+ * Só os gestores, só no espaço. `papel` é `GESTOR` ou `MEMBRO`; o espaço nunca fica sem gestor (`400`).
+ *
+ * `PATCH /conversa/{id}/participante/{colaborador_id}`
+ */
+export function atualizar_participante_conversa(credencial_de_acesso, id, colaborador_id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/participante/${codificar_parametro_de_caminho(colaborador_id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Tira alguém do grupo ou do espaço
+ *
+ * No grupo, qualquer participante; no espaço, só os gestores. Para sair, use `/sair`. A pessoa tirada recebe `conversa.removida`.
+ *
+ * `DELETE /conversa/{id}/participante/{colaborador_id}`
+ */
+export function remover_participante_conversa(credencial_de_acesso, id, colaborador_id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/participante/${codificar_parametro_de_caminho(colaborador_id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Silencia ou fixa a conversa
+ *
+ * Só para quem pediu: `silenciado` (sem notificação, a não ser que citem a pessoa) e `fixado` (fica em cima na lista).
+ *
+ * `PATCH /conversa/{id}/preferencias`
+ */
+export function atualizar_preferencias_conversa(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/preferencias`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Inicia uma reunião ou uma chamada no TermoMeet
+ *
+ * Cria no TermoMeet (com o token de quem pediu) uma reunião instantânea com o nome da conversa (ou "Reunião de"/"Chamada de" quem pediu) e manda o link na conversa como mensagem de quem pediu. `tipo` `REUNIAO` (padrão) manda "📹 Reunião no TermoMeet: <link>"; `CHAMADA` manda "📞 <nome> iniciou uma chamada no TermoMeet: <link>" e avisa por push quem não está no app. O corpo pode ir vazio. Quem está conectado recebe `mensagem.criada` na hora. A resposta traz o `codigo` e o `link` da sala para abrir na hora.
+ *
+ * `POST /conversa/{id}/reuniao`
+ */
+export function iniciar_reuniao_mensagem(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/reuniao`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Sai do grupo ou do espaço
+ *
+ * Da conversa direta não se sai (`400`). Se sair o último gestor do espaço, quem está há mais tempo vira gestor.
+ *
+ * `POST /conversa/{id}/sair`
+ */
+export function sair_conversa(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/conversa/${codificar_parametro_de_caminho(id)}/sair`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Edita uma mensagem
+ *
+ * Só quem escreveu. Troca o `texto` (e, se vierem, as citações) e marca `editado_em`.
+ *
+ * `PATCH /mensagem/{id}`
+ */
+export function atualizar_pelo_id_mensagem(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/mensagem/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui uma mensagem
+ *
+ * Quem escreveu, ou um gestor do espaço. A principal com respostas fica no lugar como excluída, sem texto.
+ *
+ * `DELETE /mensagem/{id}`
+ */
+export function deletar_pelo_id_mensagem(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/mensagem/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Reage a uma mensagem
+ *
+ * Põe a reação de quem pediu com o `emoji`; reagir de novo com o mesmo tira.
+ *
+ * `POST /mensagem/{id}/reacao`
+ */
+export function reagir_mensagem(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/mensagem/${codificar_parametro_de_caminho(id)}/reacao`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}