termo_core 0.1.3 → 0.1.4

package/dist/flow/rotas.d.ts

@@ -1,719 +1,6 @@
 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 `/auth`.
- */
-export interface ParametrosDeBuscarPaginadorAuth {
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/auth/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteAuth {
-    busca?: string;
-    perfil?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/auth/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroAuth {
-    email?: string;
-    perfil?: string;
-    ativo?: boolean;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/cliente`.
- */
-export interface ParametrosDeBuscarPaginadorCliente {
-    pagina?: number;
-    tamanho?: number;
-    busca?: string;
-    ativo?: boolean;
-    atendente_ativo?: boolean;
-    estados?: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/cliente/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteCliente {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/cliente/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroCliente {
-    razao_social?: string;
-    cnpj?: string;
-    email?: string;
-    cidade?: string;
-    estado?: string;
-    telefone?: string;
-    ativo?: boolean;
-    atendente_ativo?: boolean;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/colaborador`.
- */
-export interface ParametrosDeBuscarPaginadorColaborador {
-    pagina?: number;
-    tamanho?: number;
-    nome?: string;
-    setor?: string;
-    cargo?: string;
-    ativo?: boolean;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/colaborador/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteColaborador {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/colaborador/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroColaborador {
-    busca?: string;
-    nome?: string;
-    email?: string;
-    setor?: string;
-    cargo?: string;
-    ativo?: boolean;
-    perfil_acesso_id?: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/config_system_chatwoot`.
- */
-export interface ParametrosDeBuscarPaginadorConfigSystemChatwoot {
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/config_system_chatwoot/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteConfigSystemChatwoot {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/config_system_chatwoot/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroConfigSystemChatwoot {
-    nome?: string;
-    endereco?: string;
-    ativo?: boolean;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/config_system_whatsapp/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteConfigSystemWhatsapp {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/config_system_z_api/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteConfigSystemZApi {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/conversa`.
- */
-export interface ParametrosDeBuscarPaginadorConversa {
-    pagina?: number;
-    tamanho?: number;
-    status?: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/conversa/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteConversa {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/conversa/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroConversa {
-    cliente_id?: string;
-    robo_id?: string;
-    config_system_z_api_id?: string;
-    chatwoot_conversa_id?: number;
-    status?: string;
-    contato?: string;
-    texto?: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/dashboard/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroDashboard {
-    dias?: number;
-    robo_id?: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso`.
- */
-export interface ParametrosDeBuscarPaginadorPerfilAcesso {
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompletePerfilAcesso {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/perfil_acesso/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroPerfilAcesso {
-    nome?: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/robo`.
- */
-export interface ParametrosDeBuscarPaginadorRobo {
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/robo/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteRobo {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/robo/equipes`.
- */
-export interface ParametrosDeBuscarEquipesRobo {
-    robo_id?: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/robo/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroRobo {
-    nome?: string;
-    modelo?: string;
-    ativo?: boolean;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/robo_ferramenta`.
- */
-export interface ParametrosDeBuscarPaginadorRoboFerramenta {
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/robo_ferramenta/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteRoboFerramenta {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/robo_ferramenta/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroRoboFerramenta {
-    nome?: string;
-    tipo?: string;
-    ativo?: boolean;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/webhooks/chatwoot`.
- */
-export interface ParametrosDeReceberEventoChatwootWebhooks {
-    /**
-     * Segredo do webhook que o TermoSell gerou e embutiu no endereço cadastrado no serviço externo
-     */
-    segredo: string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/webhooks/termowebhook`.
- */
-export interface ParametrosDeReceberEventoTermoWebhookWebhooks {
-    /**
-     * Horário Unix em segundos usado na assinatura
-     *
-     * Enviado no cabeçalho `X-TermoWebhook-Data`.
-     */
-    "X-TermoWebhook-Data": number;
-    /**
-     * Id (kid) da chave do hub que assinou a entrega
-     *
-     * Enviado no cabeçalho `X-TermoWebhook-Chave`.
-     */
-    "X-TermoWebhook-Chave": string;
-    /**
-     * Id do aplicativo destino no hub, que precisa ser o do TermoSell
-     *
-     * Enviado no cabeçalho `X-TermoWebhook-Destino`.
-     */
-    "X-TermoWebhook-Destino": string;
-    /**
-     * `ed25519=<base64url>` da assinatura de `<data>.<destino>.<corpo>`
-     *
-     * Enviado no cabeçalho `X-TermoWebhook-Assinatura`.
-     */
-    "X-TermoWebhook-Assinatura": string;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/webhooks/z_api`.
- */
-export interface ParametrosDeReceberEventoZApiWebhooks {
-    /**
-     * Segredo do webhook que o TermoSell gerou e embutiu no endereço cadastrado no serviço externo
-     */
-    segredo: string;
-}
-/**
- * Versão do backend no ar
- *
- * Pública, sem token. Devolve `sucesso: true` e a versão do backend publicada, no formato semver.
- *
- * `GET /`
- */
-export declare function buscar_versao_test(opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.VersaoDoBackend>;
-/**
- * Lista os acessos com paginação
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Ordena por perfil e depois por e-mail. Acessos excluídos não aparecem. `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 registros não excluídos.
- *
- * `GET /auth`
- */
-export declare function buscar_paginador_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAuth>;
-/**
- * Cria um acesso
- *
- * Exige a permissão `criar` da área `colaboradores`. Cadastra quem pode entrar no TermoSell. `email` é obrigatório, com até 160 caracteres, e é gravado em minúsculas, sem espaços nas pontas; `perfil` é `colaborador` ou `cliente`. O acesso nasce ativo e sem nenhuma permissão. Para a pessoa conseguir entrar, o e-mail precisa ser `@termotubos.com.br` e existir no TermoAuth com o mesmo endereço. Para cadastrar um cliente, prefira `POST /cliente`, que cria o acesso junto.
- *
- * `POST /auth`
- */
-export declare function criar_auth(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AuthCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
-/**
- * Busca o acesso de quem está logado
- *
- * Livre para qualquer usuário autenticado com acesso ativo, mesmo sem nenhuma permissão liberada. Devolve o acesso de quem chamou (id, e-mail, nome, perfil e se é master do TermoAuth) e as permissões por área (`clientes`, `colaboradores` e `configuracoes`), cada uma com `ler`, `criar`, `editar` e `deletar`. Um master do TermoAuth recebe todas as permissões e, no primeiro pedido, ganha o acesso e o colaborador automaticamente. `nome` vem do TermoAuth e, se estiver vazio, repete o e-mail. É a chamada que o painel faz antes de mostrar qualquer tela.
- *
- * `GET /auth/acesso`
- */
-export declare function buscar_acesso_auth(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.AcessoAtual>;
-/**
- * Lista básica de acessos para seleção
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve só id, e-mail e perfil, em ordem alfabética de e-mail, para escolher um acesso. `busca` procura por trecho do e-mail, sem diferenciar maiúsculas; `perfil` compara o valor exato. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /auth/autocomplete`
- */
-export declare function buscar_auto_complete_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAuthAutoComplete>;
-/**
- * Busca acessos por filtro
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve todos os acessos que casam com o filtro, sem paginação, em ordem alfabética de e-mail. `email` procura por trecho, sem diferenciar maiúsculas; `perfil` compara o valor exato (`colaborador` ou `cliente`); `ativo` filtra pela situação. Sem filtro, devolve todos. Acessos excluídos não aparecem.
- *
- * `GET /auth/filtro`
- */
-export declare function buscar_pelo_filtro_auth(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAuth, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Auth>>;
-/**
- * Busca um acesso pelo id
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Acesso excluído responde `404`. `vinculado` diz se há um colaborador ou um cliente ligado ao acesso, e `nome` é o nome desse colaborador ou a razão social desse cliente. `master` diz se a pessoa é master do TermoAuth.
- *
- * `GET /auth/{id}`
- */
-export declare function buscar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
-/**
- * Atualiza um acesso pelo id
- *
- * Exige a permissão `editar` da área `colaboradores`. Atualização parcial: só os campos enviados mudam. `email` (até 160 caracteres, gravado em minúsculas) e `ativo` (acesso inativo é barrado em todas as rotas). O perfil não muda. O acesso de um master do TermoAuth não pode ser alterado.
- *
- * `PATCH /auth/{id}`
- */
-export declare function atualizar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.AuthAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Auth>;
-/**
- * Exclui um acesso pelo id
- *
- * Exige a permissão `deletar` da área `colaboradores`. A exclusão é lógica: o acesso some das consultas e a pessoa deixa de entrar, mas o registro fica guardado e não há como restaurar. Acesso com colaborador ou cliente vinculado não pode ser excluído por aqui (exclua o cliente, que leva o acesso junto). O acesso de um master do TermoAuth não pode ser excluído.
- *
- * `DELETE /auth/{id}`
- */
-export declare function deletar_pelo_id_auth(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista os clientes com paginação
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Ordena pela razão social. `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 registros não excluídos.
- *
- * `GET /cliente`
- */
-export declare function buscar_paginador_cliente(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorCliente, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaCliente>;
-/**
- * Cadastra um cliente
- *
- * Exige a permissão `criar` da área `clientes`. Cria o cliente e, na mesma transação, o acesso dele com perfil `cliente` e o `email` informado. Obrigatórios: `razao_social` (até 150 caracteres), `cnpj` (exatamente 14 dígitos, só números; pode se repetir, porque a intranet repete CNPJ) e `email` (até 160 caracteres, gravado em minúsculas). Opcionais: `nome_fantasia` (até 150), `telefone` (até 20; é por ele que o robô reconhece o cliente no WhatsApp), `cidade` (até 120) e `estado` (2 letras, gravado em maiúsculas). Texto vazio nos opcionais vira `null`. O cliente nasce ativo e com `atendente_ativo` desligado.
- *
- * `POST /cliente`
- */
-export declare function criar_cliente(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ClienteCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Cliente>;
-/**
- * Lista básica de clientes para seleção
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Devolve só id, razão social e CNPJ, em ordem alfabética da razão social. `busca` procura o trecho na razão social (sem diferenciar maiúsculas) ou no CNPJ. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /cliente/autocomplete`
- */
-export declare function buscar_auto_complete_cliente(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteCliente, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaClienteAutoComplete>;
-/**
- * Busca clientes por filtro
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Devolve todos os clientes que casam com o filtro, sem paginação, em ordem alfabética da razão social. `razao_social` procura o trecho na razão social ou no nome fantasia; `email` e `cidade` procuram por trecho; todos sem diferenciar maiúsculas. `cnpj` procura o trecho no CNPJ (só dígitos); `telefone` compara só os dígitos, por trecho; `estado` compara a sigla exata; `ativo` e `atendente_ativo` filtram pela situação. Sem filtro, devolve todos.
- *
- * `GET /cliente/filtro`
- */
-export declare function buscar_pelo_filtro_cliente(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroCliente, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Cliente>>;
-/**
- * Status da sincronização dos clientes com o TermoIntranetAPI
- *
- * Só para o master do TermoAuth. Devolve a sincronização em andamento ou a última que terminou: `rodando`, `paginas` gravadas, `cancelada`, `erro` (sem permissão no TermoIntranetAPI, indisponibilidade ou falha no banco) e os totais em `resultado`. O status fica em memória e se perde se o servidor reiniciar; o que já foi gravado fica.
- *
- * `GET /cliente/sincronizar`
- */
-export declare function buscar_sincronizacao_cliente(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusDaSincronizacao>;
-/**
- * Inicia a sincronização dos clientes com o TermoIntranetAPI em segundo plano
- *
- * Só para o master do TermoAuth. Percorre toda a lista de clientes do TermoIntranetAPI (`GET /cliente`, paginada por cursor) usando o próprio token de quem chamou e grava aqui: entra todo cliente, pessoa física ou jurídica, com ou sem documento (`cnpj` guarda só os dígitos do CPF ou CNPJ, ou fica vazio); `ignorados` conta só o id repetido na mesma página. Cliente que já existe com o mesmo CNPJ e ainda sem vínculo recebe o `intranet_cliente_id`; cliente já vinculado tem razão social, nome fantasia, telefone (celular, ou telefone fixo na falta dele, só dígitos), e-mail, cidade e estado sobrescritos pela intranet; cliente novo é criado com `atendente_ativo` desligado. Os campos do TermoSell (`ativo` e `atendente_ativo`) nunca são tocados. Roda em segundo plano no servidor e grava cada página no banco assim que chega: a tela pode ser fechada. Responde 202 com o status inicial; acompanhe por `GET /cliente/sincronizar`. Sem corpo.
- *
- * `POST /cliente/sincronizar`
- */
-export declare function sincronizar_com_intranet_cliente(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusDaSincronizacao>;
-/**
- * Cancela a sincronização dos clientes em andamento
- *
- * Só para o master do TermoAuth. Para antes da próxima página; o que já foi gravado fica.
- *
- * `DELETE /cliente/sincronizar`
- */
-export declare function cancelar_sincronizacao_cliente(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Busca um cliente pelo id
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Devolve o cliente com o e-mail do acesso e o `ultimo_pedido` dele na intranet (`null` quando não foi possível consultar). Cliente excluído responde `404`.
- *
- * `GET /cliente/{id}`
- */
-export declare function buscar_pelo_id_cliente(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ClienteDetalhe>;
-/**
- * Atualiza um cliente pelo id
- *
- * Exige a permissão `editar` da área `clientes`. Atualização parcial: só os campos enviados mudam. `razao_social` não pode ficar vazia (até 150 caracteres); `nome_fantasia` (até 150), `telefone` (até 20), `cidade` (até 120) e `estado` (2 letras) aceitam texto vazio para apagar o valor. `ativo` liga ou desliga o cliente e `atendente_ativo` liga ou desliga o atendimento pelo robô no WhatsApp: o robô só responde cliente ativo com `atendente_ativo` ligado; os demais vão direto para a equipe. CNPJ e e-mail não mudam por aqui.
- *
- * `PATCH /cliente/{id}`
- */
-export declare function atualizar_pelo_id_cliente(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ClienteAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Cliente>;
-/**
- * Exclui um cliente pelo id
- *
- * Exige a permissão `deletar` da área `clientes`. A exclusão é lógica e leva junto o acesso do cliente, na mesma transação: os dois somem das consultas, o CNPJ e o e-mail ficam livres para um novo cadastro e não há como restaurar.
- *
- * `DELETE /cliente/{id}`
- */
-export declare function deletar_pelo_id_cliente(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista os colaboradores com paginação
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Ordena por nome. Quando quem chama é master do TermoAuth, antes de listar o TermoSell busca no TermoAuth os colaboradores `@termotubos.com.br` que ainda não existem aqui e os cadastra sem nenhuma permissão. `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 registros não excluídos.
- *
- * `GET /colaborador`
- */
-export declare function buscar_paginador_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaborador>;
-/**
- * Lista básica de colaboradores para seleção
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e e-mail, em ordem alfabética de nome. `busca` procura por trecho do nome ou do e-mail, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /colaborador/autocomplete`
- */
-export declare function buscar_auto_complete_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaboradorAutoComplete>;
-/**
- * Busca colaboradores por filtro
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve todos os colaboradores que casam com o filtro, sem paginação, em ordem alfabética de nome. `busca` procura por trecho do nome ou do e-mail (a busca rápida da tela); `nome`, `email` e `cargo` procuram por trecho, sem diferenciar maiúsculas; `ativo` filtra pela situação; `perfil_acesso_id` filtra pelo perfil de acesso. Sem filtro, devolve todos. O colaborador é do TermoAuth: aqui ele só é lido (chega pela sincronização e pelos eventos do TermoWebhook) e `setor`, `cargo` e `funcao` vêm de lá.
- *
- * `GET /colaborador/filtro`
- */
-export declare function buscar_pelo_filtro_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Colaborador>>;
-/**
- * Busca um colaborador pelo id
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve o colaborador com o e-mail e o `master` do acesso dele. Colaborador excluído responde `404`. O colaborador é do TermoAuth: aqui ele só é lido (chega pela sincronização e pelos eventos do TermoWebhook) e `setor`, `cargo` e `funcao` vêm de lá.
- *
- * `GET /colaborador/{id}`
- */
-export declare function buscar_pelo_id_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
-/**
- * Define o perfil de acesso de um colaborador
- *
- * Exige a permissão `editar` da área `colaboradores`. É a única escrita do colaborador feita pelo TermoSell: `perfil_acesso_id` aponta para um perfil de `GET /perfil_acesso/filtro` e passa a definir o que a pessoa enxerga; `null` tira o perfil e deixa a pessoa sem nenhuma área. O colaborador de um master do TermoAuth não aceita perfil (ele já tem tudo). Vale em até 5 minutos (cache do acesso).
- *
- * `PATCH /colaborador/{id}/perfil_acesso`
- */
-export declare function vincular_perfil_acesso_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ColaboradorVincularPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
-/**
- * Lista as configurações do Chatwoot com paginação
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Ordena por nome. Para cada item, consulta o Chatwoot na hora: `chave_valida` diz se o token de acesso funcionou e `erro_chave` traz o motivo da recusa. `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 registros não excluídos. O token de acesso nunca volta: as respostas trazem só `token_acesso_mascarado`.
- *
- * `GET /config_system_chatwoot`
- */
-export declare function buscar_paginador_config_system_chatwoot(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorConfigSystemChatwoot, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConfigSystemChatwootValidada>;
-/**
- * Conecta a conta do Chatwoot
- *
- * Exige a permissão `criar` da área `configuracoes`. Aceita quantas contas do Chatwoot forem precisas; o `nome` e o par `endereco` + `conta_id` não se repetem (`409`). `nome` (até 100 caracteres), `endereco` do Chatwoot (`http://` ou `https://`, até 200), `conta_id` (maior que zero), `token_acesso` (de 8 a 200 caracteres) e `endereco_publico` (o endereço `https://` deste backend que o Chatwoot vai chamar, até 200) são obrigatórios. Antes de gravar, cria no Chatwoot o robô de atendimento que avisa o TermoSell das mensagens; se o Chatwoot recusar, responde `400` com o motivo. A configuração nasce ativa. O token de acesso nunca volta: as respostas trazem só `token_acesso_mascarado`.
- *
- * `POST /config_system_chatwoot`
- */
-export declare function criar_config_system_chatwoot(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ConfigSystemChatwootCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ConfigSystemChatwoot>;
-/**
- * Lista básica de configurações do Chatwoot para seleção
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e endereço das configurações ativas, em ordem alfabética de nome. `busca` procura por trecho do nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /config_system_chatwoot/autocomplete`
- */
-export declare function buscar_auto_complete_config_system_chatwoot(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteConfigSystemChatwoot, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConfigSystemChatwootAutoComplete>;
-/**
- * Busca configurações do Chatwoot por filtro
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve todas as configurações que casam com o filtro, sem paginação, em ordem alfabética de nome. `nome` e `endereco` procuram por trecho, sem diferenciar maiúsculas; `ativo` filtra pela situação. O token de acesso nunca volta: as respostas trazem só `token_acesso_mascarado`.
- *
- * `GET /config_system_chatwoot/filtro`
- */
-export declare function buscar_pelo_filtro_config_system_chatwoot(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroConfigSystemChatwoot, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.ConfigSystemChatwoot>>;
-/**
- * Busca a configuração do Chatwoot pelo id
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Configuração excluída responde `404`. `robo_chatwoot_id` é o id do robô de atendimento criado no Chatwoot. O token de acesso nunca volta: as respostas trazem só `token_acesso_mascarado`.
- *
- * `GET /config_system_chatwoot/{id}`
- */
-export declare function buscar_pelo_id_config_system_chatwoot(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ConfigSystemChatwoot>;
-/**
- * Atualiza a configuração do Chatwoot pelo id
- *
- * Exige a permissão `editar` da área `configuracoes`. Atualização parcial: só `nome` (até 100), `token_acesso` (de 8 a 200), `endereco_publico` (`https://`, até 200) e `ativo` mudam; o endereço e a conta do Chatwoot não. Trocar o token ou o endereço público atualiza antes o robô de atendimento no Chatwoot, e trocar o endereço público também refaz o webhook de cada número da Z-API ligado a esta conta; se o Chatwoot ou a Z-API recusarem, nada é gravado e a resposta é `400` com o motivo. O token de acesso nunca volta: as respostas trazem só `token_acesso_mascarado`.
- *
- * `PATCH /config_system_chatwoot/{id}`
- */
-export declare function atualizar_pelo_id_config_system_chatwoot(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ConfigSystemChatwootAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ConfigSystemChatwoot>;
-/**
- * Exclui a configuração do Chatwoot pelo id
- *
- * Exige a permissão `deletar` da área `configuracoes`. A exclusão é lógica e não há como restaurar. Só exclui a configuração que não tem números de WhatsApp (Z-API) vinculados; exclua ou desvincule os números antes.
- *
- * `DELETE /config_system_chatwoot/{id}`
- */
-export declare function deletar_pelo_id_config_system_chatwoot(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista básica dos números de WhatsApp conectados por QR Code para seleção
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e número (vazio até o celular ler o QR Code) de cada número conectado pelo QR Code, em ordem alfabética de nome. `busca` procura o trecho no nome (sem diferenciar maiúsculas) ou no número. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /config_system_whatsapp/autocomplete`
- */
-export declare function buscar_auto_complete_config_system_whatsapp(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteConfigSystemWhatsapp, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConfigSystemWhatsappAutoComplete>;
-/**
- * Exclui um número de WhatsApp conectado por QR Code pelo id
- *
- * Exige a permissão `deletar` da área `configuracoes`. Desvincula o aparelho do celular (some de "Aparelhos conectados"), apaga a sessão guardada e faz a exclusão lógica, sem como restaurar: o TermoSell deixa de atender as mensagens que chegam pelo número.
- *
- * `DELETE /config_system_whatsapp/{id}`
- */
-export declare function deletar_pelo_id_config_system_whatsapp(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista básica dos números de WhatsApp (Z-API) para seleção
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e número de cada número de WhatsApp conectado pela Z-API, em ordem alfabética de nome. `busca` procura o trecho no nome (sem diferenciar maiúsculas) ou no número. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /config_system_z_api/autocomplete`
- */
-export declare function buscar_auto_complete_config_system_z_api(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteConfigSystemZApi, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConfigSystemZApiAutoComplete>;
-/**
- * Exclui um número de WhatsApp (Z-API) pelo id
- *
- * Exige a permissão `deletar` da área `configuracoes`. A exclusão é lógica e não há como restaurar: o número some das consultas e o TermoSell deixa de atender as mensagens que chegam por ele.
- *
- * `DELETE /config_system_z_api/{id}`
- */
-export declare function deletar_pelo_id_config_system_z_api(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Mostra a configuração do app (segredo do TermoAuth)
- *
- * Só um master do TermoAuth. O segredo do app gerado no TermoAuth nunca volta: a resposta traz só `configurado` e os últimos caracteres mascarados em `final_visivel`. `criptografia_disponivel` é falso quando o servidor está sem a `GLOBAL_SECRET_CRIPTOGRAFIA`; nesse caso nada pode ser lido nem gravado. `atualizado_em` é nulo enquanto ninguém gravou a configuração.
- *
- * `GET /configuracao`
- */
-export declare function buscar_pelo_id_configuracao(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Configuracao>;
-/**
- * Grava o segredo do app gerado no TermoAuth
- *
- * Só um master do TermoAuth. Campo ausente fica como está, texto troca e `null` limpa. O segredo é gravado cifrado (AES-256-GCM com a `GLOBAL_SECRET_CRIPTOGRAFIA`) e entregue na hora ao `termo_core`, sem deploy. Até 2.000 caracteres, sem quebra de linha.
- *
- * `PATCH /configuracao`
- */
-export declare function atualizar_pelo_id_configuracao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ConfiguracaoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Configuracao>;
-/**
- * Lista as conversas com paginação
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Ordena da última mensagem mais recente para a mais antiga. `pagina` começa em 1 (padrão 1; valores menores viram 1). A página tem sempre 50 itens: `tamanho` é aceito, mas ignorado. `status` (opcional) limita a um status. `total` conta os registros não excluídos que casam com o `status`.
- *
- * `GET /conversa`
- */
-export declare function buscar_paginador_conversa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorConversa, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConversa>;
-/**
- * Não cria conversa pela tela
- *
- * Exige a permissão `criar` da área `clientes`, mas responde sempre `403`: a conversa é registrada pelos webhooks do Chatwoot e da Z-API, que gravam toda mensagem visível que passa pela conta do Chatwoot. Sem corpo.
- *
- * `POST /conversa`
- */
-export declare function criar_conversa(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista básica de conversas para seleção
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Devolve só id, id da conversa no Chatwoot, nome e telefone do contato, em ordem alfabética do nome do contato. `busca` procura o trecho no nome do contato (sem diferenciar maiúsculas) ou no telefone. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /conversa/autocomplete`
- */
-export declare function buscar_auto_complete_conversa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteConversa, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConversaAutoComplete>;
-/**
- * Busca conversas por filtro
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Devolve até 500 conversas que casam com o filtro, da última mensagem mais recente para a mais antiga. `cliente_id`, `robo_id`, `config_system_z_api_id` e `chatwoot_conversa_id` comparam o valor exato; `status` compara o status exato; `contato` procura o trecho no nome do contato, na razão social do cliente ou nos dígitos do telefone; `texto` procura o trecho no conteúdo de qualquer mensagem da conversa; todos sem diferenciar maiúsculas. Sem filtro, devolve as 500 mais recentes. É por `cliente_id` que a guia "Histórico de conversas" do cliente lê o histórico.
- *
- * `GET /conversa/filtro`
- */
-export declare function buscar_pelo_filtro_conversa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroConversa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Conversa>>;
-/**
- * Busca uma conversa pelo id
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Devolve a conversa do histórico interno com o nome do número do WhatsApp, do cliente e do robô, o `status` espelhado do Chatwoot (`pending` com o robô, `open` com a equipe, `resolved`, `snoozed`), a etapa atual do fluxo, a última mensagem de cada lado, `transferida_em`/`transferida_motivo` (`sem_resposta` quando o gatilho passou a conversa para a equipe), `quantidade_mensagens` e `chatwoot_endereco_conversa` (link da conversa no painel do Chatwoot). Datas em RFC 3339. Conversa excluída responde `404`.
- *
- * `GET /conversa/{id}`
- */
-export declare function buscar_pelo_id_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
-/**
- * Atualiza uma conversa pelo id
- *
- * Exige a permissão `editar` da área `clientes`. Atualização parcial: só os campos enviados mudam. `cliente_id` vincula a conversa a um cliente, `robo_id` a um robô e `status` corrige o status gravado (`pending`, `open`, `resolved` ou `snoozed`) sem alterar nada no Chatwoot. As mensagens e os demais campos vêm só dos webhooks.
- *
- * `PATCH /conversa/{id}`
- */
-export declare function atualizar_pelo_id_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ConversaAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Conversa>;
-/**
- * Exclui uma conversa do histórico pelo id
- *
- * Exige a permissão `deletar` da área `clientes`. A exclusão é lógica e leva junto as mensagens, na mesma transação: a conversa some do histórico interno e não há como restaurar. A conversa no Chatwoot não é alterada; uma mensagem nova dela cria um registro novo no histórico.
- *
- * `DELETE /conversa/{id}`
- */
-export declare function deletar_pelo_id_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista as mensagens de uma conversa
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Devolve as mensagens gravadas no histórico interno, em ordem de envio, sem as notas privadas da equipe. `autor` é `contato`, `atendente` ou `robo`; `etapa_id` é a etapa do fluxo em que o robô mandou a mensagem; `criada_em` é a data de criação no Chatwoot, em RFC 3339. `anexos` lista os arquivos da mensagem (`tipo` do Chatwoot, `nome`, `endereco` no Chatwoot); cada um é copiado para o TermoBucket (arquivo privado do app `spark-sell`) logo depois do webhook e, quando já está lá, traz `arquivo_id`, `tipo_mime`, `tamanho` e `url`, o download assinado por 15 minutos. O que falhar é tentado de novo a cada 30 minutos, até 5 vezes.
- *
- * `GET /conversa/{id}/mensagens`
- */
-export declare function buscar_mensagens_conversa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.ConversaMensagem>>;
-/**
- * Indicadores gerenciais do atendimento
- *
- * Exige qualquer permissão da área `clientes` (qualquer ação liberada na área já libera a leitura). Monta o painel do atendimento a partir do histórico interno de conversas. `dias` é o período (padrão 30, entre 1 e 365) contado em dias inteiros no horário de Brasília, de `inicio` até agora; `robo_id` (opcional) limita às conversas de um robô. `indicadores` traz as conversas novas do período e do período anterior de mesmo tamanho, as conversas e os clientes com mensagem do contato no período, as mensagens recebidas, do robô e da equipe, as conversas novas que passaram para a equipe (transferidas, abertas ou com mensagem de atendente), as resolvidas só pelo robô, as transferidas pelo gatilho de cliente sem resposta, as conversas em aberto cuja última mensagem é do contato e a mediana, em segundos, da primeira resposta (qualquer lado) e da primeira resposta da equipe. `situacao_atual` conta todas as conversas por `status`, sem recorte de período. `por_dia` e `por_hora` distribuem as mensagens no horário de Brasília; `por_robo` e `por_canal` agrupam as conversas; `aguardando_resposta` lista as 10 conversas em aberto que esperam resposta há mais tempo.
- *
- * `GET /dashboard/filtro`
- */
-export declare function buscar_pelo_filtro_dashboard(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroDashboard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Dashboard>;
-/**
- * Lista os perfis de acesso com paginação
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Ordena pelo 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 registros não excluídos.
- *
- * `GET /perfil_acesso`
- */
-export declare function buscar_paginador_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfilAcesso>;
-/**
- * Cria um perfil de acesso
- *
- * Exige a permissão `criar` da área `colaboradores`. O perfil de acesso é o conjunto de permissões que o TermoSell dá a um colaborador: cada colaborador aponta para um perfil (`PATCH /colaborador/{id}/perfil_acesso`) e enxerga o que o perfil libera. `nome` é obrigatório (até 80 caracteres, único sem diferenciar maiúsculas); `descricao` é opcional (até 200); `permissoes` traz, para cada área (`clientes`, `colaboradores`, `configuracoes`), as ações `ler`, `criar`, `editar` e `deletar` (o que não vier fica `false`). A resposta inclui `colaboradores`, quantas pessoas usam o perfil. O master do TermoAuth tem tudo liberado sem precisar de perfil.
- *
- * `POST /perfil_acesso`
- */
-export declare function criar_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.PerfilAcessoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
-/**
- * Lista básica de perfis de acesso para seleção
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve só o id e o nome, em ordem alfabética. `busca` procura por trecho do nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /perfil_acesso/autocomplete`
- */
-export declare function buscar_auto_complete_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompletePerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfilAcessoAutoComplete>;
-/**
- * Busca perfis de acesso por filtro
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Devolve todos os perfis que casam com o filtro, sem paginação, em ordem alfabética de nome. `nome` procura por trecho, sem diferenciar maiúsculas. Sem filtro, devolve todos (é o que a tela usa para listar e para escolher o perfil de um colaborador).
- *
- * `GET /perfil_acesso/filtro`
- */
-export declare function buscar_pelo_filtro_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroPerfilAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.PerfilAcesso>>;
-/**
- * Busca um perfil de acesso pelo id
- *
- * Exige qualquer permissão da área `colaboradores` (qualquer ação liberada na área já libera a leitura). Perfil excluído responde `404`.
- *
- * `GET /perfil_acesso/{id}`
- */
-export declare function buscar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
-/**
- * Atualiza um perfil de acesso pelo id
- *
- * Exige a permissão `editar` da área `colaboradores`. Atualização parcial: só os campos enviados mudam. `nome` segue o limite do cadastro; `descricao` vazia apaga o valor; `permissoes`, quando enviado, substitui o conjunto inteiro (o que não vier fica `false`). Todo colaborador do perfil passa a valer com as novas permissões em até 5 minutos (cache do acesso).
- *
- * `PATCH /perfil_acesso/{id}`
- */
-export declare function atualizar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.PerfilAcessoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PerfilAcesso>;
-/**
- * Exclui um perfil de acesso pelo id
- *
- * Exige a permissão `deletar` da área `colaboradores`. A exclusão é lógica e só é aceita quando nenhum colaborador usa o perfil: com gente vinculada responde `409`, e é preciso trocar o perfil dessas pessoas antes.
- *
- * `DELETE /perfil_acesso/{id}`
- */
-export declare function deletar_pelo_id_perfil_acesso(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista os robôs com paginação
- *
- * Exige qualquer permissão da área `configuracoes` (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 registros não excluídos.
- *
- * `GET /robo`
- */
-export declare function buscar_paginador_robo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorRobo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaRobo>;
 /**
  * Cadastra um robô de atendimento
  *
@@ -722,46 +9,6 @@ export declare function buscar_paginador_robo(credencial_de_acesso: CredencialDe
  * `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 `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome e modelo, em ordem alfabética de nome. `busca` procura por trecho do nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros 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.PaginaRoboAutoComplete>;
-/**
- * Lista as equipes do Chatwoot
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Consulta na hora as equipes (id e nome) de uma conta do Chatwoot ativa, para escolher a `equipe_id` da etapa `atendimento` ou do `gatilho` do fluxo. Com `robo_id`, usa a conta do Chatwoot dos números de WhatsApp (Z-API ou QR Code) ligados a esse robô; sem `robo_id` ou sem número ligado, usa a primeira conta ativa.
- *
- * `GET /robo/equipes`
- */
-export declare function buscar_equipes_robo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarEquipesRobo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.EquipeChatwoot>>;
-/**
- * Busca robôs por filtro
- *
- * Exige qualquer permissão da área `configuracoes` (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>>;
-/**
- * Lista os modelos de IA que o robô pode usar
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Consulta na hora o gateway do TermoAI (`GET /gateway/modelos`, categoria `texto_para_texto`, com o token do aplicativo) e devolve as IAs com chave ativa lá: `provedor` (o valor que vai em `modelo` do robô), `empresa`, `modelo`, `url_da_logo`, `logo_monocromatica`, `gratuito`, `aceita_ferramentas` e `chaves_ativas`. O robô com `modelo` vazio deixa o TermoAI escolher; com um `provedor`, o TermoAI usa essa IA primeiro e só troca para outra quando ela falha.
- *
- * `GET /robo/modelos`
- */
-export declare function buscar_modelos_robo(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.ModeloDoGateway>>;
-/**
- * Busca um robô pelo id
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve o robô com o fluxo completo. 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
  *
@@ -770,99 +17,3 @@ export declare function buscar_pelo_id_robo(credencial_de_acesso: CredencialDeAc
  * `PATCH /robo/{id}`
  */
 export declare function atualizar_pelo_id_robo(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.RoboAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Robo>;
-/**
- * Exclui um robô pelo id
- *
- * Exige a permissão `deletar` da área `configuracoes`. A exclusão é lógica: o robô some das consultas, o nome fica livre para um novo cadastro e não há como restaurar.
- *
- * `DELETE /robo/{id}`
- */
-export declare function deletar_pelo_id_robo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista as ferramentas com paginação
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Ordena pelo rótulo. `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 registros não excluídos.
- *
- * `GET /robo_ferramenta`
- */
-export declare function buscar_paginador_robo_ferramenta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorRoboFerramenta, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaRoboFerramenta>;
-/**
- * Cadastra uma ferramenta do robô
- *
- * Exige a permissão `criar` da área `configuracoes`. Cadastra uma ferramenta que as etapas do robô podem liberar para a IA. `nome` é o nome técnico (só letras minúsculas, números e `_`, até 60 caracteres, único); `rotulo` (até 80) e `descricao` (até 500) são obrigatórios; `tipo` é `leitura` ou `escrita`; `exige_confirmacao` tem padrão `false`; `esquema` é o JSON Schema dos parâmetros (padrão: objeto sem propriedades). A ferramenta nasce ativa.
- *
- * `POST /robo_ferramenta`
- */
-export declare function criar_robo_ferramenta(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.RoboFerramentaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.RoboFerramenta>;
-/**
- * Lista básica de ferramentas para seleção
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve só id, nome técnico e rótulo das ferramentas ativas, em ordem alfabética do rótulo. `busca` procura por trecho do rótulo ou do nome técnico, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. `total` conta os registros que casam com a busca.
- *
- * `GET /robo_ferramenta/autocomplete`
- */
-export declare function buscar_auto_complete_robo_ferramenta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteRoboFerramenta, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaRoboFerramentaAutoComplete>;
-/**
- * Busca ferramentas por filtro
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Devolve todas as ferramentas que casam com o filtro, sem paginação, em ordem alfabética do rótulo. `nome` procura por trecho do nome técnico, sem diferenciar maiúsculas; `tipo` compara o valor exato (`leitura` ou `escrita`); `ativo` filtra pela situação. Sem filtro, devolve todas.
- *
- * `GET /robo_ferramenta/filtro`
- */
-export declare function buscar_pelo_filtro_robo_ferramenta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroRoboFerramenta, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.RoboFerramenta>>;
-/**
- * Busca uma ferramenta pelo id
- *
- * Exige qualquer permissão da área `configuracoes` (qualquer ação liberada na área já libera a leitura). Ferramenta excluída responde `404`.
- *
- * `GET /robo_ferramenta/{id}`
- */
-export declare function buscar_pelo_id_robo_ferramenta(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.RoboFerramenta>;
-/**
- * Atualiza uma ferramenta pelo id
- *
- * Exige a permissão `editar` da área `configuracoes`. Atualização parcial: só os campos enviados mudam. `rotulo` (até 80) e `descricao` (até 500) não podem ficar vazios; `tipo` é `leitura` ou `escrita`; `esquema` substitui o JSON Schema inteiro; `ativo` liga ou desliga a ferramenta. O nome técnico não muda.
- *
- * `PATCH /robo_ferramenta/{id}`
- */
-export declare function atualizar_pelo_id_robo_ferramenta(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.RoboFerramentaAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.RoboFerramenta>;
-/**
- * Exclui uma ferramenta pelo id
- *
- * Exige a permissão `deletar` da área `configuracoes`. A exclusão é lógica: a ferramenta some das consultas, o nome técnico fica livre e não há como restaurar.
- *
- * `DELETE /robo_ferramenta/{id}`
- */
-export declare function deletar_pelo_id_robo_ferramenta(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Verifica se o backend está no ar
- *
- * Pública, sem token. Responde `200` com `sucesso: true` e a versão do backend no ar (semver) sempre que o servidor está de pé; não consulta o banco nem o TermoAuth.
- *
- * `GET /test`
- */
-export declare function verificar_saude_test(opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.SaudeDoBackend>;
-/**
- * Recebe os eventos do Chatwoot
- *
- * Pública, sem token do usuário: é chamada pelo robô de atendimento que o TermoSell cria na conta do Chatwoot, com o `segredo` da configuração no endereço. O corpo é o evento do Chatwoot como ele envia. Só `message_created` que não é nota privada e chega por uma caixa ligada a um número da Z-API é tratado: mensagem da equipe vai para o WhatsApp pela Z-API, e mensagem do cliente numa conversa pendente é respondida pelo robô em segundo plano, seguindo o fluxo do robô do número. O resto é ignorado com `200`.
- *
- * `POST /webhooks/chatwoot`
- */
-export declare function receber_evento_chatwoot_webhooks(parametros: ParametrosDeReceberEventoChatwootWebhooks, corpo_da_requisicao: tipos.EventoDoChatwoot, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Recebe as entregas do TermoWebhook
- *
- * Pública, sem token do usuário: é chamada pelo TermoWebhook, o hub de eventos da Termotubos, para entregar os eventos que o TermoSell assina. A entrega é conferida pela assinatura Ed25519 do hub (chave pública em `/.well-known/jwks.json` do TermoWebhook), pela data e pelo destino, que precisa ser o próprio TermoSell. Eventos tratados: `colaborador.criado` e `colaborador.atualizado`, versões 1 e 2, publicados pelo TermoAuth: criam ou atualizam o colaborador e o acesso dele (a v2 também traz setor, cargo e função), descartando o evento mais antigo que o último aplicado. Qualquer outro tipo responde `200` sem fazer nada. Como o hub entrega pelo menos uma vez, repetir o mesmo evento é seguro.
- *
- * `POST /webhooks/termowebhook`
- */
-export declare function receber_evento_termo_webhook_webhooks(parametros: ParametrosDeReceberEventoTermoWebhookWebhooks, corpo_da_requisicao: tipos.EntregaDoTermoWebhook, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Recebe as mensagens do WhatsApp pela Z-API
- *
- * Pública, sem token do usuário: é chamada pela Z-API, com o `segredo` do número no endereço. O corpo é o evento da Z-API como ela envia; o `instanceId` dele precisa ser o da instância do número dono do `segredo`. Mensagem recebida de conversa individual, num número ativo e ligado a uma caixa do Chatwoot, é registrada no Chatwoot (a mesma mensagem não é registrada duas vezes); grupos, canais, transmissões e ecos do próprio sistema são ignorados com `200`.
- *
- * `POST /webhooks/z_api`
- */
-export declare function receber_evento_z_api_webhooks(parametros: ParametrosDeReceberEventoZApiWebhooks, corpo_da_requisicao: tipos.EventoDaZApi, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;