termo_core 0.1.15 → 0.1.17

package/dist/flow/rotas.d.ts

@@ -1,18 +1,75 @@
 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;
+    busca?: string;
+    ativo?: boolean;
+}
+/**
+ * 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. `busca` (opcional) procura no nome, na descrição e no modelo; `ativo` (opcional) traz só os ativos ou só os inativos. `total` conta os robôs não excluídos que casam com a busca.
+ *
+ * `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: com ele no fluxo o robô atende contatos novos (sem ele, o contato novo vai para a equipe) e, 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ô. `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: com ele no fluxo o robô atende contatos novos (sem ele, o contato novo vai para a equipe) e, 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. `busca` (opcional) procura no nome, na descrição e no modelo; `ativo` (opcional) traz só os ativos ou só os inativos. `total` conta os robôs não excluídos que casam com a busca.
+ *
+ * `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: com ele no fluxo o robô atende contatos novos (sem ele, o contato novo vai para a equipe) e, 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ô. `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: com ele no fluxo o robô atende contatos novos (sem ele, o contato novo vai para a equipe) e, 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,8 +1,31 @@
+export interface PaginaDeRoboAutoComplete {
+    itens: Array<RoboAutoComplete>;
+    pagina: number;
+    tamanho: number;
+    total: number;
+}
+export interface PaginaRoboItensItem {
+    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;
 }
 export interface Robo {
-    atender_contatos_novos: boolean;
     ativo: boolean;
     atualizado_em: string;
     criado_em: string;
@@ -15,7 +38,6 @@ export interface Robo {
     versao: number;
 }
 export interface RoboAtualizar {
-    atender_contatos_novos?: boolean | null;
     ativo?: boolean | null;
     descricao?: string | null;
     fluxo?: RoboFluxo | null;
@@ -23,6 +45,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 +85,7 @@ export interface RoboNo {
     posicao: RoboPosicao;
     regras?: Array<RoboRegra>;
     tipo: string;
+    vendedor_id?: number | null;
 }
 export interface RoboPosicao {
     x?: number;

package/dist/support/rotas.d.ts

@@ -742,6 +742,22 @@ export declare function criar_tarefa(credencial_de_acesso: CredencialDeAcesso, c
  * `GET /tarefa/autocomplete`
  */
 export declare function buscar_auto_complete_tarefa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteTarefa, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTarefaAutoComplete>;
