Configurações do tenant

Centraliza as configurações da sua conta: dados cadastrais e logo, chaves de integração (Asaas, PlugNotas/NFS-e, SMTP), parâmetros de IA (modelo, teto de tokens, BYOK) e localização (fuso, idioma, moeda). Organizado em abas.

Ele nasce em HOMOLOGAÇÃO: o cálculo chega de verdade do parceiro, e o eSocial NÃO vale como entrega ao governo. Só mude para PRODUÇÃO depois de conferir um holerite com o contador. E note: apenas a palavra PRODUCAO escrita por extenso sai da homologação — valor vazio, antigo ou com erro de digitação continua no lado seguro, de propósito.

Manda uma competência VAZIA para o parceiro. É o teste mais honesto possível: exercita URL, token e caminho sem tocar em folha real. O parceiro vai responder "nenhum item" ou recusar por lista vazia — as duas respostas provam que a credencial funciona. O que se quer descobrir aqui é 401 e 404, que sem este botão só apareceriam no dia do fechamento.

Em Inteligência Artificial, o campo Modo decide os dois: quem paga o consumo e por qual conta os dados trafegam. "Licença BMCode" é o começo mais fácil e não lê imagem. "Chave própria" pede a chave do provedor que você contratou, libera a leitura de foto de boleto e nota, e mantém a retenção sob o seu contrato com o provedor.

A lista mostra o domínio do e-mail de cada pessoa, e destaca quem está fora do domínio da casa — um contador externo, um sócio com endereço próprio, um consultor. Isso não é erro: essas pessoas entram normalmente, mas com a conta Microsoft **do domínio delas**, e quem autoriza o aplicativo naquele caso é o TI daquela outra empresa, não o seu. Saber disso antes evita o chamado de "só o fulano não consegue entrar".

Você escolhe COMO pagar; o sistema escolhe por onde. Cartão de crédito passa pela Stripe (que atende cartão nacional e internacional); PIX e boleto passam pela Asaas, cuja taxa fixa é mais barata para cobrança em reais. O roteamento é automático e o dono da conta pode trocá-lo por parâmetro, sem depender de deploy.

Na aba Parâmetros, cada bloco é um grupo com o nome na borda e pode ser recolhido clicando no nome — útil porque a lista é longa. Dentro de alguns grupos há subgrupos (CRM ▸ Persona, Comercial ▸ Vendedora) separando assuntos. Os campos ficam em duas colunas no computador e em uma no celular. O selo ao lado do rótulo diz o alcance do valor: conta, empresa ou plataforma.

O Tenkai é medido em créditos. Cada interação vale uma quantidade fixa: pergunta e resposta 2, sugestão de preenchimento 2, resumo 5, análise 5, extração de documento 5, passo de agente 10, documento gerado 20. Seu plano tem uma franquia mensal de créditos que volta cheia todo mês e não acumula. Passou da franquia, cada crédito excedente consome a carteira da conta, que você abastece comprando pacotes em Configurações ▸ IA; o crédito comprado entra quando a fatura é paga e não vence enquanto o contrato estiver ativo. Acabaram franquia e carteira, o Tenkai avisa e para até a virada do mês ou uma nova compra. Pergunte ao Tenkai "quantos créditos eu tenho?" para ver franquia, uso e saldo na hora.

Na vertical têxtil, diga qual elo a empresa é: fiação, malharia, confecção ou verticalizada (fia e confecciona). O elo decide o Início por papel (a fiação vê pluma, energia, rendimento e reclamações), a jornada do menu enxuto e os atalhos do app. Vazio continua como confecção.

Em Avançado ▸ Parâmetros ▸ Comercial ficam os BENEFICIO.*: ligue "Programa de benefícios ativo", escolha o modo (Pontos por real ou Cashback), e preencha, por exemplo, 1 ponto por real, valor do ponto 0,10 e validade de 180 dias. Salvar grava só o que você mudou, e o histórico ao lado mostra de → para. Se a empresa usa o ERP com a view do programa, a carga inicial dos saldos é feita em Integrações ▸ Pedidos enviados ao ERP ▸ Conferir programa.

