Gestão de Clientes

O Cliente é a entidade de nível superior na hierarquia do Horus. Ele representa a organização que licenciou a plataforma (uma consultoria de dados, uma software house, uma holding, etc.) e agrupa um ou mais Tenants sob sua gestão.

A tela de edição do Cliente contém diversas abas de configuração. Esta página foca na aba Usuários, que é onde se gerenciam os membros da equipe do Cliente, seus níveis de acesso e a funcionalidade de impersonação.

NOTE

Para configurações das demais abas do Cliente (Geral, Suites/Visual, ChatBot, Avançado, Billing, Desenvolvedor, Tenants, Instâncias de WhatsApp), consulte a seção Configurações do Cliente na documentação de Gestão de Tenants.

---

👥 Aba Usuários

A aba Usuários exibe todos os membros vinculados ao Cliente, permitindo adicionar ou remover pessoas, definir o nível de acesso de cada uma e configurar permissões de impersonação.

Visão Geral da Tela

No topo da aba, um painel informativo mostra:

• Usuários do Cliente: Quantidade atual de usuários em relação ao limite contratado (4 / 3)
• Extras: Caso o número de usuários exceda o limite, a quantidade extra é destacada junto ao custo adicional estimado

WARNING

Usuários acima do limite contratado geram cobrança adicional conforme o valor definido na configuração de billing do Cliente.

Abaixo do painel, estão disponíveis:

• Botão "+ Adicionar": Para vincular novos usuários ao Cliente
• Campo de busca: Filtre por nome ou login (e-mail)
• Filtros por nível: Botões que filtram a lista por nível de acesso (Todos, Superadministrador, Implantador, Operador), cada um exibindo a contagem de usuários naquele nível

Adicionando Usuários

Para adicionar um membro à equipe do Cliente:

1. Utilize o campo de busca ao lado do botão "+ Adicionar" para localizar o usuário pelo nome ou login.
2. Selecione o usuário desejado na lista de sugestões.
3. Clique em + Adicionar.

O usuário será adicionado com o nível Operador por padrão. Você pode alterar o nível de acesso usando o seletor na coluna "Nível de Acesso".

IMPORTANT

Ao adicionar um usuário ao Cliente, ele automaticamente recebe acesso a todos os Tenants daquele Cliente. As alterações só são efetivadas após clicar em Salvar.

Removendo Usuários

Para remover um membro:

1. Clique no ícone de lixeira na coluna "Ações" do usuário que deseja remover.
2. O usuário será marcado visualmente para remoção (fundo avermelhado e texto riscado).
3. Caso mude de ideia, clique no ícone de desfazer que aparece no lugar da lixeira.
4. Clique em Salvar para efetivar a remoção.

NOTE

A remoção só é efetivada ao salvar. Enquanto não salvar, é possível desfazer a ação.

---

🔐 Níveis de Acesso

Cada usuário do Cliente possui um nível de acesso. Vale entender o que ele decide, e o que ele não decide, antes de escolher um.

O nível responde pelo que a pessoa faz no Cliente: criar Tenants, ver o faturamento, gerenciar os outros usuários do Cliente. Já o que ela faz dentro de cada Tenant vem do grupo padrão apontado para ela. Sem grupo padrão, ela entra nos Tenants como administradora do ambiente.

É por isso que dois níveis diferentes podem ter o mesmo poder dentro de um Tenant, e por que dar um grupo padrão a alguém é a forma de restringir esse poder sem inventar um nível novo.

Existem cinco níveis:

Superadministrador

O nível mais alto de acesso no contexto do Cliente. O Superadministrador tem controle total sobre a gestão do Cliente e seus Tenants.

Permissões:

• Criar novos Tenants
• Gerenciar dados do Cliente (aba "Gerenciar Dados" no menu)
• Gerenciar usuários do Cliente (adicionar, remover, alterar níveis)
• Acessar o Dashboard de Faturamento
• Exportar relatórios de billing
• Visualizar custos na Home do HEC
• Gerenciar instâncias de WhatsApp
• Acessar configurações avançadas do Cliente

NOTE

Dentro de cada Tenant do Cliente, o Superadministrador é sempre administrador do ambiente. Ele é o único nível que não aceita grupo padrão, justamente para não haver como trancá-lo fora do próprio ambiente.

Implantador

Um nível intermediário, focado na operação e implantação de ambientes. O Implantador pode criar e configurar Tenants, mas não tem acesso à gestão administrativa do Cliente em si.

Permissões:

• Criar novos Tenants
• Acessar o Dashboard de Faturamento
• Exportar relatórios de billing
• Visualizar custos na Home do HEC
• Gerenciar instâncias de WhatsApp

