Buscar K
Aparência
Tenants
- Tipo
- Referência
- Para
- Parceiro whitelabel
- Na tela
- HEC › Recursos e Permissões › Tenants
Cada empresa que você atende fica num Tenant, com os próprios dados, usuários e Aplicações. Esta página cobre o que a equipe do Cliente faz com um Tenant pelo HEC: criar, configurar, suspender e excluir. Para criar Tenants em série pela API, veja Tenant automático.
O que é um Tenant e como ele se liga ao Cliente está em Cliente, Tenant e usuário.
Quem pode
| Ação | Quem |
|---|---|
| Criar Tenant | Superadministrador e Implantador do Cliente |
| Editar o cadastro, mudar o status, excluir | Superadministrador, Implantador e Operador |
| Editar as configurações do próprio Tenant | O administrador do Tenant, pelo menu Tenant › Configurar Tenant, sem as abas Status e Templates |
No menu, a equipe do Cliente acha os Tenants em Tenants: Gerenciar Tenant Logado, Criar Tenant e Lista de Tenants.
Criar um Tenant
- Abra Tenants › Criar Tenant.
- Escolha o Cliente, se você administra mais de um, e preencha Nome. O nome precisa ser único em toda a plataforma, não só no seu Cliente.
- Se o Cliente exige CNPJ, preencha CNPJs do Tenant. A lista entra no histórico inicial de custos do Tenant.
- Em Template, escolha o template que o Tenant recebe e preencha as variáveis e o mapa de conexões dele. Veja Templates.
- Se o cliente final já tem um Agente ETL instalado, marque Vincular Agente ETL já existente e cole o Token do agente:. Sem isso, o agente é instalado depois. Veja Instalar o Agente ETL.
- Clique em Criar Tenant.
O Tenant nasce com os grupos padrão do Cliente. Veja Grupos padrão.
O cadastro do Tenant
As abas, na ordem da tela:
| Aba | O que tem |
|---|---|
| Geral | Cliente, Nome, a seção Chatbot e Acesso (instruções e memória do assistente) e a seção Recursos do Tenant |
| Status | Situação atual, ações e histórico. Num Tenant com trial, a aba se chama Status (Trial). Veja Status |
| Identidade Visual | Domínios, marca, tela de login, suítes e cores. Veja Marca e domínio |
| ChatBot | Nome de usuário do Telegram e Token do Telegram do bot do Tenant |
| Usuários | Quem tem acesso ao Tenant. Criar e editar usuários é em Usuários |
| Templates | Templates instalados e Instalar template. Veja Templates |
| Instâncias de Whatsapp | Números de WhatsApp conectados por QR Code para este Tenant |
| WhatsApp oficial | A conexão com a API oficial da Meta para este Tenant |
| Avançado | Segurança, Agentes ETL, E-mail, Permissões & Acesso, Canais de Alerta |
| Desenvolvedor | O token da API do Tenant. Só a equipe do Cliente e a equipe da HorusBI veem esta aba |
Como os alertas escolhem entre as instâncias de WhatsApp e a conexão oficial está em WhatsApp.
Num Tenant em trial ou pré-pago, quem não é da equipe do Cliente vê uma tela reduzida, Configurações do Tenant, com as abas Geral, Aparência, Telegram, Usuários e Avançado.
O que vem do Cliente
Toda configuração que o Tenant não definiu usa o valor do Cliente. Mudar no Cliente muda na hora em todos os Tenants que não têm valor próprio. Veja Cliente.
Geral
- Instruções do ChatBot: texto que orienta o assistente de IA neste Tenant, como o vocabulário do negócio.
- Memória do assistente: Memória ligada por padrão e O assistente aprende com as conversas.
Avançado
| Seção | Opções |
|---|---|
| Segurança | Exigir 2FA para todos os usuários, Métodos 2FA Permitidos, Habilitar Gerador de JWT e Chave JWT |
| Agentes ETL | Preservar Contexto dos Agentes ETL, Definir limite de data para cargas temporais, Menor granularidade de agendamento de cargas (Minutos ou Horas) |
| Servidor SMTP próprio e Template de Email | |
| Permissões & Acesso | As chaves da tabela abaixo |
| Canais de Alerta | Quais canais os usuários podem usar nos alertas: Whatsapp, Telegram, E-Mail do Usuário e Webhook, com a URL do Webhook |
Preservar Contexto dos Agentes ETL serve para quem tem mais de um sistema de origem: os relacionamentos entre tabelas ficam restritos ao mesmo agente, para que o código 1 de um sistema não se misture com o código 1 de outro.
O Gerador de JWT deixa um widget pedir ao Lumo um token assinado com a Chave JWT, que o seu sistema confere com a mesma chave. Assim um botão num Dashboard chama a API do seu sistema sem guardar senha no navegador.
O Template de Email muda o visual dos e-mails do Lumo. O template precisa ter {{_conteudo}}, onde entra o texto de cada e-mail, e pode usar {{_assunto}} e {{_clientName}}. O do Tenant vence o do Cliente, que vence o padrão.
Em Permissões & Acesso:
| Chave | Ligada |
|---|---|
| Liberar edição de objetos de template | O que veio de template fica editável neste Tenant. Veja Templates |
| Permitir usuários não administradores de compartilhar alertas | Qualquer usuário compartilha os próprios alertas |
| Mostrar usuários administradores para usuários não administradores ao compartilhar alertas | Os administradores aparecem na lista de destinatários |
| Usuários não administradores não podem criar aplicações ou editar abas de dados | Quem não é administrador clona e edita Dashboards, mas não mexe no modelo de dados nem nas expressões |
| Administradores podem acessar como outro usuário | Os administradores do Tenant acessam como os usuários dele. Só a equipe do Cliente liga. Veja Impersonação |
| Primeiro dia da semana, Mês de início do ano fiscal | Definem onde começam a semana e o ano fiscal nas datas do Tenant |
| Módulo Indicadores disponível para os usuários | Mostra os Indicadores no DataViz |
| Permitir usuários criarem dashboards pessoais em aplicações publicadas | Cada usuário monta Dashboards só dele dentro de uma Aplicação publicada |
| Permitir usuários compartilharem dashboards pessoais | Esses Dashboards podem ser compartilhados |
Recursos do Tenant
Recursos e Permissões › Recursos do Tenant › Gerenciar Recursos mostra os limites do Tenant e o que ele usa: usuários, CNPJs, Processamento, créditos de IA e linhas de Cadastros. Em Recursos Extras a equipe do Cliente contrata mais: usuários, GB, pacotes de 1.000.000 créditos de IA e pacotes de 1 milhão de linhas de Cadastros. Aumentos valem na hora. Reduções valem no fim do ciclo.
Quem contrata está em Cliente. O que cada recurso mede está em Recursos, limites e cobrança.
Chave própria de IA
Na mesma tela, a seção de IA deixa o Tenant usar a conta da sua empresa num provedor de IA. Pode alterar quem tem a função Configuração de IA no Tenant (os administradores têm), a equipe do Cliente e a equipe da HorusBI.
- Em Chave própria de IA, marque Usar chave própria.
- Escolha o Provedor: OpenAI, Anthropic, Google Gemini, OpenRouter ou Outro provedor (Maritaca, Mistral, Groq, DeepSeek, ou outro informando a URL).
- Cole a Chave de API e clique em Conferir chave. A tela lista os modelos que a chave enxerga.
- Escolha o modelo do modo Rápido e o do modo Raciocínio. Podem ser o mesmo. No chat, eles aparecem como Rápido e Aprofundado.
- Clique em Testar e salvar. A tela faz uma chamada curta com cada modelo e só grava se os dois responderem.
Com a chave própria, todas as chamadas de IA do Tenant saem pela conta da sua empresa: chat, alertas, geradores, Investigações e IA no HorusETL. O provedor cobra direto, e o consumo não entra nos créditos de IA do Tenant. Se a chave falhar, o usuário vê o erro do provedor. A chamada nunca é refeita na conta da plataforma.
Remover a chave própria apaga a chave do Lumo e o Tenant volta aos modelos da plataforma. A chave continua valendo no provedor até você revogá-la lá. Os servidores da DeepSeek ficam na China: confira se a política de dados do cliente aceita.
O Cliente pode ter uma chave para todos os Tenants dele, em Avançado › Inteligência Artificial no cadastro do Cliente. Um Tenant com chave própria usa a dele. O administrador do Tenant não vê a chave do Cliente.
Sem chave própria, Governança de Modelos de IA escolhe o modelo padrão de cada modo e restringe regiões, retenção de dados e provedores. A política do Tenant só aperta a do Cliente, nunca libera o que o Cliente bloqueou. Veja Créditos de IA.
Status
A aba Status mostra a situação do Tenant, desde quando ela vale, o motivo e quem registrou. O histórico guarda cada mudança com Estado, Período, Motivo, Por quem e Durou. Mudanças automáticas, como o fim de um trial, aparecem como Via Sistema. Só a equipe do Cliente e a equipe da HorusBI mudam o status.
| Ação | O que faz | Cobrança |
|---|---|---|
| Suspender | Tranca o acesso de todos os usuários. Pede um motivo | O mês corrente é cobrado inteiro. A cobrança para a partir do mês seguinte |
| Reativar tenant | Devolve o acesso | Volta a cobrar no mês da reativação |
| Iniciar Trial | Abre um período de degustação, de 1 a 35 dias | Não cobra durante o trial |
| Estender Trial | Muda a data de fim do trial, até 35 dias. Pede um motivo | Não cobra durante o trial |
| Ativar Cliente | Converte o trial em Tenant pago | Começa a cobrar no mês da ativação |
Não há cobrança proporcional: antes de confirmar uma suspensão, a tela mostra a partir de qual mês o Tenant deixa de ser cobrado. Um mínimo de Tenants previsto no contrato do Cliente pode manter um valor na fatura mesmo assim.
Num Tenant pós-pago, desativar pela API, com ativo: false, tem o mesmo efeito de suspender, inclusive na cobrança. Num pré-pago, só corta o acesso, e a assinatura continua sendo cobrada. Veja Desativar e excluir.
Quando um trial termina sem ativação, o status vira Trial Expirado e os usuários deixam de entrar. Num Tenant pós-pago, o trial vencido passa a Suspenso na madrugada seguinte, sem desativar o Tenant, e 30 dias depois a Cancelado. Só no cancelamento o Tenant é desativado e as tabelas são apagadas.
O que acontece com os dados
WARNING
Num Tenant pós-pago, suspender apaga as tabelas do data warehouse, embora a tela diga que os dados ficam.
Uma rotina roda todo dia às 05:20 (horário de Brasília) e apaga as tabelas do data warehouse de todo Tenant desativado ou excluído. Não há carência: um Tenant suspenso às 23h perde as tabelas na madrugada seguinte. Ficam de fora as tabelas de Datalake e os registros digitados em Cadastros, que são guardados em outro banco.
O que desativa o Tenant:
- Suspender, num Tenant pós-pago. Num pré-pago, Suspender só corta o acesso e as tabelas ficam.
ativo: falsepela API, em qualquer Tenant, pré-pago também.- Excluir.
Ao reativar, as tabelas voltam vazias. A estrutura é recriada na rotina das 02:30, ou na hora quando a reativação vem pela API com ativo: true. Os dados só voltam quando os Dataflows rodarem de novo.
Excluir um Tenant
Excluir fica no rodapé da aba Geral, só para a equipe do Cliente. Excluir encerra o Tenant de vez: o status vira cancelado, todas as sessões caem e, num Tenant pré-pago, a assinatura é encerrada. Na cobrança, vale o mesmo da suspensão: o mês corrente é cobrado inteiro.
As tabelas do data warehouse do Tenant são apagadas na rotina das 05:20 seguinte. Veja O que acontece com os dados. Não há como desfazer a exclusão pelo HEC.
Se der errado
Nome do Tenant indisponível para uso. Já existe um Tenant com esse nome na plataforma, talvez de outro Cliente. Escolha outro nome.
Você não tem permissão para alterar o status deste tenant! ao reativar. Um Tenant pós-pago suspenso fica desativado, e a equipe do Cliente só muda o status de Tenant ativo. Peça a reativação à equipe da HorusBI ou reative pela API, com ativo: true. Veja Desativar e excluir.
A aba Status não aparece. Ela é só da equipe do Cliente. O administrador do Tenant não muda o status.