No Grátis o Tenkai responde perguntas e consultas, mas não executa ações (criar, lançar, enviar). Ao pedir uma ação, ele diz isso e mostra o caminho para mudar de plano. Nos demais planos as ações seguem a governança de acessos de quem pergunta, como sempre.

Cada aba salva de forma independente. Segredos (chaves de API) são cifrados no banco e nunca reexibidos em texto — para trocar, cole a nova chave.

A chave de IA própria (BYOK) é da EMPRESA e vale para todos os usuários dela: configurada, as chamadas de IA passam a sair pela sua conta no provedor, com o seu limite e a sua fatura — e recursos que exigem chave própria, como enviar foto de documento para leitura pela IA, passam a funcionar. A chave é guardada cifrada e não é reexibida depois de salva. Sem chave própria, a empresa opera no modo licença BMCode, consumindo os créditos de IA do plano.

A folha vive no Tenka — competência, itens, rubricas, custo por centro na DRE, provisão no fechamento. O cálculo legal (INSS, IRRF, FGTS) e a transmissão do eSocial ficam com o parceiro homologado. O motivo é direto: a tabela muda por medida provisória e evento errado gera multa para a SUA empresa, não para nós. Um cálculo próprio jovem é risco assimétrico.

Se a empresa estiver em modo de treino (sandbox) ou for uma cópia de treino, tanto o cálculo quanto a transmissão são BARRADOS e registrados na tela do sandbox. Isso existe porque transmitir eSocial de uma cópia criaria evento real no governo — e evento indevido se corrige por retificação, com prazo correndo.

O módulo da sua vertical (têxtil, saúde, jurídico, campo ou família) entra como adicional do plano base, com o preço da tabela, na mesma fatura. Se a sua conta é anterior a esta versão, o módulo aparece a preço zero e nada muda no seu total.

Quando a conta usa a licença de IA da BMCode, o Tenkai NÃO envia imagens ao modelo — e diz isso em vez de fingir que leu o documento. O motivo é de quem é a CONTA por onde o documento passa: com chave própria, o boleto do seu fornecedor viaja pela sua conta, com o provedor que você escolheu; com a licença compartilhada, ele viajaria pela nossa, e a decisão sobre dado de terceiro passaria a ser nossa. Texto continua funcionando normalmente, inclusive PDF que tem camada de texto.

Antes de qualquer pergunta sair para o modelo, CPF, CNPJ, e-mail, telefone e salário são substituídos por marcadores. Essa proteção alcança o que é texto: a pergunta, a tela e o material de apoio — inclusive o PDF que tem camada de texto. O que está desenhado dentro de uma IMAGEM ela não alcança, e é exatamente por isso que a imagem tem regra própria.

**1. A plataforma** — a BMCode registra o aplicativo uma vez, para todos os clientes. Você vê o estado dele no alto da aba: se Microsoft e Google aparecem como disponíveis, este passo está feito e você não precisa fazer nada. **2. O TI da sua empresa** — um administrador do Microsoft da SUA empresa autoriza, uma vez, que o aplicativo leia o perfil básico de quem entrar. A aba monta o endereço pronto, já com o domínio da sua empresa; basta abrir e confirmar. Em muitas empresas isso nem é preciso: se a política permitir, a primeira pessoa que entrar autoriza sozinha, na hora. **3. Você, por pessoa** — cadastre cada pessoa em Acessos com o MESMO e-mail da conta Microsoft ou Google dela. A partir daí ela entra clicando no botão, sem senha.

Entrar com Microsoft ou Google reconhece quem **já existe** nesta conta, casando pelo endereço de e-mail. Quem não está cadastrado é recusado. Poderia ser diferente: bastaria criar a pessoa automaticamente no primeiro acesso. Não fazemos porque isso significaria que qualquer um com um endereço de e-mail entraria na sua conta sem que ninguém tivesse decidido nada. Quem entra continua sendo escolha sua. 🪤 A consequência prática, e é a dúvida mais comum: **o endereço tem de bater exatamente**. Alguém cadastrado como `nome@suaempresa.com.br` que clique com uma conta pessoal recebe "não cadastrado" — e agora a mensagem mostra qual endereço foi usado, justamente para essa pessoa perceber que escolheu a conta errada no navegador.