Restrições:

• Não pode gerenciar dados do Cliente (a opção "Gerenciar Dados" não aparece no menu)
• Não pode adicionar, remover ou alterar níveis de outros usuários do Cliente

NOTE

Dentro de cada Tenant do Cliente, o Implantador entra, por padrão, como administrador do ambiente. Veja Grupo padrão por usuário para atribuir a ele um grupo específico em vez disso.

Operador

O nível mais restrito no escopo do Cliente: não cria Tenants, não gerencia dados do Cliente nem outros usuários do Cliente.

IMPORTANT

Isso não significa privilégio reduzido dentro dos Tenants. Sem um grupo padrão atribuído, o Operador entra em todos os Tenants do Cliente como administrador do ambiente, com acesso total, do mesmo jeito que o Implantador e o Superadministrador. Veja Grupo padrão por usuário para restringir esse acesso.

Permissões:

• Visualizar custos na Home do HEC (quando disponível)

Restrições:

• Não pode criar Tenants
• Não pode gerenciar dados do Cliente
• Não pode gerenciar outros usuários do Cliente
• No menu lateral, não vê as opções administrativas do Cliente (Criar Tenant, Lista de Tenants, Gerenciar Dados). Dentro de cada Tenant, o que ele vê depende do grupo padrão: sem grupo padrão, vê os mesmos menus de um administrador de Tenant

Faturamento (somente leitura)

Nível para quem precisa apenas consultar o Relatório de Uso do cliente, sem nenhum acesso administrativo. Quem recebe esse nível:

• Vê: o Relatório de Uso/Faturamento do cliente, com todos os Tenants, em modo somente leitura.
• Não vê / não faz: os dados dos Tenants (aplicações, tabelas, dataflows, dashboards, usuários), fechar ou reabrir faturas, nem qualquer outra área administrativa.

Diferente dos demais níveis, a atribuição é aditiva: ela apenas libera a entrada no HEC e o Relatório de Uso, sem alterar nenhum acesso que o usuário já tenha em outros ambientes. Para atribuir, basta escolher Faturamento (somente leitura) no seletor de nível ao adicionar ou editar o usuário do cliente.

Suporte

Nível para quem presta suporte aos ambientes do Cliente sem ocupar o papel de administrador deles. Quem recebe esse nível entra em todos os Tenants do Cliente por um Grupo Padrão escolhido, nunca no grupo Administradores.

O grupo é escolhido no cadastro do Cliente, na aba Usuários, junto do seletor de nível. Diferente do Implantador e do Operador, aqui o grupo é obrigatório: salvar alguém como Suporte sem escolher um grupo é recusado, citando o nome da pessoa.

O que a pessoa vê e pode fazer dentro do Tenant é o que aquele Grupo Padrão dá, inclusive o acesso aos dados, que vem das marcações do grupo (veja Grupos Padrão mais abaixo).

Permissões:

• Acessar os Tenants do Cliente pelo Grupo Padrão escolhido, com o que esse grupo libera (suítes, funções e, quando marcado, acesso aos dados)
• Contratar recursos e aumentar os limites do Tenant pelo HEC, quando a opção Contratar recursos estiver marcada para a pessoa

Restrições:

• Não pode criar Tenants
• Não pode gerenciar dados do Cliente
• Não pode gerenciar outros usuários do Cliente
• Não acessa o Dashboard de Faturamento, não exporta relatórios de billing e não vê custos na Home do HEC
• Sem a opção Contratar recursos marcada, vê a quota do Tenant, mas não contrata mais

NOTE

Se o Grupo Padrão escolhido não existir em algum Tenant do Cliente, a pessoa não entra em nenhum grupo naquele Tenant. Ela nunca cai no grupo Administradores como alternativa.

TIP

Como os demais níveis de usuário do Cliente, quem tem nível Suporte não conta na licença de usuários do Tenant e não aparece na lista de usuários de quem administra o Tenant.

Grupo padrão por usuário

O nível diz o que a pessoa faz no Cliente: criar Tenants, ver o faturamento, gerenciar outros usuários. O que ela faz dentro de cada Tenant é decidido pelo grupo padrão.

Implantador, Operador e Suporte podem apontar para um dos grupos definidos na seção Grupos Padrão do Cliente. Quem aponta para um grupo entra em todos os Tenants do Cliente por ele, em vez do grupo Administradores.

A diferença entre os níveis está no que acontece quando não há grupo escolhido:

Nível	Sem grupo padrão
Implantador e Operador	Entram como administradores do ambiente em todos os Tenants do Cliente. É uma configuração válida, não uma pendência a resolver.
Suporte	Não pode ficar sem grupo. O salvamento é recusado.

