termo_core 0.1.16 → 0.1.18

package/dist/flow/rotas.d.ts

@@ -7,6 +7,8 @@ import { type OpcoesDaChamada } from "../base/requisicao.js";
 export interface ParametrosDeBuscarPaginadorRobo {
     pagina?: number;
     tamanho?: number;
+    busca?: string;
+    ativo?: boolean;
 }
 /**
  * Parâmetros de consulta e de cabeçalho de `/robo/autocomplete`.
@@ -27,7 +29,7 @@ export interface ParametrosDeBuscarPeloFiltroRobo {
 /**
  * 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.
+ * 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`
  */
@@ -35,7 +37,7 @@ export declare function buscar_paginador_robo(credencial_de_acesso: CredencialDe
 /**
  * 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`, `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}}`.
+ * 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`
  */
@@ -67,7 +69,7 @@ export declare function buscar_pelo_id_robo(credencial_de_acesso: CredencialDeAc
 /**
  * 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`, `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}}`.
+ * 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

@@ -4,7 +4,7 @@ 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.
+ * 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`
  */
@@ -21,7 +21,7 @@ export function buscar_paginador_robo(credencial_de_acesso, parametros = {}, opc
 /**
  * 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`, `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}}`.
+ * 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`
  */
@@ -88,7 +88,7 @@ export function buscar_pelo_id_robo(credencial_de_acesso, id, 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`, `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}}`.
+ * 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

@@ -5,7 +5,6 @@ export interface PaginaDeRoboAutoComplete {
     total: number;
 }
 export interface PaginaRoboItensItem {
-    atender_contatos_novos: boolean;
     ativo: boolean;
     atualizado_em: string;
     criado_em: string;
@@ -27,7 +26,6 @@ export interface RespostaDeErro {
     erro: string;
 }
 export interface Robo {
-    atender_contatos_novos: boolean;
     ativo: boolean;
     atualizado_em: string;
     criado_em: string;
@@ -40,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;

package/dist/miro/rotas.d.ts

@@ -54,7 +54,7 @@ export declare function buscar_paginador_board(credencial_de_acesso: CredencialD
 /**
  * Cria um board
  *
- * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 5000, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio. Para ler e editar o que fica dentro do board (notas, textos, formas, conectores, cards, tabelas, frames, imagens e traços) use as rotas `/board/{id}/elementos` (listar, criar, atualizar, excluir e organizar); a tela edita o mesmo canvas em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs), e o que a API muda aparece na hora para quem está com o board aberto.
+ * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 5000, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `MEMBROS` (padrão, só o dono e os `membro_ids`) ou `ORGANIZACAO` (todos veem e editam). O canvas nasce vazio. Para ler e editar o que fica dentro do board (notas, textos, formas, conectores, cards, tabelas, frames, imagens e traços) use as rotas `/board/{id}/elementos` (listar, criar, atualizar, excluir e organizar); a tela edita o mesmo canvas em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs), e o que a API muda aparece na hora para quem está com o board aberto.
  *
  * `POST /board`
  */

package/dist/miro/rotas.js

@@ -21,7 +21,7 @@ export function buscar_paginador_board(credencial_de_acesso, parametros = {}, op
 /**
  * Cria um board
  *
- * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 5000, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio. Para ler e editar o que fica dentro do board (notas, textos, formas, conectores, cards, tabelas, frames, imagens e traços) use as rotas `/board/{id}/elementos` (listar, criar, atualizar, excluir e organizar); a tela edita o mesmo canvas em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs), e o que a API muda aparece na hora para quem está com o board aberto.
+ * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 5000, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `MEMBROS` (padrão, só o dono e os `membro_ids`) ou `ORGANIZACAO` (todos veem e editam). O canvas nasce vazio. Para ler e editar o que fica dentro do board (notas, textos, formas, conectores, cards, tabelas, frames, imagens e traços) use as rotas `/board/{id}/elementos` (listar, criar, atualizar, excluir e organizar); a tela edita o mesmo canvas em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs), e o que a API muda aparece na hora para quem está com o board aberto.
  *
  * `POST /board`
  */

package/dist/portal/rotas.d.ts

@@ -149,6 +149,13 @@ export interface ParametrosDeBuscarInformacoesPaginadorCliente {
     unidade_id?: string;
     cursor?: string;
 }
+/**
+ * Parâmetros de consulta e de cabeçalho de `/cliente/telefone`.
+ */
+export interface ParametrosDeBuscarClientesPeloTelefoneCliente {
+    telefone?: string;
+    unidade_id?: string;
+}
 /**
  * Parâmetros de consulta e de cabeçalho de `/contato`.
  */
@@ -308,6 +315,12 @@ export interface ParametrosDeBuscarPeloFiltroIndicadorVenda {
     inicio?: string;
     fim?: string;
 }
+/**
+ * Parâmetros de consulta e de cabeçalho de `/lista_de_preco/filtro`.
+ */
+export interface ParametrosDeBuscarPeloFiltroListaDePreco {
+    unidade_id?: string;
+}
 /**
  * Parâmetros de consulta e de cabeçalho de `/nao_conformidade`.
  */
@@ -660,6 +673,39 @@ export interface ParametrosDeBuscarPeloFiltroUnidade {
     cliente_id?: string;
     pagina?: number;
 }
+/**
+ * Parâmetros de consulta e de cabeçalho de `/unidade_contato`.
+ */
+export interface ParametrosDeBuscarPaginadorUnidadeContato {
+    unidade_id?: string;
+    nome?: string;
+    pagina?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/unidade_contato/autocomplete`.
+ */
+export interface ParametrosDeBuscarAutoCompleteUnidadeContato {
+    busca?: string;
+    unidade_id?: string;
+    pagina?: number;
+    tamanho?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/unidade_contato/filtro`.
+ */
+export interface ParametrosDeBuscarPeloFiltroUnidadeContato {
+    unidade_id?: string;
+    nome?: string;
+    pagina?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/unidade_contato/paginador`.
+ */
+export interface ParametrosDeBuscarInformacoesPaginadorUnidadeContato {
+    unidade_id?: string;
+    nome?: string;
+    pagina?: number;
+}
 /**
  * Lista as categorias com a situação do boletim
  *
@@ -924,6 +970,14 @@ export declare function buscar_pelo_filtro_cliente(credencial_de_acesso: Credenc
  * `GET /cliente/paginador`
  */
 export declare function buscar_informacoes_paginador_cliente(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorCliente, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ClientePaginador>;
+/**
+ * Busca clientes pelo número de telefone
+ *
+ * Acha os clientes de um número de telefone mesmo quando ele está gravado de outro jeito no cadastro. Exige a permissão `ver` no módulo `Configuracoes`; quem não é colaborador interno precisa mandar `unidade_id` de uma unidade da sessão e só vê o cliente dela. Aceita também o token de aplicativo do TermoAuth de um app que atende pelo WhatsApp (hoje só `spark-sell`, o robô do TermoFlow): nesse caso `unidade_id` é ignorado e só vêm os clientes que abrem a sessão de `POST /sessao/whatsapp` (`ativo`, com login e com unidade ativa), cada um só com as unidades ativas; o robô mostra essa lista para o contato escolher a empresa. `telefone` é obrigatório e aceita qualquer formato (`(11) 98765-4321`, `+55 11 98765-4321`, `5511987654321`...): só os dígitos contam. O backend gera as variações do número e procura qualquer uma delas, exata, em `telefone`, `telefone_tiny` e `celular`: com e sem o código do país (`55` e `+55`; o `55` do começo só é lido como código do país quando o número tem 12 ou 13 dígitos, para não confundir com o DDD 55) e, no celular, com e sem o nono dígito (número de 10 dígitos cujo primeiro dígito depois do DDD é de 6 a 9 ganha o 9; número de 11 dígitos com 9 depois do DDD o perde). Telefone fixo não ganha o 9. Número gravado com máscara (parênteses, espaço, traço) não é achado. `unidade_id` (opcional para colaborador interno) restringe ao cliente da unidade. Considera todos os clientes, com ou sem login no portal. Devolve o array dos clientes encontrados, em ordem alfabética do nome, até 50; vazio quando nenhum casa.
+ *
+ * `GET /cliente/telefone`
+ */
+export declare function buscar_clientes_pelo_telefone_cliente(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarClientesPeloTelefoneCliente, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Cliente>>;
 /**
  * Busca o cliente pelo id
  *
@@ -1236,6 +1290,22 @@ export declare function buscar_pelo_filtro_indicador_compra(credencial_de_acesso
  * `GET /indicador_venda/filtro`
  */
 export declare function buscar_pelo_filtro_indicador_venda(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroIndicadorVenda, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.IndicadoresDeVenda>;
+/**
+ * A lista de preço que vale para uma unidade
+ *
+ * Só colaborador interno. O Tiny escolhe a lista em cada pedido: vale a do cadastro do cliente (`origem` = `cadastro`) e, sem ela, a do último pedido não cancelado da unidade ou do CNPJ (`origem` = `ultima_venda`, lida em `GET /sales/order/{id}`). `motivo` explica de onde veio. Lista vazia quando não há nenhuma das duas. `unidade_id` é obrigatório.
+ *
+ * `GET /lista_de_preco/filtro`
+ */
+export declare function buscar_pelo_filtro_lista_de_preco(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroListaDePreco, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.ListaDePrecoDaUnidade>>;
+/**
+ * Uma lista de preço do Tiny, com o preço do portal ao lado
+ *
+ * Só colaborador interno. Lê na hora a API de vendas da Termotubos (`GET /sales/price-list/{id}`, cache de 60 s): nome, `ajuste` geral em % como o Tiny grava, se está ativa e os SKUs com preço próprio (`itens`), cada um com o nome e os preços do produto no portal quando o SKU existe aqui. Só leitura: a lista muda no Tiny. O id da lista do cliente vem em `lista_de_preco_id_tiny` da unidade.
+ *
+ * `GET /lista_de_preco/{id_tiny}`
+ */
+export declare function buscar_pelo_id_lista_de_preco(credencial_de_acesso: CredencialDeAcesso, id_tiny: number, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ListaDePreco>;
 /**
  * Lista as RNCs e ocorrências da qualidade de uma unidade
  *
@@ -1556,6 +1626,14 @@ export declare function buscar_informacoes_paginador_rastreamento(credencial_de_
  * `GET /rastreamento/{id}`
  */
 export declare function buscar_pelo_id_rastreamento(credencial_de_acesso: CredencialDeAcesso, id: number, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Rastreamento>;
+/**
+ * Abre a sessão do cliente pelo WhatsApp
+ *
+ * Rota do robô do TermoFlow: abre uma sessão só de leitura do cliente que fala pelo WhatsApp. Só aceita o token de aplicativo do TermoAuth de um app que atende pelo WhatsApp (hoje só `spark-sell`). `telefone` é o número do contato que chegou pelo webhook, nunca o texto da conversa; aceita qualquer formato e é procurado com as mesmas variações de `GET /cliente/telefone`, em `telefone`, `telefone_tiny` e `celular`. `cliente_id` é o cliente escolhido na lista de `GET /cliente/telefone`: a sessão só abre se esse cliente tiver o telefone no cadastro, estiver `ativo`, com login (`email`) e com ao menos uma unidade ativa. Sem `cliente_id`, abre a do único cliente que atende a isso (mais de um responde `409`). Devolve um token de 30 minutos (`expira_em`) para mandar em `Authorization: Bearer` nas rotas de leitura do cliente; ele só vale no cabeçalho, só em `GET`/`HEAD` e só para as `unidades` do cliente, e cai na hora se o cliente for inativado.
+ *
+ * `POST /sessao/whatsapp`
+ */
+export declare function criar_pelo_whatsapp_sessao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.SessaoDoWhatsappCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.SessaoDoWhatsapp>;
 /**
  * Lista as transportadoras (formas de envio) do Tiny
  *
@@ -1636,3 +1714,67 @@ export declare function atualizar_pelo_id_unidade(credencial_de_acesso: Credenci
  * `DELETE /unidade/{id}`
  */
 export declare function deletar_pelo_id_unidade(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Lista a cópia gravada dos contatos do Tiny
+ *
+ * Só colaborador interno. Lê só a cópia gravada, sem chamar o Tiny (quem atualiza é `GET /unidade_contato/filtro`). Filtros `unidade_id` (sem ele, todas as unidades) e `nome`; ordem alfabética, 50 por página. Totais em `GET /unidade_contato/paginador`.
+ *
+ * `GET /unidade_contato`
+ */
+export declare function buscar_paginador_unidade_contato(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorUnidadeContato, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.UnidadeContato>>;
+/**
+ * Inclui um contato no cadastro do cliente no Tiny
+ *
+ * Só colaborador interno com permissão de editar em Configurações. Grava primeiro no Tiny (`POST /customer/contact` da API de clientes, pelo CNPJ da unidade) e depois relê os contatos do cliente para a cópia. `nome` é obrigatório (até 100); departamento até 50, telefone até 30, ramal até 10 e e-mail válido até 100.
+ *
+ * `POST /unidade_contato`
+ */
+export declare function criar_unidade_contato(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.UnidadeContatoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.UnidadeContato>;
+/**
+ * Id e nome dos contatos gravados, em ordem alfabética
+ *
+ * Só colaborador interno. `busca` filtra por parte do nome; `unidade_id` limita à unidade; `tamanho` vai até 50 (padrão 10).
+ *
+ * `GET /unidade_contato/autocomplete`
+ */
+export declare function buscar_auto_complete_unidade_contato(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteUnidadeContato, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaUnidadeContatoAutoComplete>;
+/**
+ * Contatos da unidade no Tiny, pelo id da unidade
+ *
+ * Só colaborador interno. Lê na hora as pessoas de contato do cadastro do cliente no Tiny (API de clientes da Termotubos: `GET /customer/search?doc_id=<CNPJ da unidade>` e `GET /customer/{id}`), grava a cópia na coleção `unidade_contato` (contato que saiu do Tiny vira excluído) e devolve os contatos da unidade em ordem alfabética, 50 por página (`pagina` começa em 1). `unidade_id` é obrigatório; `nome` filtra por parte do nome. Com a API fora do ar, devolve a última cópia (cada contato traz `sincronizado_em`); sem cópia nenhuma, `502`. Unidade sem CNPJ ou sem cliente no Tiny fica sem contatos (a cópia antiga sai). Gravar exige permissão de editar em Configurações.
+ *
+ * `GET /unidade_contato/filtro`
+ */
+export declare function buscar_pelo_filtro_unidade_contato(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroUnidadeContato, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.UnidadeContato>>;
+/**
+ * Total e páginas dos contatos gravados
+ *
+ * Só colaborador interno. Mesmos filtros de `GET /unidade_contato`.
+ *
+ * `GET /unidade_contato/paginador`
+ */
+export declare function buscar_informacoes_paginador_unidade_contato(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorUnidadeContato, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.UnidadeContatoPaginador>;
+/**
+ * Um contato gravado da unidade
+ *
+ * Só colaborador interno. Lê a cópia gravada, sem chamar o Tiny.
+ *
+ * `GET /unidade_contato/{id}`
+ */
+export declare function buscar_pelo_id_unidade_contato(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.UnidadeContato>;
+/**
+ * Altera um contato no cadastro do cliente no Tiny
+ *
+ * A API do Tiny troca a lista inteira: o portal relê os contatos do cliente na hora, muda só este e manda a lista completa (`PUT /customer/update/{id}`), depois relê a cópia. Campo ausente fica como está; texto vazio apaga. O contato pode voltar com outro `id` se o Tiny trocar o id dele.
+ *
+ * `PATCH /unidade_contato/{id}`
+ */
+export declare function atualizar_pelo_id_unidade_contato(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.UnidadeContatoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.UnidadeContato>;
+/**
+ * Tira um contato do cadastro do cliente no Tiny
+ *
+ * Manda ao Tiny a lista de contatos sem este (`PUT /customer/update/{id}`) e relê a cópia, em que ele fica excluído.
+ *
+ * `DELETE /unidade_contato/{id}`
+ */
+export declare function deletar_pelo_id_unidade_contato(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;

package/dist/portal/rotas.js

@@ -554,6 +554,23 @@ export function buscar_informacoes_paginador_cliente(credencial_de_acesso, param
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * Busca clientes pelo número de telefone
+ *
+ * Acha os clientes de um número de telefone mesmo quando ele está gravado de outro jeito no cadastro. Exige a permissão `ver` no módulo `Configuracoes`; quem não é colaborador interno precisa mandar `unidade_id` de uma unidade da sessão e só vê o cliente dela. Aceita também o token de aplicativo do TermoAuth de um app que atende pelo WhatsApp (hoje só `spark-sell`, o robô do TermoFlow): nesse caso `unidade_id` é ignorado e só vêm os clientes que abrem a sessão de `POST /sessao/whatsapp` (`ativo`, com login e com unidade ativa), cada um só com as unidades ativas; o robô mostra essa lista para o contato escolher a empresa. `telefone` é obrigatório e aceita qualquer formato (`(11) 98765-4321`, `+55 11 98765-4321`, `5511987654321`...): só os dígitos contam. O backend gera as variações do número e procura qualquer uma delas, exata, em `telefone`, `telefone_tiny` e `celular`: com e sem o código do país (`55` e `+55`; o `55` do começo só é lido como código do país quando o número tem 12 ou 13 dígitos, para não confundir com o DDD 55) e, no celular, com e sem o nono dígito (número de 10 dígitos cujo primeiro dígito depois do DDD é de 6 a 9 ganha o 9; número de 11 dígitos com 9 depois do DDD o perde). Telefone fixo não ganha o 9. Número gravado com máscara (parênteses, espaço, traço) não é achado. `unidade_id` (opcional para colaborador interno) restringe ao cliente da unidade. Considera todos os clientes, com ou sem login no portal. Devolve o array dos clientes encontrados, em ordem alfabética do nome, até 50; vazio quando nenhum casa.
+ *
+ * `GET /cliente/telefone`
+ */
+export function buscar_clientes_pelo_telefone_cliente(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/cliente/telefone",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Busca o cliente pelo id
  *
@@ -1205,6 +1222,39 @@ export function buscar_pelo_filtro_indicador_venda(credencial_de_acesso, paramet
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * A lista de preço que vale para uma unidade
+ *
+ * Só colaborador interno. O Tiny escolhe a lista em cada pedido: vale a do cadastro do cliente (`origem` = `cadastro`) e, sem ela, a do último pedido não cancelado da unidade ou do CNPJ (`origem` = `ultima_venda`, lida em `GET /sales/order/{id}`). `motivo` explica de onde veio. Lista vazia quando não há nenhuma das duas. `unidade_id` é obrigatório.
+ *
+ * `GET /lista_de_preco/filtro`
+ */
+export function buscar_pelo_filtro_lista_de_preco(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/lista_de_preco/filtro",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Uma lista de preço do Tiny, com o preço do portal ao lado
+ *
+ * Só colaborador interno. Lê na hora a API de vendas da Termotubos (`GET /sales/price-list/{id}`, cache de 60 s): nome, `ajuste` geral em % como o Tiny grava, se está ativa e os SKUs com preço próprio (`itens`), cada um com o nome e os preços do produto no portal quando o SKU existe aqui. Só leitura: a lista muda no Tiny. O id da lista do cliente vem em `lista_de_preco_id_tiny` da unidade.
+ *
+ * `GET /lista_de_preco/{id_tiny}`
+ */
+export function buscar_pelo_id_lista_de_preco(credencial_de_acesso, id_tiny, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/lista_de_preco/${codificar_parametro_de_caminho(id_tiny)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Lista as RNCs e ocorrências da qualidade de uma unidade
  *
@@ -1875,6 +1925,23 @@ export function buscar_pelo_id_rastreamento(credencial_de_acesso, id, opcoes_da_
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * Abre a sessão do cliente pelo WhatsApp
+ *
+ * Rota do robô do TermoFlow: abre uma sessão só de leitura do cliente que fala pelo WhatsApp. Só aceita o token de aplicativo do TermoAuth de um app que atende pelo WhatsApp (hoje só `spark-sell`). `telefone` é o número do contato que chegou pelo webhook, nunca o texto da conversa; aceita qualquer formato e é procurado com as mesmas variações de `GET /cliente/telefone`, em `telefone`, `telefone_tiny` e `celular`. `cliente_id` é o cliente escolhido na lista de `GET /cliente/telefone`: a sessão só abre se esse cliente tiver o telefone no cadastro, estiver `ativo`, com login (`email`) e com ao menos uma unidade ativa. Sem `cliente_id`, abre a do único cliente que atende a isso (mais de um responde `409`). Devolve um token de 30 minutos (`expira_em`) para mandar em `Authorization: Bearer` nas rotas de leitura do cliente; ele só vale no cabeçalho, só em `GET`/`HEAD` e só para as `unidades` do cliente, e cai na hora se o cliente for inativado.
+ *
+ * `POST /sessao/whatsapp`
+ */
+export function criar_pelo_whatsapp_sessao(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/sessao/whatsapp",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Lista as transportadoras (formas de envio) do Tiny
  *
@@ -2043,3 +2110,137 @@ export function deletar_pelo_id_unidade(credencial_de_acesso, id, opcoes_da_cham
         formato_da_resposta: "sem_conteudo",
     }, opcoes_da_chamada);
 }
+/**
+ * Lista a cópia gravada dos contatos do Tiny
+ *
+ * Só colaborador interno. Lê só a cópia gravada, sem chamar o Tiny (quem atualiza é `GET /unidade_contato/filtro`). Filtros `unidade_id` (sem ele, todas as unidades) e `nome`; ordem alfabética, 50 por página. Totais em `GET /unidade_contato/paginador`.
+ *
+ * `GET /unidade_contato`
+ */
+export function buscar_paginador_unidade_contato(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/unidade_contato",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Inclui um contato no cadastro do cliente no Tiny
+ *
+ * Só colaborador interno com permissão de editar em Configurações. Grava primeiro no Tiny (`POST /customer/contact` da API de clientes, pelo CNPJ da unidade) e depois relê os contatos do cliente para a cópia. `nome` é obrigatório (até 100); departamento até 50, telefone até 30, ramal até 10 e e-mail válido até 100.
+ *
+ * `POST /unidade_contato`
+ */
+export function criar_unidade_contato(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/unidade_contato",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Id e nome dos contatos gravados, em ordem alfabética
+ *
+ * Só colaborador interno. `busca` filtra por parte do nome; `unidade_id` limita à unidade; `tamanho` vai até 50 (padrão 10).
+ *
+ * `GET /unidade_contato/autocomplete`
+ */
+export function buscar_auto_complete_unidade_contato(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/unidade_contato/autocomplete",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Contatos da unidade no Tiny, pelo id da unidade
+ *
+ * Só colaborador interno. Lê na hora as pessoas de contato do cadastro do cliente no Tiny (API de clientes da Termotubos: `GET /customer/search?doc_id=<CNPJ da unidade>` e `GET /customer/{id}`), grava a cópia na coleção `unidade_contato` (contato que saiu do Tiny vira excluído) e devolve os contatos da unidade em ordem alfabética, 50 por página (`pagina` começa em 1). `unidade_id` é obrigatório; `nome` filtra por parte do nome. Com a API fora do ar, devolve a última cópia (cada contato traz `sincronizado_em`); sem cópia nenhuma, `502`. Unidade sem CNPJ ou sem cliente no Tiny fica sem contatos (a cópia antiga sai). Gravar exige permissão de editar em Configurações.
+ *
+ * `GET /unidade_contato/filtro`
+ */
+export function buscar_pelo_filtro_unidade_contato(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/unidade_contato/filtro",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Total e páginas dos contatos gravados
+ *
+ * Só colaborador interno. Mesmos filtros de `GET /unidade_contato`.
+ *
+ * `GET /unidade_contato/paginador`
+ */
+export function buscar_informacoes_paginador_unidade_contato(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/unidade_contato/paginador",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Um contato gravado da unidade
+ *
+ * Só colaborador interno. Lê a cópia gravada, sem chamar o Tiny.
+ *
+ * `GET /unidade_contato/{id}`
+ */
+export function buscar_pelo_id_unidade_contato(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/unidade_contato/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Altera um contato no cadastro do cliente no Tiny
+ *
+ * A API do Tiny troca a lista inteira: o portal relê os contatos do cliente na hora, muda só este e manda a lista completa (`PUT /customer/update/{id}`), depois relê a cópia. Campo ausente fica como está; texto vazio apaga. O contato pode voltar com outro `id` se o Tiny trocar o id dele.
+ *
+ * `PATCH /unidade_contato/{id}`
+ */
+export function atualizar_pelo_id_unidade_contato(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/unidade_contato/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Tira um contato do cadastro do cliente no Tiny
+ *
+ * Manda ao Tiny a lista de contatos sem este (`PUT /customer/update/{id}`) e relê a cópia, em que ele fica excluído.
+ *
+ * `DELETE /unidade_contato/{id}`
+ */
+export function deletar_pelo_id_unidade_contato(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/unidade_contato/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}

package/dist/portal/tipos.d.ts

@@ -649,6 +649,14 @@ export interface IndicadoresDeVenda {
     por_dia: Array<VendaDoDia>;
     por_vendedor: Array<VendaAgrupada>;
 }
+export interface ItemDaListaDePreco {
+    nome?: string | null;
+    preco: number;
+    preco_a_vista_no_portal?: number | null;
+    preco_no_portal?: number | null;
+    preco_promocional?: number | null;
+    sku: string;
+}
 export interface ItemDoPedido {
     adicionais?: Array<AdicionalDoItem>;
     atributos_escolhidos_pela_ia?: Array<string>;
@@ -675,6 +683,19 @@ export interface ItemPedidoVenda {
     quantidade?: number | null;
     sku?: string | null;
 }
+export interface ListaDePreco {
+    ajuste: number;
+    ativa: boolean;
+    id_tiny: number;
+    itens: Array<ItemDaListaDePreco>;
+    nome: string;
+    sincronizada_em?: string | null;
+}
+export interface ListaDePrecoDaUnidade {
+    lista: ListaDePreco;
+    motivo: string;
+    origem: string;
+}
 export interface MensagemNaoConformidade {
     autor?: string | null;
     criada_em?: string | null;
@@ -1091,6 +1112,7 @@ export interface PaginaUnidadeItensItem {
     contato_financeiro?: string | null;
     criado_em: string;
     email_comercial?: string | null;
+    email_nfe?: string | null;
     filiais: Array<UnidadeReferencia>;
     id: string;
     imagem?: string | null;
@@ -1098,10 +1120,12 @@ export interface PaginaUnidadeItensItem {
     inscricao_municipal?: string | null;
     limite_faturamento?: number | null;
     limite_usado: number;
+    lista_de_preco_id_tiny?: number | null;
     matriz_id?: string | null;
     matriz_razao_social?: string | null;
     nome_fantasia?: string | null;
     razao_social: string;
+    regime_tributario?: string | null;
     responsavel_principal?: string | null;
     site?: string | null;
     status: string;
@@ -1124,6 +1148,16 @@ export interface PaginaUnidadeAutoComplete {
     tamanho: number;
     total: number;
 }
+export interface PaginaUnidadeContatoAutoCompleteItensItem {
+    id: string;
+    nome: string;
+}
+export interface PaginaUnidadeContatoAutoComplete {
+    itens: Array<PaginaUnidadeContatoAutoCompleteItensItem>;
+    pagina: number;
+    tamanho: number;
+    total: number;
+}
 export interface PaginadorPedidosVendaTiny {
     contagens: ContagemPedidosVenda;
     pagina: number;
@@ -1525,6 +1559,17 @@ export interface ResumoPedidosVenda {
     pedidos_hoje: number;
     pedidos_no_mes: number;
 }
+export interface SessaoDoWhatsapp {
+    cliente_id: string;
+    expira_em: string;
+    nome: string;
+    token: string;
+    unidades: Array<UnidadeDaSessaoDoWhatsapp>;
+}
+export interface SessaoDoWhatsappCriar {
+    cliente_id?: string | null;
+    telefone: string;
+}
 export interface TopEmpresaPedido {
     documento?: string | null;
     nome: string;
@@ -1580,6 +1625,7 @@ export interface Unidade {
     contato_financeiro?: string | null;
     criado_em: string;
     email_comercial?: string | null;
+    email_nfe?: string | null;
     filiais: Array<UnidadeReferencia>;
     id: string;
     imagem?: string | null;
@@ -1587,10 +1633,12 @@ export interface Unidade {
     inscricao_municipal?: string | null;
     limite_faturamento?: number | null;
     limite_usado: number;
+    lista_de_preco_id_tiny?: number | null;
     matriz_id?: string | null;
     matriz_razao_social?: string | null;
     nome_fantasia?: string | null;
     razao_social: string;
+    regime_tributario?: string | null;
     responsavel_principal?: string | null;
     site?: string | null;
     status: string;
@@ -1619,6 +1667,44 @@ export interface UnidadeAutoComplete {
     id: string;
     razao_social: string;
 }
+export interface UnidadeContato {
+    atualizado_em: string;
+    criado_em: string;
+    departamento?: string | null;
+    email?: string | null;
+    id: string;
+    id_api: number;
+    id_tiny?: number | null;
+    nome: string;
+    ramal?: string | null;
+    sincronizado_em: string;
+    telefone?: string | null;
+    unidade_id: string;
+}
+export interface UnidadeContatoAtualizar {
+    departamento?: string | null;
+    email?: string | null;
+    nome?: string | null;
+    ramal?: string | null;
+    telefone?: string | null;
+}
+export interface UnidadeContatoAutoComplete {
+    id: string;
+    nome: string;
+}
+export interface UnidadeContatoCriar {
+    departamento?: string | null;
+    email?: string | null;
+    nome: string;
+    ramal?: string | null;
+    telefone?: string | null;
+    unidade_id: string;
+}
+export interface UnidadeContatoPaginador {
+    paginas: number;
+    tamanho: number;
+    total: number;
+}
 export interface UnidadeCriar {
     aviso_limite_percentual?: number | null;
     cnpj: string;
@@ -1638,6 +1724,11 @@ export interface UnidadeCriar {
     tiny?: UnidadeCriarTiny | null;
 }
 export type UnidadeCriarTiny = Record<string, unknown>;
+export interface UnidadeDaSessaoDoWhatsapp {
+    cnpj: string;
+    id: string;
+    razao_social: string;
+}
 export interface UnidadeDoCliente {
     cnpj: string;
     id: string;

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.16",
+  "version": "0.1.18",
   "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>",