Buscar K
Aparência
Gestão de Tenants
O Tenant é a unidade fundamental de organização no Horus. Ele representa um ambiente isolado onde residem todos os seus dados, usuários, aplicações e configurações. Um cliente whitelabel pode ter múltiplos tenants.
TIP
Hierarquia de Configurações: Cliente → Tenant
Muitas configurações definidas no Cliente servem como padrão para seus Tenants. Porém, o Tenant pode sobrescrever essas configurações para personalizar seu próprio ambiente.
📝 Abas de Configuração do Tenant
Ao acessar a edição de um Tenant, você encontrará diversas abas para gerenciar cada aspecto do ambiente:
Geral
O painel de controle principal do tenant.
Informações Básicas
| Campo | Descrição |
|---|---|
| Cliente | Vínculo com o Cliente pai (apenas visível se existirem múltiplos clientes). |
| Nome | Nome de identificação do tenant. |
Identidade Visual
| Campo | Descrição |
|---|---|
| Logo | Imagem de logotipo exibida no topo da aplicação. Formatos aceitos: PNG, JPG, JPEG. Máximo 5MB. |
| Favicon | Ícone exibido na aba do navegador. Formatos aceitos: PNG, JPG, JPEG. Máximo 5MB. |
| Imagem de Login | Imagem hero exibida na tela de login. Formatos aceitos: PNG, JPG, JPEG. Máximo 5MB. |
Domínio e Configurações
| Campo | Descrição |
|---|---|
| Domínio(s) | URLs personalizadas para acesso ao tenant (analytics.suaempresa.com.br). Permite múltiplos domínios separados por vírgula. |
| Instruções do ChatBot | Prompt base personalizado para a IA do assistente virtual neste ambiente. Essas instruções orientam o comportamento do chatbot ao responder perguntas dos usuários. |
| Status | Ativa ou suspende o acesso ao tenant. Quando desativado, usuários não conseguem acessar o ambiente. |
Recursos do Tenant
Visualização e edição dos limites contratados para este tenant:
- Usuários: Limite de usuários simultâneos
- CNPJs: Quantidade de CNPJs vinculados (quando aplicável via billing)
- Processamento (GB/mês): Limite de processamento de dados mensal
- Tokens de IA (mês): Limite de tokens de IA consumidos mensalmente
NOTE
Os recursos são calculados com base na configuração de billing do Cliente. O Tenant pode adicionar "extras" além da base calculada pelos CNPJs.
Suites/Visual
Personalize a aparência de cada módulo (suite) do Horus independentemente.
Configuração por Módulo
Para cada módulo (DataViz, ETL, HEC, DW):
| Campo | Descrição |
|---|---|
| Título | Nome personalizado do módulo exibido na interface. |
| Domínio | URL específica para acesso direto ao módulo. |
| Logo | Logotipo personalizado para o módulo. |
Personalização Visual da Barra de Filtros
Ajuste as cores da barra de filtros globais para alinhar com a identidade visual da sua marca:
| Campo | Descrição |
|---|---|
| Usar cores personalizadas | Ativa a personalização de cores (desabilitado usa as cores padrão). |
| Cores dos filtros | Array de cores em formato hexadecimal (#4E46DD) usadas na barra de filtros. Adicione ou remova cores conforme necessário (mínimo 1, máximo 10). |
| Cor do botão de filtro | Cor do botão de aplicar filtros na barra. |
TIP
Use o preview de cores para visualizar como ficará a barra de filtros antes de salvar as alterações.
ChatBot
Integração com Telegram para funcionalidades de assistente virtual.
| Campo | Descrição |
|---|---|
| Nome de usuário do Telegram | Username do bot do Telegram (@meu_bot). |
| Token do Telegram | Token de API fornecido pelo BotFather do Telegram. |
Usuários
Gestão direta dos usuários que têm acesso a este tenant.
| Ação | Descrição |
|---|---|
| Adicionar Usuário | Busque e adicione usuários existentes na plataforma digitando nome ou email. |
| Remover Acesso | Revogue o acesso de usuários clicando no ícone de lixeira. |
| Recuperar Acesso | Desfaz a remoção antes de salvar clicando no ícone de desfazer. |
IMPORTANT
As alterações de usuários só são efetivadas após clicar em "Salvar Usuários".
Templates
Gerencie os templates instalados neste tenant.
- Visualize quais templates estão ativos
- Instale novos templates a partir da biblioteca global de product lines
- Remova templates que não são mais necessários
Instâncias de WhatsApp
Conecte números de WhatsApp para envio de alertas e interações via chatbot.
O Horus suporta dois modos de integração com WhatsApp:
API Não-Oficial (WhatsApp Web)
| Aspecto | Detalhes |
|---|---|
| Configuração | Escaneie o QR Code para vincular uma nova instância do WhatsApp Web. |
| Requisito | É necessário manter um celular ligado 24 horas com o chip ativo. |
| Vantagem | Permite enviar mensagens livremente, sem restrições de templates pré-aprovados. |
| Status | Gerencie a conexão (Conectado/Desconectado) e reconecte quando necessário. |
API Oficial da Meta
| Aspecto | Detalhes |
|---|---|
| Configuração | Integração via API oficial do WhatsApp Business. |
| Requisito | Templates de mensagem devem ser pré-aprovados pela Meta (Facebook). |
| Limitação | O usuário deve interagir primeiro antes de receber mensagens completas. |
| Fluxo de Alertas | Sistema envia: "Você tem alertas para receber. Digite OK para receber seus alertas pendentes." Após o usuário responder "OK", os alertas completos são enviados. |
| Vantagem | Não requer celular físico ligado, maior estabilidade. |
IMPORTANT
Implantação Customizada: A integração com a API Oficial da Meta requer configuração específica e desenvolvimento sob demanda. Entre em contato com a equipe Horus para viabilizar a implantação no seu ambiente.
Avançado
Configurações técnicas e de infraestrutura.
Configuração de Agentes ETL
| Configuração | Descrição | Valores |
|---|---|---|
| Preservar Contexto dos Agentes | Restringe relacionamentos entre tabelas ao mesmo agente de origem, evitando conflitos de IDs entre sistemas diferentes. Use quando: clientes possuem múltiplos sistemas ERP onde o ID "1" pode significar coisas diferentes em cada sistema. | Liga/Desliga |
| Limite Temporal de Cargas | Restringe a quantidade de dados históricos carregados em cargas temporais. | Liga/Desliga |
| Valor do Limite | Define a janela de tempo para cargas temporais. | Número + Unidade (dias/meses/anos) |
| Granularidade de Agendamento | Define a menor unidade de tempo disponível para agendar cargas ETL. "Minutos" permite maior frequência, "Horas" simplifica a interface. | Minutos (padrão) / Horas |
NOTE
O Limite Temporal é útil para otimizar performance quando não é necessário carregar todo o histórico. Por exemplo, carregar apenas os últimos 30 dias de vendas.
SMTP Customizado
Configure um servidor de email próprio para o envio de notificações deste tenant, substituindo o padrão da plataforma.
| Campo | Descrição |
|---|---|
| Usar SMTP Customizado | Ativa a configuração personalizada de email. |
| Host SMTP | Endereço do servidor SMTP (smtp.gmail.com). |
| Porta SMTP | Porta do servidor (normalmente 587 para TLS ou 465 para SSL). |
| Usuário SMTP | Usuário para autenticação no servidor. |
| Senha SMTP | Senha para autenticação no servidor. |
| Email Remetente | Endereço de email que aparecerá como remetente. |
| Nome Remetente | Nome que aparecerá como remetente. |
| Usar SSL/TLS | Ativa criptografia na conexão. |
| Testar Configuração SMTP | Botão para enviar um email de teste e validar as configurações antes de salvar. |
TIP
Use o botão Testar Configuração SMTP para validar suas configurações antes de salvar. Um email de teste será enviado para o endereço informado.
Template de Email
Personalize o visual dos emails enviados pelo sistema (header, footer, cores, logotipo, etc). O conteúdo específico de cada email é gerado automaticamente pelo sistema — aqui você customiza apenas o template visual que envolve esse conteúdo.
| Ação | Descrição |
|---|---|
| Editar Template | Abre o editor visual de templates MJML. |
Editor de Template
O editor utiliza MJML (Mailjet Markup Language), uma linguagem responsiva para criação de emails. A interface é dividida em:
| Área | Descrição |
|---|---|
| Editor MJML | Editor de código com syntax highlighting para escrever o template. |
| Preview | Visualização em tempo real do email renderizado. |
| Variáveis | Lista de variáveis disponíveis para uso no template. |
| Imagens | Gerenciador de imagens para upload e uso no template. |
Variáveis Disponíveis
| Variável | Descrição |
|---|---|
{{_clientName}} | Nome do cliente ou tenant. |
{{_assunto}} | Assunto do email. |
{{_conteudo}} | Conteúdo do email (obrigatório). |
IMPORTANT
A variável {{_conteudo}} é obrigatória e deve estar presente no template. Ela será substituída pelo conteúdo específico de cada email enviado pelo sistema.
Upload de Imagens
Para usar imagens no template:
- Salve o template primeiro (necessário para habilitar upload).
- Faça upload da imagem pelo gerenciador.
- Copie a URL ou a tag MJML gerada.
- Use no código do template (
<mj-image src="URL" />).
Hierarquia de Templates
O sistema segue uma ordem de prioridade para determinar qual template usar:
1. Template do Tenant (se customizado)
└── 2. Template do Cliente (se customizado)
└── 3. Template Padrão da Plataforma| Status | Descrição |
|---|---|
| Usando Padrão | O tenant/cliente está usando o template herdado (do nível superior ou padrão do sistema). |
| Customizado | O tenant/cliente possui um template próprio. |
| Restaurar | Remove a customização e volta a usar o template do nível superior. |
TIP
Consulte a documentação oficial do MJML para aprender mais sobre componentes disponíveis e boas práticas de email responsivo.
Gerador de JWT
Crie chaves para autenticação segura entre o Horus e sistemas externos (ERP, APIs, etc).
| Campo | Descrição |
|---|---|
| Habilitar Gerador de JWT | Ativa a funcionalidade de geração de tokens JWT. |
| Chave JWT | Chave secreta compartilhada entre Horus e seu sistema externo (até 128 caracteres, mínimo 16). |
| Gerar Aleatória | Gera uma chave criptograficamente segura de 128 caracteres. |
| Testar JWT | Gera um token de teste e exibe seu payload decodificado. |
Caso de Uso: Integração Segura BI ↔ Sistemas Externos
Imagine um Dashboard que lista pedidos pendentes de aprovação com um botão "Aprovar Pedido" em cada linha. Ao clicar, o Widget precisa chamar a API do seu ERP para aprovar o pedido.
O Problema: Armazenar credenciais de API (tokens, senhas) no código JavaScript do frontend é uma falha crítica de segurança — qualquer usuário pode inspecionar o código e roubar as credenciais.
A Solução: O Gerador de JWT cria um mecanismo de confiança entre dois servidores:
O Fluxo:
- Widget Svelte chama
app.generateJWTToken()— o backend Horus gera um token assinado com a chave JWT configurada - O token contém: ID do usuário logado, ID do tenant, timestamp
- Widget envia o token para sua API externa
- Sua API valida o token usando a mesma chave JWT configurada no lado dela
- Se válido, sua API confia que a requisição veio de um usuário autenticado no Horus
Payload do Token:
json
{
"userId": 123,
"tenantId": 456,
"data": "2024-01-15T10:30:00.000Z"
}IMPORTANT
Segurança: A chave JWT nunca trafega pelo browser. Ela fica apenas nos servidores (Horus + seu sistema). O que trafega é o token assinado, que pode ser validado mas não forjado sem a chave.
Veja a documentação completa de Widgets Svelte para exemplos de código.
Permissões e Segurança
| Configuração | Descrição | Padrão |
|---|---|---|
| Proteger mesas criadas via templates | Quando ativado, mesas criadas automaticamente por templates ficam somente leitura, não permitindo a customização de seu conteúdo. | Desligado |
| Permitir usuários não-admin compartilhar alertas | Permite que usuários comuns compartilhem seus alertas com outros usuários. | Desligado |
| Mostrar usuários admin ao compartilhar alertas | Quando o compartilhamento por não-admins está ativado, define se usuários admin aparecem na lista de destinatários. | Desligado |
| Usuários não-admin não podem criar apps/editar dados | Restringe a criação de aplicações e edição de abas de dados apenas para administradores. Se ativado os usuários não administradores com permissão de editar aplicações ainda podem clonar aplicações publicadas para suas mesas, porém só podem editar Dashboards, não podendo editar modelagem de dados e expressões. | Desligado |
| Permitir usuários criarem Dashboards pessoais em aplicações publicadas | Permite que usuários criem Dashboards personalizados dentro de aplicações publicadas. Estes Dashboards ficam salvos na conta do usuário e não afetam a aplicação original. | Desligado |
| Permitir usuários compartilharem Dashboards pessoais | Quando os Dashboards pessoais estão habilitados, esta opção permite que usuários compartilhem seus Dashboards com outros usuários do tenant. | Desligado |
Canais de Alerta
Defina quais canais de notificação estão disponíveis para os usuários configurarem seus alertas:
| Canal | Descrição |
|---|---|
| Envio de alertas via WhatsApp (requer instância configurada). | |
| Telegram | Envio de alertas via bot do Telegram. |
| Envio de alertas para o email cadastrado do usuário. | |
| Webhook | Envio de alertas para um endpoint HTTP customizado. |
Quando Webhook está habilitado:
| Campo | Descrição |
|---|---|
| URL do Webhook | Endpoint HTTP que receberá as notificações de alerta. |
| Documentação | Botão para visualizar a documentação técnica do payload enviado. |
Configuração de IA
Personalize o provedor e modelo de IA usado neste tenant.
| Modo | Descrição |
|---|---|
| Usar configuração do Cliente | Herda as configurações de IA do Cliente pai. |
| Usar configuração personalizada | Define um provedor de IA próprio para este tenant. |
| Modelo padrão de IA | Quando não usa configuração personalizada, seleciona o modelo padrão entre os disponíveis na plataforma. |
Configuração Personalizada de IA:
| Campo | Descrição |
|---|---|
| Provedor | OpenAI, Google Gemini ou OpenRouter. |
| Chave da API | Chave de acesso do provedor escolhido. |
| Modelos Disponíveis | Lista de modelos que estarão disponíveis (ID e Nome amigável). |
| Modelo Padrão | Qual modelo será usado por padrão nas requisições. |
CAUTION
Ao usar configuração personalizada de IA, os custos de utilização serão cobrados diretamente pelo provedor escolhido, não pela plataforma Horus.
Desenvolvedor
Área destinada a integrações via API.
| Item | Descrição |
|---|---|
| Chave de API | Token de acesso para programar automações e integrações externas. |
| Visualizar | Ícone de olho para revelar o token. |
| Copiar | Copia o token para a área de transferência. |
| Regenerar | Cria um novo token (invalida o anterior). |
| Documentação | Links para Lumo Docs, Swagger e Redoc. |
WARNING
Use com cautela: O token dá acesso administrativo aos recursos do tenant. Nunca compartilhe ou exponha publicamente.
Trial
(Visível apenas se habilitado no Cliente)
Gerencie o período de degustação do tenant:
- Defina data de expiração do trial
- Configure limites provisórios para o período de testes
🏢 Configurações do Cliente
O Cliente é a entidade pai que agrupa múltiplos Tenants. As configurações do Cliente servem como padrão para todos os seus Tenants.
Geral (Cliente)
| Campo | Descrição |
|---|---|
| Nome | Nome de identificação do cliente. |
| Nome da IA | Nome personalizado para a assistente de IA (padrão: Lumia). Apenas clientes whitelabel. |
| Logo/Favicon/Imagem de Login | Identidade visual padrão para todos os tenants. |
| Domínio Principal | URL principal do cliente. |
| Cliente Whitelabel | Marca o cliente como whitelabel (permite customizações avançadas). |
| Possui Trial | Habilita período de degustação para novos tenants. |
| Dias de Trial | Duração padrão do período de trial. |
| Template Padrão | Template instalado automaticamente em novos tenants. |
| Tenants precisam definir CNPJ | Torna obrigatório o cadastro de CNPJ nos tenants. |
Suites/Visual (Cliente)
Mesma estrutura do Tenant, mas define os valores padrão para todos os tenants do cliente.
ChatBot (Cliente)
Configuração de Telegram e instruções do chatbot que serão herdadas pelos tenants.
Avançado (Cliente)
Todas as configurações avançadas (ETL, SMTP, JWT, Permissões, Alertas, IA) funcionam como padrão para novos tenants. Cada tenant pode sobrescrever essas configurações.
Usuários (Cliente)
Gerenciamento de usuários no nível do cliente, com controle de quotas baseado na configuração de billing.
Desenvolvedor (Cliente)
Chave de API e documentação no nível do cliente.
Instâncias de WhatsApp (Cliente)
Gerenciamento de instâncias de WhatsApp compartilhadas entre todos os tenants do cliente.
Tenants (Cliente)
Ferramenta de comparação e sincronização de configurações entre o Cliente e seus Tenants.
Visão Geral
Esta aba permite visualizar quais configurações dos tenants divergem das configurações padrão do cliente. É útil para identificar customizações e manter a consistência entre os ambientes.
Modos de Visualização
| Modo | Descrição |
|---|---|
| Por Tenant | Lista cada tenant mostrando quantas configurações divergem do cliente. Ao expandir, exibe uma tabela comparativa com o valor no cliente vs. valor no tenant. |
| Aplicar em Massa | Agrupa as divergências por tipo de configuração. Mostra quantos tenants possuem valor diferente para cada configuração, permitindo aplicar a configuração do cliente em todos de uma vez. |
Ações Disponíveis
| Ação | Descrição |
|---|---|
| Usar do Cliente | Aplica a configuração do cliente em um tenant específico para uma configuração específica. |
| Aplicar em Massa | Sincroniza uma configuração específica para todos os tenants que possuem valor divergente. |
| Atualizar | Recarrega a lista de divergências. |
TIP
Use o modo Aplicar em Massa quando precisar padronizar uma configuração específica (como canais de alerta ou configuração de IA) em todos os tenants de uma vez.
IMPORTANT
A sincronização sobrescreve o valor atual do tenant pelo valor configurado no cliente. Esta ação não pode ser desfeita automaticamente.
🔗 Herança de Configurações
O sistema de configurações segue uma hierarquia de herança:
Cliente (Padrão)
└── Tenant (Sobrescrita)| Configuração | Comportamento |
|---|---|
| Identidade Visual | Tenant pode ter logo/cores próprias ou herdar do Cliente. |
| SMTP | Tenant pode definir servidor próprio ou usar do Cliente. |
| Template de Email | Tenant pode personalizar ou herdar do Cliente; Cliente herda do padrão da plataforma. |
| IA | Tenant pode usar configuração própria, do Cliente, ou padrão da plataforma. |
| Agentes ETL | Configurações são herdadas e podem ser sobrescritas. |
| Permissões | Flags de permissões são independentes por Tenant. |
| Canais de Alerta | Tenant define quais canais estão disponíveis. |