+/**
+ * Aplica a mesma mudança em várias tarefas
+ *
+ * Exige a permissão `editar` na área `projetos`. Aplica a mesma mudança em 1 a 500 tarefas (`tarefa_ids`, sem repetição), com pelo menos um destes campos: `secao_id` leva as tarefas principais para o fim dessa coluna, na ordem pedida (as tarefas e a coluna precisam ser do mesmo projeto); `responsavel_id` troca o responsável (`null` tira); `prazo` troca o prazo (`null` apaga; não pode ficar antes do início de nenhuma); `etiqueta_adicionar` põe a etiqueta em quem não a tem e `etiqueta_remover` tira de quem tem. Tudo é conferido antes de gravar: uma tarefa inexistente, subtarefa (com `secao_id`), de outro projeto ou com prazo antes do início recusa o pedido inteiro. A tarefa em que nada muda fica como está. Vale a regra da coluna que conclui do `PATCH /tarefa/{id}`: entrar nela conclui e sair reabre. Cada tarefa alterada ganha as linhas na atividade; o novo responsável e, ao concluir, o criador recebem notificação. Devolve as tarefas pedidas, já atualizadas, na ordem pedida. As tarefas são gravadas uma a uma: se o pedido parar no meio, repeti-lo completa só o que faltou. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais a coluna e as tarefas dele respondem `404`. O responsável sempre enxerga a própria tarefa.
+ *
+ * `PATCH /tarefa/em_massa`
+ */
+export declare function atualizar_em_massa_tarefa(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.TarefaAtualizarEmMassa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Tarefa>>;
+/**
+ * Exclui várias tarefas
+ *
+ * Exige a permissão `deletar` na área `projetos`. Exclusão lógica de 1 a 500 tarefas (`tarefa_ids`, sem repetição) e das subtarefas delas. Tudo é conferido antes de gravar: uma tarefa inexistente ou já excluída recusa o pedido inteiro. As tarefas são excluídas uma a uma: se o pedido parar no meio, repeti-lo com as que sobraram termina a exclusão. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais as tarefas dele respondem `404`. O responsável sempre enxerga a própria tarefa.
+ *
+ * `DELETE /tarefa/em_massa`
+ */
+export declare function deletar_em_massa_tarefa(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.TarefaDeletarEmMassa, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
 /**
  * Busca tarefas por filtro
  *

package/dist/support/rotas.js

@@ -904,6 +904,40 @@ export function buscar_auto_complete_tarefa(credencial_de_acesso, parametros = {
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * Aplica a mesma mudança em várias tarefas
+ *
+ * Exige a permissão `editar` na área `projetos`. Aplica a mesma mudança em 1 a 500 tarefas (`tarefa_ids`, sem repetição), com pelo menos um destes campos: `secao_id` leva as tarefas principais para o fim dessa coluna, na ordem pedida (as tarefas e a coluna precisam ser do mesmo projeto); `responsavel_id` troca o responsável (`null` tira); `prazo` troca o prazo (`null` apaga; não pode ficar antes do início de nenhuma); `etiqueta_adicionar` põe a etiqueta em quem não a tem e `etiqueta_remover` tira de quem tem. Tudo é conferido antes de gravar: uma tarefa inexistente, subtarefa (com `secao_id`), de outro projeto ou com prazo antes do início recusa o pedido inteiro. A tarefa em que nada muda fica como está. Vale a regra da coluna que conclui do `PATCH /tarefa/{id}`: entrar nela conclui e sair reabre. Cada tarefa alterada ganha as linhas na atividade; o novo responsável e, ao concluir, o criador recebem notificação. Devolve as tarefas pedidas, já atualizadas, na ordem pedida. As tarefas são gravadas uma a uma: se o pedido parar no meio, repeti-lo completa só o que faltou. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais a coluna e as tarefas dele respondem `404`. O responsável sempre enxerga a própria tarefa.
+ *
+ * `PATCH /tarefa/em_massa`
+ */
+export function atualizar_em_massa_tarefa(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: "/tarefa/em_massa",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui várias tarefas
+ *
+ * Exige a permissão `deletar` na área `projetos`. Exclusão lógica de 1 a 500 tarefas (`tarefa_ids`, sem repetição) e das subtarefas delas. Tudo é conferido antes de gravar: uma tarefa inexistente ou já excluída recusa o pedido inteiro. As tarefas são excluídas uma a uma: se o pedido parar no meio, repeti-lo com as que sobraram termina a exclusão. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais as tarefas dele respondem `404`. O responsável sempre enxerga a própria tarefa.
+ *
+ * `DELETE /tarefa/em_massa`
+ */
+export function deletar_em_massa_tarefa(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: "/tarefa/em_massa",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
 /**
  * Busca tarefas por filtro
  *

package/dist/support/tipos.d.ts

@@ -665,6 +665,36 @@ export interface TarefaAtualizar {
     secao_id?: string | null;
     titulo?: string | null;
 }
+/**
+ * A mesma mudança em várias tarefas de uma vez (as marcadas no quadro). Pelo menos um campo além de
+ * `tarefa_ids`; o que vem vale para todas.
+ */
+export interface TarefaAtualizarEmMassa {
+    /**
+     * Etiqueta a pôr nas tarefas que ainda não a têm.
+     */
+    etiqueta_adicionar?: string | null;
+    /**
+     * Etiqueta a tirar das tarefas que a têm.
+     */
+    etiqueta_remover?: string | null;
+    /**
+     * Novo prazo; `null` apaga o prazo.
+     */
+    prazo?: string | null;
+    /**
+     * Novo responsável; `null` tira o responsável.
+     */
+    responsavel_id?: string | null;
+    /**
+     * Coluna de destino: só tarefas principais do mesmo projeto da coluna.
+     */
+    secao_id?: string | null;
+    /**
+     * Tarefas (de 1 a 500), na ordem em que entram no fim da coluna quando há `secao_id`.
+     */
+    tarefa_ids: Array<string>;
+}
 export interface TarefaAutoComplete {
     id: string;
     projeto_nome: string;
@@ -695,6 +725,15 @@ export interface TarefaCriar {
     ticket_id?: string | null;
     titulo: string;
 }
+/**
+ * Tarefas para excluir de uma vez.
+ */
+export interface TarefaDeletarEmMassa {
+    /**
+     * Tarefas (de 1 a 500); cada uma sai com as subtarefas dela.
+     */
+    tarefa_ids: Array<string>;
+}
 export interface Ticket {
     anexos_total: number;
     aplicativo: AplicativoResumo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termo_core",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "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>",