termo_core 0.1.14 → 0.1.16

package/dist/agenda/rotas.d.ts

@@ -170,7 +170,7 @@ export declare function buscar_pelo_filtro_evento(credencial_de_acesso: Credenci
 /**
  * Marca um evento
  *
- * Livre para todo colaborador logado; quem marca é o organizador. Sem `agenda_id`, vai para a "Minha agenda". `inicio` e `fim` em ISO 8601 (o fim depois do início, até 31 dias); `titulo` vazio vira "(Sem título)"; `dia_inteiro` usa meia-noite de Brasília no início e no fim (exclusivo). `convidado_ids` (até 100 colaboradores) e `sala_ids` (até 5 salas ativas). `recorrencia`: `frequencia` `DIARIA`, `SEMANAL`, `MENSAL` ou `ANUAL`, `intervalo` 1 a 99, `dias_semana` (0 = domingo, na semanal), e `ate` (AAAA-MM-DD) ou `vezes` (1 a 730). `lembretes` em minutos antes (padrão `[10]`). **Conflito:** se um convidado (que não recusou) ou uma sala já tem reunião no horário, responde `409` com `conflitos` (quem, ou qual sala, e quando), conferindo cada ocorrência da repetição nos próximos 12 meses; evento de dia inteiro não ocupa e a agenda do próprio organizador não bloqueia.
+ * Livre para todo colaborador logado; quem marca é o organizador. Sem `agenda_id`, vai para a "Minha agenda". `inicio` e `fim` em ISO 8601 (o fim depois do início, até 31 dias); `titulo` vazio vira "(Sem título)"; `dia_inteiro` usa meia-noite de Brasília no início e no fim (exclusivo). `convidado_ids` (até 100 colaboradores) e `sala_ids` (até 5 salas ativas). `recorrencia`: `frequencia` `DIARIA`, `SEMANAL`, `MENSAL` ou `ANUAL`, `intervalo` 1 a 99, `dias_semana` (0 = domingo, na semanal), e `ate` (AAAA-MM-DD) ou `vezes` (1 a 730). `lembretes` em minutos antes (padrão `[10]`). **Videochamada:** `com_videochamada: true` cria a reunião no TermoMeet (com o token de quem marca) com o título e o horário do evento e grava o link dela em `link_reuniao`; se o TermoMeet falhar, responde `502` e nada é gravado. **Conflito:** se um convidado (que não recusou) ou uma sala já tem reunião no horário, responde `409` com `conflitos` (quem, ou qual sala, e quando), conferindo cada ocorrência da repetição nos próximos 12 meses; evento de dia inteiro não ocupa e a agenda do próprio organizador não bloqueia.
  *
  * `POST /evento`
  */
@@ -202,7 +202,7 @@ export declare function buscar_pelo_id_evento(credencial_de_acesso: CredencialDe
 /**
  * Altera um evento
  *
- * Só o organizador (`403` para o convidado). Só os campos enviados mudam; `local`, `descricao`, `cor`, `link_reuniao` e `recorrencia` com `null` apagam o valor. Na repetição, `escopo` diz o alcance: `todos` (padrão; mudar o horário desloca a série inteira pela diferença em relação à `ocorrencia`), `este` (só a `ocorrencia`, que vira um evento à parte) ou `seguintes` (da `ocorrencia` em diante, que vira uma série nova). Quem continua convidado guarda a resposta. Confere o conflito como no `POST` (`409`).
+ * Só o organizador (`403` para o convidado). Só os campos enviados mudam; `local`, `descricao`, `cor`, `link_reuniao` e `recorrencia` com `null` apagam o valor. Na repetição, `escopo` diz o alcance: `todos` (padrão; mudar o horário desloca a série inteira pela diferença em relação à `ocorrencia`), `este` (só a `ocorrencia`, que vira um evento à parte) ou `seguintes` (da `ocorrencia` em diante, que vira uma série nova). Quem continua convidado guarda a resposta. Confere o conflito como no `POST` (`409`). `com_videochamada: true` cria a videochamada no TermoMeet para o evento que ainda não tem link (`502` se o TermoMeet falhar); com `escopo` `todos`, mudar o título ou o horário de um evento com videochamada do TermoMeet atualiza a reunião, e excluir a série inteira a exclui.
  *
  * `PATCH /evento/{id}`
  */

package/dist/agenda/rotas.js

@@ -153,7 +153,7 @@ export function buscar_pelo_filtro_evento(credencial_de_acesso, parametros, opco
 /**
  * Marca um evento
  *
- * Livre para todo colaborador logado; quem marca é o organizador. Sem `agenda_id`, vai para a "Minha agenda". `inicio` e `fim` em ISO 8601 (o fim depois do início, até 31 dias); `titulo` vazio vira "(Sem título)"; `dia_inteiro` usa meia-noite de Brasília no início e no fim (exclusivo). `convidado_ids` (até 100 colaboradores) e `sala_ids` (até 5 salas ativas). `recorrencia`: `frequencia` `DIARIA`, `SEMANAL`, `MENSAL` ou `ANUAL`, `intervalo` 1 a 99, `dias_semana` (0 = domingo, na semanal), e `ate` (AAAA-MM-DD) ou `vezes` (1 a 730). `lembretes` em minutos antes (padrão `[10]`). **Conflito:** se um convidado (que não recusou) ou uma sala já tem reunião no horário, responde `409` com `conflitos` (quem, ou qual sala, e quando), conferindo cada ocorrência da repetição nos próximos 12 meses; evento de dia inteiro não ocupa e a agenda do próprio organizador não bloqueia.
+ * Livre para todo colaborador logado; quem marca é o organizador. Sem `agenda_id`, vai para a "Minha agenda". `inicio` e `fim` em ISO 8601 (o fim depois do início, até 31 dias); `titulo` vazio vira "(Sem título)"; `dia_inteiro` usa meia-noite de Brasília no início e no fim (exclusivo). `convidado_ids` (até 100 colaboradores) e `sala_ids` (até 5 salas ativas). `recorrencia`: `frequencia` `DIARIA`, `SEMANAL`, `MENSAL` ou `ANUAL`, `intervalo` 1 a 99, `dias_semana` (0 = domingo, na semanal), e `ate` (AAAA-MM-DD) ou `vezes` (1 a 730). `lembretes` em minutos antes (padrão `[10]`). **Videochamada:** `com_videochamada: true` cria a reunião no TermoMeet (com o token de quem marca) com o título e o horário do evento e grava o link dela em `link_reuniao`; se o TermoMeet falhar, responde `502` e nada é gravado. **Conflito:** se um convidado (que não recusou) ou uma sala já tem reunião no horário, responde `409` com `conflitos` (quem, ou qual sala, e quando), conferindo cada ocorrência da repetição nos próximos 12 meses; evento de dia inteiro não ocupa e a agenda do próprio organizador não bloqueia.
  *
  * `POST /evento`
  */
@@ -220,7 +220,7 @@ export function buscar_pelo_id_evento(credencial_de_acesso, id, opcoes_da_chamad
 /**
  * Altera um evento
  *
- * Só o organizador (`403` para o convidado). Só os campos enviados mudam; `local`, `descricao`, `cor`, `link_reuniao` e `recorrencia` com `null` apagam o valor. Na repetição, `escopo` diz o alcance: `todos` (padrão; mudar o horário desloca a série inteira pela diferença em relação à `ocorrencia`), `este` (só a `ocorrencia`, que vira um evento à parte) ou `seguintes` (da `ocorrencia` em diante, que vira uma série nova). Quem continua convidado guarda a resposta. Confere o conflito como no `POST` (`409`).
+ * Só o organizador (`403` para o convidado). Só os campos enviados mudam; `local`, `descricao`, `cor`, `link_reuniao` e `recorrencia` com `null` apagam o valor. Na repetição, `escopo` diz o alcance: `todos` (padrão; mudar o horário desloca a série inteira pela diferença em relação à `ocorrencia`), `este` (só a `ocorrencia`, que vira um evento à parte) ou `seguintes` (da `ocorrencia` em diante, que vira uma série nova). Quem continua convidado guarda a resposta. Confere o conflito como no `POST` (`409`). `com_videochamada: true` cria a videochamada no TermoMeet para o evento que ainda não tem link (`502` se o TermoMeet falhar); com `escopo` `todos`, mudar o título ou o horário de um evento com videochamada do TermoMeet atualiza a reunião, e excluir a série inteira a exclui.
  *
  * `PATCH /evento/{id}`
  */

package/dist/agenda/tipos.d.ts

@@ -85,6 +85,10 @@ export interface Evento {
 }
 export interface EventoAtualizar {
     agenda_id?: string | null;
+    /**
+     * `true` cria a videochamada no TermoMeet para um evento que ainda não tem link.
+     */
+    com_videochamada?: boolean | null;
     convidado_ids?: Array<string> | null;
     cor?: string | null;
     descricao?: string | null;
@@ -117,6 +121,11 @@ export interface EventoCriar {
      * Sem ela, o evento vai para a "Minha agenda".
      */
     agenda_id?: string | null;
+    /**
+     * `true` cria a videochamada no TermoMeet com o título e o horário do evento e põe o link
+     * dela em `link_reuniao`.
+     */
+    com_videochamada?: boolean | null;
     convidado_ids?: Array<string> | null;
     cor?: string | null;
     descricao?: string | null;

package/dist/flow/rotas.d.ts

@@ -1,18 +1,73 @@
 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 `/robo`.
+ */
+export interface ParametrosDeBuscarPaginadorRobo {
+    pagina?: number;
+    tamanho?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/robo/autocomplete`.
+ */
+export interface ParametrosDeBuscarAutoCompleteRobo {
+    busca?: string;
+    pagina?: number;
+    tamanho?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/robo/filtro`.
+ */
+export interface ParametrosDeBuscarPeloFiltroRobo {
+    nome?: string;
+    modelo?: string;
+    ativo?: boolean;
+}
+/**
+ * Lista os robôs com paginação
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Ordena por nome. `pagina` começa em 1 (padrão 1; valores menores viram 1). A página tem sempre 50 itens: `tamanho` é aceito, mas ignorado. `total` conta todos os robôs não excluídos.
+ *
+ * `GET /robo`
+ */
+export declare function buscar_paginador_robo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorRobo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaRobo>;
 /**
  * Cadastra um robô de atendimento
  *
- * Exige a permissão `criar` da área `robos`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `criar` da área `robos`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento`, `vendedor` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e, se vier `vendedor_id` (opcional, de `GET /robo/vendedores?equipe_id=`), para esse vendedor da equipe, e não tem saída; `vendedor` encerra o robô do mesmo jeito, mas passa a conversa só para o vendedor do Chatwoot em `vendedor_id` (obrigatório, de `GET /robo/vendedores`), sem equipe; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440), `equipe_id` e `vendedor_id` opcionais (um, os dois ou nenhum), e uma varredura a cada minuto passa para essa equipe e esse vendedor toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `POST /robo`
  */
 export declare function criar_robo(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.RoboCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Robo>;
+/**
+ * Lista básica de robôs para seleção
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e modelo, em ordem alfabética de nome, para achar o id de um robô. `busca` procura por trecho do nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10; valores menores que 1 viram 1. `total` conta os robôs que casam com a busca.
+ *
+ * `GET /robo/autocomplete`
+ */
+export declare function buscar_auto_complete_robo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteRobo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaDeRoboAutoComplete>;
+/**
+ * Busca robôs por filtro
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Devolve todos os robôs que casam com o filtro, com o fluxo, sem paginação, em ordem alfabética de nome. `nome` e `modelo` procuram por trecho, sem diferenciar maiúsculas; `ativo` filtra pela situação. Sem filtro, devolve todos.
+ *
+ * `GET /robo/filtro`
+ */
+export declare function buscar_pelo_filtro_robo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroRobo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Robo>>;
+/**
+ * Busca um robô pelo id
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Devolve o robô com o prompt e o fluxo completo (etapas e ligações), no mesmo formato aceito pelo `PATCH`. Robô excluído responde `404`.
+ *
+ * `GET /robo/{id}`
+ */
+export declare function buscar_pelo_id_robo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Robo>;
 /**
  * Atualiza um robô pelo id
  *
- * Exige a permissão `editar` da área `robos`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `editar` da área `robos`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento`, `vendedor` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e, se vier `vendedor_id` (opcional, de `GET /robo/vendedores?equipe_id=`), para esse vendedor da equipe, e não tem saída; `vendedor` encerra o robô do mesmo jeito, mas passa a conversa só para o vendedor do Chatwoot em `vendedor_id` (obrigatório, de `GET /robo/vendedores`), sem equipe; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440), `equipe_id` e `vendedor_id` opcionais (um, os dois ou nenhum), e uma varredura a cada minuto passa para essa equipe e esse vendedor toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `PATCH /robo/{id}`
  */

package/dist/flow/rotas.js

@@ -1,10 +1,27 @@
 // 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_FLOW as SERVICO_DESTA_API } from "../base/servicos.js";
+/**
+ * Lista os robôs com paginação
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Ordena por nome. `pagina` começa em 1 (padrão 1; valores menores viram 1). A página tem sempre 50 itens: `tamanho` é aceito, mas ignorado. `total` conta todos os robôs não excluídos.
+ *
+ * `GET /robo`
+ */
+export function buscar_paginador_robo(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/robo",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Cadastra um robô de atendimento
  *
- * Exige a permissão `criar` da área `robos`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `criar` da área `robos`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento`, `vendedor` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e, se vier `vendedor_id` (opcional, de `GET /robo/vendedores?equipe_id=`), para esse vendedor da equipe, e não tem saída; `vendedor` encerra o robô do mesmo jeito, mas passa a conversa só para o vendedor do Chatwoot em `vendedor_id` (obrigatório, de `GET /robo/vendedores`), sem equipe; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440), `equipe_id` e `vendedor_id` opcionais (um, os dois ou nenhum), e uma varredura a cada minuto passa para essa equipe e esse vendedor toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `POST /robo`
  */
@@ -18,10 +35,60 @@ export function criar_robo(credencial_de_acesso, corpo_da_requisicao, opcoes_da_
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * Lista básica de robôs para seleção
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e modelo, em ordem alfabética de nome, para achar o id de um robô. `busca` procura por trecho do nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10; valores menores que 1 viram 1. `total` conta os robôs que casam com a busca.
+ *
+ * `GET /robo/autocomplete`
+ */
+export function buscar_auto_complete_robo(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/robo/autocomplete",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca robôs por filtro
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Devolve todos os robôs que casam com o filtro, com o fluxo, sem paginação, em ordem alfabética de nome. `nome` e `modelo` procuram por trecho, sem diferenciar maiúsculas; `ativo` filtra pela situação. Sem filtro, devolve todos.
+ *
+ * `GET /robo/filtro`
+ */
+export function buscar_pelo_filtro_robo(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/robo/filtro",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca um robô pelo id
+ *
+ * Exige qualquer permissão da área `robos`, `whatsapp` ou `chatwoot` (qualquer ação liberada na área já libera a leitura). Devolve o robô com o prompt e o fluxo completo (etapas e ligações), no mesmo formato aceito pelo `PATCH`. Robô excluído responde `404`.
+ *
+ * `GET /robo/{id}`
+ */
+export function buscar_pelo_id_robo(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/robo/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Atualiza um robô pelo id
  *
- * Exige a permissão `editar` da área `robos`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `editar` da área `robos`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento`, `vendedor` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e, se vier `vendedor_id` (opcional, de `GET /robo/vendedores?equipe_id=`), para esse vendedor da equipe, e não tem saída; `vendedor` encerra o robô do mesmo jeito, mas passa a conversa só para o vendedor do Chatwoot em `vendedor_id` (obrigatório, de `GET /robo/vendedores`), sem equipe; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440), `equipe_id` e `vendedor_id` opcionais (um, os dois ou nenhum), e uma varredura a cada minuto passa para essa equipe e esse vendedor toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `PATCH /robo/{id}`
  */

package/dist/flow/tipos.d.ts

@@ -1,3 +1,28 @@
+export interface PaginaDeRoboAutoComplete {
+    itens: Array<RoboAutoComplete>;
+    pagina: number;
+    tamanho: number;
+    total: number;
+}
+export interface PaginaRoboItensItem {
+    atender_contatos_novos: boolean;
+    ativo: boolean;
+    atualizado_em: string;
+    criado_em: string;
+    descricao?: string | null;
+    fluxo: RoboFluxo;
+    id: string;
+    modelo: string;
+    nome: string;
+    prompt_base: string;
+    versao: number;
+}
+export interface PaginaRobo {
+    itens: Array<PaginaRoboItensItem>;
+    pagina: number;
+    tamanho: number;
+    total: number;
+}
 export interface RespostaDeErro {
     erro: string;
 }
@@ -23,6 +48,11 @@ export interface RoboAtualizar {
     nome?: string | null;
     prompt_base?: string | null;
 }
+export interface RoboAutoComplete {
+    id: string;
+    modelo: string;
+    nome: string;
+}
 export interface RoboBotao {
     id: string;
     rotulo: string;
@@ -58,6 +88,7 @@ export interface RoboNo {
     posicao: RoboPosicao;
     regras?: Array<RoboRegra>;
     tipo: string;
+    vendedor_id?: number | null;
 }
 export interface RoboPosicao {
     x?: number;

package/dist/talk/rotas.d.ts

@@ -89,6 +89,14 @@ export declare function explorar_conversa(credencial_de_acesso: CredencialDeAces
  * `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
  *
@@ -185,6 +193,14 @@ export declare function remover_participante_conversa(credencial_de_acesso: Cred
  * `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
  *

package/dist/talk/rotas.js

@@ -85,6 +85,22 @@ export function buscar_pessoas_conversa(credencial_de_acesso, parametros = {}, o
         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
  *
@@ -285,6 +301,23 @@ export function atualizar_preferencias_conversa(credencial_de_acesso, id, corpo_
         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
  *

package/dist/talk/tipos.d.ts

@@ -38,7 +38,7 @@ export interface AnexoEnviar {
     tipo: string;
 }
 /**
- * Colaborador para escolher numa conversa: nome, e-mail, setor e cargo.
+ * Colaborador para escolher numa conversa (e para o cartão da pessoa): nome, e-mail, telefone, setor e cargo.
  */
 export interface ColaboradorPessoa {
     cargo?: string | null;
@@ -46,6 +46,7 @@ export interface ColaboradorPessoa {
     id: string;
     nome: string;
     setor?: string | null;
+    telefone?: string | null;
 }
 /**
  * Resumo do colaborador (id e nome) para mostrar autoria.
@@ -231,6 +232,26 @@ export interface ReacaoAlternar {
 export interface RespostaDeErro {
     erro: string;
 }
+export interface ReuniaoIniciada {
+    /**
+     * Código da sala no TermoMeet (`abc-defg-hij`).
+     */
+    codigo: string;
+    /**
+     * Link da sala no TermoMeet, o mesmo que foi na mensagem.
+     */
+    link: string;
+    /**
+     * A mensagem com o link que foi para a conversa.
+     */
+    mensagem: Mensagem;
+}
+export interface ReuniaoIniciar {
+    /**
+     * `REUNIAO` (padrão, reunião instantânea) ou `CHAMADA` (liga para quem está na conversa).
+     */
+    tipo?: string | null;
+}
 export interface UltimaMensagem {
     autor: ColaboradorResumo;
     criado_em: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termo_core",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Todos os clientes da Termotubos num pacote só: um módulo por serviço e cada rota da API como uma função com fetch, com o endereço resolvido pelo ambiente atual.",
   "license": "MIT",
   "author": "TI Termotubos <ti@termotubos.com.br>",