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, Visualizador), 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 Visualizador 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 que determina o que ele pode fazer na plataforma. Existem três 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

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

Visualizador

O nível mais restrito. O Visualizador acessa os Tenants do Cliente como um usuário comum, sem privilégios administrativos.

Permissões:

• Acessar os Tenants do Cliente como usuário normal
• 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
• Não tem acesso a menus administrativos de Cliente ou Tenant no menu lateral

Tabela Comparativa

Funcionalidade	Superadministrador	Implantador	Visualizador
Criar Tenants	Sim	Sim	Não
Gerenciar dados do Cliente	Sim	Não	Não
Gerenciar usuários do Cliente	Sim	Não	Não
Dashboard de Faturamento	Sim	Sim	Sim
Exportar relatórios de billing	Sim	Sim	Sim
Ver custos na Home do HEC	Sim	Sim	Sim
Gerenciar instâncias de WhatsApp	Sim	Sim	Não
Acessar Tenants como usuário normal	Sim	Sim	Sim

TIP

Ao adicionar um novo membro, ele sempre entra como Visualizador. 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

Visualizador não vê opções administrativas de Cliente ou Tenant no menu lateral. Ele navega pelos Tenants como um usuário comum, utilizando os menus padrão do HEC.

---

🔄 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 Visualizadores)
• 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 Visualizador), 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
   • Suites às quais o grupo terá acesso (por exemplo: bi, hec)
   • Funções do Sistema com as permissões granulares: leitura, criação, atualização, exclusão e publicação
6. Clique em Salvar.

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.

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

• Tenants existentes mantêm seus grupos atuais. A configuração de Grupos Padrão não altera, cria ou remove grupos de Tenants já provisionados — vale apenas para Tenants criados após a definição.
• Grupos manuais: depois que o Tenant é criado, os administradores do Tenant continuam podendo criar, editar e remover grupos normalmente, conforme descrito em Gestão de Grupos.

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.