Comprar o pacote cria a fatura e o link de cobrança, mas o saldo NÃO muda na hora: a carteira credita quando o pagamento baixa (webhook do gateway ou baixa manual da BMCode). É a mesma regra de qualquer fatura da plataforma — dinheiro prometido não é dinheiro.

O preço de lista é o valor padrão da detentora do modelo e se atualiza diariamente pela cotação do dia — sempre abrindo vigência nova (o custo do que você já usou nunca é recalculado). Três travas protegem o número: sem cotação do dólar no dia, nada muda; salto suspeito (mais de 3×) não é aplicado e vira alerta; e a margem só muda por decisão humana da BMCode.

A aba Faturamento junta o que estava espalhado: o seu plano e o valor mensal, o saldo de créditos de IA, as formas de pagamento aceitas e o histórico completo de cobranças. É a tela para responder "quanto pago, como pago e o que já paguei" sem sair do lugar.

Todo gateway desconta uma taxa: o pagamento cai LÍQUIDO e a taxa é custo. No histórico, cada cobrança mostra o valor pago (bruto), a taxa que o gateway cobrou e o líquido que entrou na conta. Essa taxa também é lançada como despesa nos livros da plataforma, para o resultado refletir o que de fato caiu — e não um faturamento inflado.

O campo "Modelos habilitados" é a lista curta da sua conta sobre o catálogo de modelos, que se atualiza sozinho todo dia. Deixá-lo vazio NÃO desliga a IA: quer dizer que a conta não restringiu nada e que o modelo padrão continua respondendo, exatamente como antes. Marcar é um ato voluntário — serve para padronizar (só os modelos que a empresa homologou), para controlar custo (deixando de fora os mais caros) ou para privacidade (só os provedores com contrato). Modelo que sai do catálogo por descontinuação continua aparecendo marcado enquanto estiver gravado, para você não desmarcá-lo sem perceber.

Ligado por padrão (parâmetro IA.ROTEAMENTO_AUTOMATICO): a plataforma escolhe o modelo pelo tamanho do pedido — pergunta curta vai para o mais barato entre os habilitados da conta, geração longa vai para o mais forte, o resto fica no padrão. Você pode cravar qual modelo é o "rápido" e qual é o "forte" (IA.MODELO_RAPIDO / IA.MODELO_FORTE) ou deixar em branco e a escolha sai do preço do catálogo. O cartão "economia do roteamento" mostra o resultado no mês; "créditos do mês" mostra o consumo em créditos, a unidade que o time entende.

Conta criada num ramo com jornada própria (Têxtil e confecção) vê na lateral só as telas da jornada — cadastro de item, ficha técnica, preço da peça, rolos, corte, ordem de produção, peças por costureira, facção, pedido, romaneio, caixa do mês e financeiro. O resto do Tenka continua lá: o link "Mostrar tudo (N)" no fim do menu traz as demais telas nesta sessão. Para o menu completo permanente, desligue o parâmetro MENU.ENXUTO_RAMO em Configurações ▸ Parâmetros. Nenhuma permissão muda: o menu enxuto só decide o que a lateral exibe.

O parâmetro "Busca por significado na base de conhecimento" faz o Tenkai e a ajuda acharem o artigo certo mesmo quando ele não repete a palavra da pergunta ("como dou baixa numa conta" encontra "Liquidação de títulos"). As duas buscas trabalham juntas: o artigo que a busca por palavra e a por significado acham ao mesmo tempo vem primeiro. Ela depende de a instalação ter chave de IA com modelo de embedding — a linha logo abaixo do interruptor diz se já tem. Enquanto não tiver, o Tenkai e a ajuda buscam por palavra, sem erro nenhum, e a busca por significado passa a valer sozinha quando a chave for configurada. A base é indexada aos poucos e só o que mudou é reenviado.

O Tenkai tem mais de 200 consultas prontas. Alguns provedores de IA aceitam no máximo 128 por pergunta (a OpenAI, por exemplo). Nesses, o Tenkai envia só as ligadas à pergunta — sempre a busca na ajuda e a consulta livre de cadastro, depois as que a pergunta cita e as vizinhas do mesmo assunto — sem passar do limite. As outras continuam existindo e entram na próxima pergunta que precisar delas. Provedores sem limite (Anthropic, Gemini) recebem todas.