É assim que se monta um acesso sob medida sem criar um nível novo: escolha o nível pelo que a pessoa precisa fazer no Cliente, e monte o grupo padrão com o que ela precisa fazer dentro dos ambientes.

NOTE

O Superadministrador não recebe grupo padrão: ele é sempre administrador de todos os Tenants do Cliente. É a conta que não pode se trancar fora do próprio ambiente.

Tabela Comparativa

Funcionalidade	Superadministrador	Implantador	Operador	Faturamento (somente leitura)	Suporte
Criar Tenants	Sim	Sim	Não	Não	Não
Gerenciar dados do Cliente	Sim	Não	Não	Não	Não
Gerenciar usuários do Cliente	Sim	Não	Não	Não	Não
Dashboard / Relatório de Faturamento	Sim	Sim	Sim	Sim	Não
Exportar relatórios de billing	Sim	Sim	Sim	Não	Não
Fechar / reabrir fatura	Sim	Não	Não	Não	Não
Ver custos na Home do HEC	Sim	Sim	Sim	Não	Não
Contratar recursos / aumentar limites do Tenant	Sim	Sim	Sim	Não	Só com a opção marcada
Gerenciar instâncias de WhatsApp	Sim	Sim	Não	Não	Não
Pode receber grupo padrão	Não	Sim	Sim	Não	Sim, obrigatório
Sem grupo padrão, entra nos Tenants como administrador	Sim	Sim	Sim	Não entra nos Tenants	Nunca fica sem grupo

TIP

Ao adicionar um novo membro, ele sempre entra como Operador. Altere o nível antes de salvar caso seja necessário um acesso mais amplo.

---

🧭 Menu Lateral por Nível

O menu lateral do HEC se adapta de acordo com o nível de acesso do usuário do Cliente:

Superadministrador vê no menu:

• Tenants: Criar Tenant e Lista de Tenants
• Clientes: Gerenciar Dados

Implantador vê no menu:

• Tenants: Criar Tenant e Lista de Tenants

Operador não vê, no Cliente, opções administrativas de Cliente ou Tenant no menu lateral (como Criar Tenant, Lista de Tenants ou Gerenciar Dados). Dentro de cada Tenant, o menu que ele vê depende do grupo padrão atribuído a ele: sem grupo padrão, entra como administrador do ambiente e vê os mesmos menus de um administrador de Tenant; com grupo padrão, vê o menu correspondente às funções daquele grupo.

Suporte também não vê opções administrativas de Cliente ou Tenant no menu lateral. Ele navega pelo Tenant como um usuário comum, pelos menus que o Grupo Padrão escolhido libera. Quando a opção Contratar recursos está marcada para a pessoa, o item de Recursos do Tenant aparece no menu, como para qualquer outro usuário com esse acesso.

---

🔄 Impersonação

A funcionalidade de impersonação permite que um usuário do Cliente acesse a plataforma "como se fosse" outro usuário. Isso é útil para suporte, diagnóstico de problemas ou validação de configurações de permissão — sem precisar solicitar as credenciais do usuário final.

Como Funciona

1. Habilitação: Na aba Usuários da edição do Cliente, marque a checkbox "Impersonar" ao lado do usuário que terá permissão de impersonar outros usuários.
2. Salvamento: Clique em Salvar para efetivar a permissão.
3. Uso: O usuário com permissão de impersonar verá a opção de impersonação no menu lateral do HEC. Ao clicar, uma lista de usuários impersonáveis será exibida.
4. Seleção: Ao selecionar um usuário da lista, o sistema fará login como aquele usuário, mantendo a rastreabilidade.

Quem Pode Ser Impersonado

A impersonação possui restrições de segurança. Ao ativar a permissão para um usuário, ele poderá impersonar apenas:

• Usuários finais dos Tenants que pertencem ao mesmo Cliente
• Usuários que estejam ativos no sistema
• Usuários vinculados a Tenants ativos daquele Cliente

Não podem ser impersonados:

• Outros usuários do Cliente (Superadministradores, Implantadores ou Operadores)
• Administradores da plataforma Horus

IMPORTANT

A permissão de impersonar é concedida no nível do Cliente, não por usuário-alvo individual. Isso significa que, ao habilitar a impersonação para um membro, ele poderá impersonar qualquer usuário final elegível dos Tenants daquele Cliente.

🔍 Auditoria

Todas as ações realizadas durante uma sessão de impersonação são registradas no log de auditoria vinculadas ao usuário original (quem está impersonando), não ao usuário impersonado. Isso garante rastreabilidade completa.