Cada plano traz uma franquia mensal em créditos: Grátis 50 (só consultas), Essencial 500, Enterprise 3.000. Cada interação vale créditos — pergunta 2, resumo 5, documento 20. Acabou a franquia, o Tenkai avisa e você compra um pacote de 1.000 créditos aqui na aba IA; o preço do pacote acompanha o custo real do mês anterior e aparece antes de você confirmar. Os créditos comprados entram quando o pagamento é confirmado e não vencem com a virada do mês.

A aba Atividades e verticais guarda o que a empresa faz: o país, o registro fiscal, as atividades oficiais (Reconsultar o registro traz de novo), as verticais em cada país de operação e qual é a principal. Marque, desmarque, busque por uma palavra do seu negócio ou escolha na lista, e salve. O pacote ao lado mostra o que o Tenka faz pela escolha no país. A vertical sugere o pacote: o que abre telas continua sendo o plano e os perfis.

Quatro campos do grupo Financeiro: aprovação obrigatória acima de (valor), categorias que sempre exigem aprovação (códigos das naturezas, vale para as filhas), fornecedores bloqueados e fornecedores liberados (CNPJ ou CPF separados por vírgula). Na remessa, bloqueado é barrado; acima do valor ou da categoria vai para a fila de aprovação; liberado paga sem toque, salvo sinal de fraude.

Ligue Cobrança Pix gerada sozinha no título a receber e diga quantos dias antes do vencimento ela nasce. Precisa da conta Asaas DA EMPRESA conectada em Integrações (a chave é dela; a plataforma não usa credencial própria) e do webhook cadastrado no painel do Asaas. Até 50 títulos por dia; título sem cliente com documento é pulado e o motivo fica registrado.

Na aba Assinatura você vê quanto da cota do plano já usou: usuários, empresas, espaço e chamadas de API por dia. Em 80% a barra fica amarela e aparece o aviso; no limite, o cadastro novo é recusado com a mensagem dizendo qual cota acabou. Para ampliar, fale com o comercial.

Em Avançado › Parâmetros, cada campo de escolha mostra o nome da opção (por exemplo, "Simulador — treino" na maquininha do caixa). Se um valor antigo não estiver mais na lista, ele aparece como está, para você trocar quando quiser: o Salvar nunca troca um valor sozinho. Ao salvar, o aviso no canto da tela diz quantos parâmetros mudaram — ou que nenhum mudou.

Cada aba desta tela tem o próprio Salvar: ele grava só o que está naquela aba, e o resultado aparece logo — o aviso no canto da tela quando deu certo, ou a mensagem no topo dizendo o que faltou. Um campo de outra parte da tela não impede mais o salvamento.

Todo aviso que a conta manda para quem está fora dela (portal do cliente, e-mail, WhatsApp, celular) passa por uma porta só. Ela respeita o cadastro (cliente que não quer e-mail não recebe e-mail), o descadastro (quem pediu para sair das campanhas ou mandou SAIR no WhatsApp) e uma régua: no máximo 5 avisos automáticos por pessoa em 24 horas, somando todas as rotinas. O número muda no parâmetro "Avisos: máximo por cliente ou parceiro em 24 h". Cobrança vencida, laudo pronto, proposta enviada e documento mandado na hora sempre saem. Para saber o que aconteceu com um aviso, pergunte ao Tenkai: "o cliente recebeu o aviso?".

Na aba Assinatura, quem administra a conta marca o aceite e gera o link de indicação. Mande o link para outro box. Quando a conta nova criada pelo link pagar a primeira mensalidade, você ganha um bônus em dias da sua mensalidade; depois, uma parte de cada mensalidade que ela pagar, por alguns meses. O cartão mostra as contas novas pelo link, quantas já pagaram, o crédito ganho, o que já abateu e o que falta abater.

Esta tela é da administração da conta: quem administra o tenant — os perfis com permissão de alteração em Configurações da Empresa — enxerga e edita; os demais perfis só a veem se o acesso foi concedido na tela de Acessos. Não confunda com Minhas preferências, que todo usuário tem: aqui as escolhas (dados e marca, cobrança, assinatura, IA) valem para a EMPRESA inteira, não para uma pessoa. Se você precisa mexer em algo daqui e não enxerga a tela, o caminho é pedir a quem administra a conta.