Na primeira vez que um usuário utiliza a funcionalidade de impersonação, um aviso de auditoria será exibido informando que todas as ações continuarão sendo registradas em seu nome. Após reconhecer o aviso, ele não será exibido novamente.

WARNING

A impersonação é uma ferramenta poderosa. Conceda essa permissão apenas a membros de confiança que necessitem realizar suporte ou validações nos ambientes dos clientes finais.

Retornando ao Acesso Original

Após concluir a tarefa como usuário impersonado, utilize a opção "Voltar ao meu acesso" disponível no menu lateral para encerrar a sessão de impersonação e retornar ao seu usuário original.

---

💰 Custos e Faturamento

Usuários do Cliente têm acesso a informações de custos e faturamento em diferentes pontos da plataforma. A visibilidade dos dados financeiros está disponível para todos os níveis de acesso (Superadministrador, Implantador e Operador), desde que o Cliente possua configuração de billing ativa.

Home do HEC

Na tela inicial do HEC, os cards de resumo exibem o consumo do Tenant atual junto com os custos associados (quando disponíveis). Os custos são apresentados entre parênteses ao lado de cada métrica:

Card	Informação Exibida
Usuários	Total de usuários ativos e custo associado
Processamento	Volume processado (GB) e custo
Tokens de IA	Tokens consumidos e custo
CNPJs	Quantidade de CNPJs vinculados e custo (exibido apenas quando aplicável)

Abaixo dos cards individuais, um totalizador apresenta o custo total estimado do Tenant no período selecionado.

NOTE

Os custos só aparecem nos cards quando o Tenant pertence a um Cliente com configuração de billing ativa. Em Tenants sem billing configurado, apenas os dados de consumo (sem valores monetários) são exibidos.

Dashboard de Faturamento

O botão Dashboard de Faturamento aparece na tela de edição do Cliente quando existe configuração de billing ativa. Ele abre uma página dedicada com visão detalhada de:

• Custos por categoria (usuários, processamento, IA, CNPJs)
• Histórico de consumo e faturamento
• Detalhamento por Tenant

📄 Exportar Relatórios

O botão Exportar Relatórios permite gerar relatórios de faturamento nos seguintes formatos:

Formato	Descrição
PDF	Relatório formatado para impressão e compartilhamento
Excel	Planilha com dados detalhados para análise
ZIP	Pacote contendo PDF e Excel

Os relatórios podem ser gerados por período mensal ou por intervalo de datas personalizado.

---

📊 Quota de Usuários

O sistema controla a quantidade de usuários do Cliente com base na configuração de billing:

• Limite contratado: Quantidade de usuários incluídos no plano (3 usuários)
• Usuários extras: Cada usuário além do limite gera um custo adicional por usuário (R$ 90,00/usuário extra)
• O painel no topo da aba Usuários exibe essa informação de forma clara, incluindo um alerta quando o limite é ultrapassado

TIP

Acompanhe regularmente a relação entre usuários ativos e o limite contratado para evitar custos adicionais inesperados. Considere remover usuários que não precisam mais de acesso ao nível do Cliente.

---

👥 Grupos Padrão

A configuração de Grupos Padrão permite que o Cliente defina previamente uma lista de Grupos que serão criados automaticamente em todos os novos Tenants vinculados a ele. É útil para padronizar a estrutura inicial de permissões — por exemplo, garantir que todo Tenant nasça com grupos como "Analistas Financeiros", "Operação" ou "Visualizadores Comerciais" já configurados, sem que cada Tenant precise ser ajustado manualmente após a criação.

Onde Configurar

A definição é feita na tela de edição do Cliente:

1. Acesse a edição do Cliente.
2. Vá até a aba Avançado.
3. Localize a seção Grupos Padrão.
4. Adicione, edite ou remova grupos conforme a necessidade.
5. Para cada grupo, defina:
   • Nome do grupo
   • O que este grupo é: duas marcações que definem quem controla o grupo depois que o Tenant existe (veja a tabela abaixo)
   • Acesso aos dados: marcações que definem o que o grupo enxerga de dashboards, mesas de dados e Cadastros (veja a tabela abaixo)
   • Suítes às quais o grupo terá acesso e, dentro de cada uma, as Funções do Sistema liberadas
6. Clique em Salvar.

As marcações de "O que este grupo é" e "Acesso aos dados":

Marcação	O que faz
Gerenciado por você	O administrador do Tenant não renomeia, não exclui e não muda as permissões do grupo. O que o Cliente alterar aqui chega aos Tenants ao salvar.
Invisível para o Tenant	O grupo some para quem não é da equipe do Cliente. Marca "Gerenciado por você" junto, porque um implica o outro.
Todos os dashboards e os dados deles	Acesso a todas as mesas de aplicação, aplicações e tabelas do Tenant. É tudo ou nada, igual à regra do administrador.
Todas as mesas de dados	O mesmo, para as mesas de dados (ETL/DW).
Pode escrever em Cadastros	Sem isso, os Cadastros (writeback) abrem só para leitura. Só fica disponível junto com "Todos os dashboards", que é o que o sistema exige.

NOTE

Esse acesso aos dados não cria linhas de permissão: a pessoa não aparece em "quem tem acesso a esta tabela" nem nas listas de permissão de mesa. É uma regra avaliada na hora da consulta, igual à do administrador.

A escolha das Suítes deixou de ser um campo de seleção múltipla. Agora cada suíte aparece como um cartão que mostra se está liberada e quantas funções o grupo tem nela. Ao liberar uma suíte, todas as funções dela aparecem listadas, com busca; a função ainda não liberada tem um botão Liberar, e a liberada mostra Ver, Criar, Editar, Excluir e Publicar para ligar e desligar cada permissão. Sem Ver, a função não aparece para quem está no grupo. Tirar uma suíte avisa quantas funções saem junto.

NOTE

O botão Restaurar padrões preenche a lista com os mesmos 3 grupos do fallback do sistema (DataViz, Visualizadores e Desenvolvedor), porém o Desenvolvedor vem sem a função developer — esse privilégio é reservado a administradores e não pode ser concedido via Grupos Padrão. Se o objetivo é ter um grupo Desenvolvedor com a função developer, basta deixar a lista vazia: o sistema aplicará o fallback completo automaticamente.

Comportamento

A criação dos grupos acontece automaticamente no momento em que um novo Tenant do Cliente é provisionado, seguindo as regras abaixo:

Cenário	Grupos Criados no Novo Tenant
Cliente não definiu grupos padrão (lista vazia ou ausente)	Administradores + grupos de fallback do sistema (DataViz com suite bi, Visualizadores com suite bi e Desenvolvedor com função developer + suite hec)
Cliente definiu grupos padrão	Administradores + os grupos definidos pelo Cliente

IMPORTANT

O grupo Administradores é sempre criado pelo sistema em todo Tenant novo, independentemente da configuração do Cliente. Não é necessário (nem permitido) incluí-lo na lista de grupos padrão.

Ao salvar o cadastro do Cliente, a lista de Grupos Padrão também se propaga para os Tenants que já existem, não só para os novos:

• Um grupo novo na lista, que acabou de ser adicionado, nasce em todos os Tenants existentes do Cliente.
• Um grupo marcado Gerenciado por você é sempre garantido nesses Tenants, e tem nome, suítes e funções sincronizados sempre que o Cliente altera a definição dele, mesmo que algum Tenant o tenha excluído antes.
• Um grupo padrão comum que já constava na lista, e que um Tenant excluiu por conta própria, não volta sozinho só porque o cadastro do Cliente foi salvo de novo.

Validações

Ao definir os grupos padrão, o sistema aplica as seguintes regras:

• Sem grupo do tipo admin: o tipo administrador é exclusivo do grupo Administradores criado pelo sistema. Apenas grupos do tipo group são aceitos na lista.
• Sem função developer: o privilégio de desenvolvedor é reservado a administradores e não pode ser concedido por meio dos grupos padrão.
• Nomes únicos: não é permitido cadastrar dois grupos com o mesmo nome na lista.

O que não é afetado

• Grupos que o Tenant criou por conta própria, fora da lista de Grupos Padrão, nunca são tocados pela sincronização descrita acima.
• Grupo padrão comum que o Tenant excluiu por conta própria: se ele já constava na lista antes e não está marcado como Gerenciado por você, ele não volta sozinho só porque o Cliente foi salvo de novo.
• Grupos manuais: depois que o Tenant é criado, os administradores do Tenant continuam podendo criar, editar e remover os próprios grupos normalmente, conforme descrito em Gestão de Grupos. A exceção são os grupos que vieram do Cliente e estão marcados como Gerenciados por você: neles, nome, permissões e exclusão ficam bloqueados para o Tenant (veja Gestão de Grupos, aba Geral).

TIP

Use os Grupos Padrão para refletir a estrutura organizacional típica dos seus Tenants. Se o seu Cliente atende sempre o mesmo tipo de operação (por exemplo, varejo), pré-configurar grupos como "Compras", "Vendas" e "Financeiro" economiza tempo de implantação a cada novo Tenant.