Sim, e é o caso comum: num grupo multi-CNPJ cada empresa costuma estar num escritório contábil diferente. A configuração é por empresa. Quem tem um parceiro só para o grupo preenche igual em todas.

Não. Os dois caminhos convivem: quem preferir continuar entrando com e-mail e senha continua entrando. A coluna "como entra" mostra quem já experimentou o acesso sem senha e quem ainda usa senha. É proposital. Trocar todo mundo de uma vez transformaria um ganho de conforto num impedimento de trabalho no dia em que o provedor ficasse fora do ar.

A franquia mensal vem do plano. Se ela acabar, a conta pode comprar pacotes de crédito na aba IA (Consumo): a fatura é emitida na hora (PIX/boleto) e o saldo entra na carteira NA CONFIRMAÇÃO do pagamento — nunca antes. O consumo abate primeiro da franquia e só depois da carteira; o crédito não expira e, se a conta for encerrada, o saldo abate a última fatura. Quem configura chave própria de IA (BYO) não usa créditos — a franquia fica suspensa enquanto a chave própria estiver ativa.

A lista do campo "Modelo padrão" é VIVA: uma carga diária consulta o catálogo público de modelos (e os provedores em que a BMCode tem conta) — modelo novo aparece sozinho, descontinuado sai das opções. O preço mostrado é o do SEU modo: usando créditos, é a tabela com a margem (o que você paga); usando chave própria, é a tabela do provedor (você paga direto a ele). Modelo fora do catálogo continua aceito — com o aviso de que o custo fica zerado até a BMCode tabelar.

O pagamento por cartão depende de a conta Stripe estar ativa. Enquanto ela não estiver configurada, a plataforma segue cobrando por PIX e boleto (Asaas) normalmente, e a linha de cartão aparece marcada como "em breve". Nada fica bloqueado — só a forma de cartão espera a ativação.

No rodapé do chat do Tenkai, onde antes havia só o nome do modelo em uso. Com mais de um habilitado, aquele texto vira um seletor e a escolha vale para a conversa — inclusive nas perguntas sobre os seus dados, que fazem duas idas ao provedor. Com um único modelo habilitado, o rodapé continua sendo texto: um seletor de uma opção é um clique que não decide nada. O que a pessoa escolhe é sempre revalidado no servidor contra a lista da conta.

É a permissão para o visitante do test-drive conversar de verdade com o Tenkai, com um número limitado de perguntas e o contador à vista. Vale SÓ na conta de demonstração (a apontada pelo parâmetro TESTDRIVE.EMPRESA) e usa a chave de IA da plataforma; o teto por visitante e o teto diário da conta inteira são parâmetros de plataforma (IA.DEGUSTACAO_PERGUNTAS e IA.DEGUSTACAO_PERGUNTAS_DIA). Se o servidor ainda não tiver a chave da plataforma configurada, o Tenkai diz isso com todas as letras em vez de sugerir cadastrar uma chave própria — numa conta somente leitura, esse conselho mandaria a pessoa apertar um botão que ela não tem.

O idioma vale em quatro degraus, nesta ordem: o seu usuário, a empresa, a conta e, por último, português do Brasil. Trocar no seu usuário muda a moldura do sistema na hora — menu, botões, rótulos e mensagens — porque isso sai dos arquivos de tradução. Já o texto que está CADASTRADO no banco (o nome e a descrição de cada tela, a ajuda, as notas de versão) só aparece traduzido quando existe tradução gravada para aquele registro naquele idioma; quando não existe, o sistema mostra o texto original de propósito, em vez de deixar o espaço em branco. Hoje as telas, o título da ajuda e as notas de versão estão traduzidos nos 10 idiomas; o corpo dos artigos está sendo traduzido e ainda pode aparecer em português. Nada disso é erro de configuração da sua conta: é conteúdo que falta traduzir, e a tela Diagnóstico ▸ Cobertura de tradução mostra exatamente quanto já está pronto em cada idioma.

Estão. Todo o histórico — 562 títulos e 712 descrições — existe nos dez idiomas, então a tela Novidades muda junto com o idioma que você escolheu. O que ainda está em andamento é o corpo dos artigos de ajuda: neles, o título já sai traduzido e o texto longo pode vir em português. Quando a tradução de um texto não existe, a plataforma mostra o original de propósito — tela em branco seria pior do que tela com o idioma errado. Em Diagnóstico ▸ Cobertura de tradução você acompanha o quanto falta em cada idioma.

Mudam. Os seis eixos (Saber, Receber, Vender, Melhorar, Entregar, Crescer), o nome das seções dentro de cada um e os grupos da página de Cadastros saem no idioma escolhido, junto com a pergunta e a linha de descrição que aparecem no topo do hub de cada eixo. São dois mecanismos, e a diferença importa se você for personalizar: o RÓTULO curto (o nome do eixo, o nome da seção) sai dos arquivos de tradução da plataforma, porque é um conjunto fechado e pequeno; as FRASES do eixo (a pergunta e o subdescritor) saem da tabela de traduções, como a ajuda e as notas de versão. Quando a tradução de um texto não existe, a plataforma mostra o original de propósito — tela em branco seria pior do que tela com o idioma errado.

Busque por uma palavra do seu negócio (o Tenka procura no nome e nos sinônimos de cada vertical). Se nada aparecer, escolha na lista a mais parecida com a sua operação, ou use Pular e escolher depois: a conta nasce como sempre, e a escolha fica em Configurações › Empresa › Atividades e verticais. O que estiver em breve no seu país pode ser pedido na tela Verticais.

Na aba Assinatura, o cartão Vendedor 24 h mostra a tabela de preço por clientes atendidas no mês (os valores são provisórios), quantas clientes a loja já atendeu pelo WhatsApp ou pelo Instagram neste mês e em que faixa isso cai. Quem administra contrata ou cancela ali. A fatura de cada mês cobra a faixa das clientes atendidas no mês anterior; mês sem cliente atendida não cobra; a faixa mais alta é combinada com a equipe comercial. Sem o vendedor 24 h, as mensagens das clientes vão para uma pessoa da loja na Conversa. Plano grátis não contrata: assine o plano da loja antes.

Por causa do perfil de experiência (aba Identidade). No Essencial, as telas da indústria (fiação, malharia, tecelagem, tinturaria, cockpit da cadeia e grande varejo) saem do menu, da busca e das Mais vistas. A ordem de decisão é: a sua escolha no menu do avatar, depois a da empresa, depois o automático. O automático olha o que a empresa faz: plano de entrada, confecção, facção e loja ficam no Essencial; fiação, malharia, tecelagem, tinturaria e a verticalizada ficam no Completo. Nenhuma permissão muda: a tela continua abrindo pelo endereço.

Na próxima fatura gerada depois que a conta indicada pagou. O crédito nunca deixa a fatura abaixo do valor mínimo de cobrança; o que sobra entra na fatura seguinte. Quem indicou nunca vê os dados da conta indicada: só que ela entrou pelo link e se já pagou.

Aqui, em Configurações da empresa: o CNPJ entra quando você precisar emitir nota, e o e-mail é opcional. O perfil "Balcão" deixa no menu só as cinco telas do dia; escolha "Essencial" ou "Completo" para ver mais.

São três campos em Parâmetros, grupo PDV, que valem para a peça vendida só pelo valor no caixa do celular: NCM (8 dígitos), CFOP (4 dígitos) e CSOSN ou CST. Roupa de malha costuma ter NCM do capítulo 61 (ex.: 6109.10.00, camiseta de malha de algodão) e de tecido plano do 62; quem fabrica o que vende usa em geral o CFOP 5101, quem revende o 5102; no Simples o CSOSN vazio segue o 102. Escolha com o seu contador. Sem o NCM ou o CFOP, a venda grava e a nota dessa peça fica pendente dizendo o que falta. Nenhum deles vem preenchido de fábrica: um código errado na nota é problema com o fisco.

O portal do cliente agora usa as cores cadastradas da sua empresa, as mesmas do sistema: botões, links, abas, a página atual das listas e os destaques. Sem cor cadastrada, o portal segue com as cores padrão. A cor se troca no cadastro da empresa e vale para os dois.