Super Admin
Operação/suporte da EvoluAI: acesso a todas as empresas e ferramentas internas.
Super Admin
Este capítulo descreve funções da operação/suporte da EvoluAI. No sistema, apenas usuários com o papel Super Admin acessam estas telas.
O Super Admin não pertence a uma empresa específica: por isso enxerga todas as empresas e acessa ferramentas internas da plataforma. Tem tudo do Admin da Empresa (em qualquer empresa) e, além disso, três áreas próprias: Empresas, Planos e Depuração do Sistema.
Suas telas (além das do Admin da Empresa)
| Tela | O que você faz |
|---|---|
| Usuários (gestão de pessoas) | Gerencia usuários de qualquer empresa, incl. mudar o papel. |
| Empresas | Gerencia as 50 empresas mais recentes: créditos, nível de plano, criar/remover. |
| Planos | Mantém o catálogo de planos da plataforma. |
| Depuração do Sistema | Saúde do sistema, filas, bloqueios/avisos, cron, coleta e recuperação. |
Empresas
A tela Empresas lista as empresas cadastradas e permite gerenciá-las:
Sem paginação. A lista mostra apenas as 50 empresas mais recentes (por data de criação) e não tem controle de paginação na interface. Empresas além dessas 50 não aparecem nem são buscáveis nesta tela hoje.
- Editar dados cadastrais: Nome Fantasia, Razão Social e CNPJ/CPF. O e-mail financeiro e o WhatsApp de notificação só são definidos na criação da empresa; depois disso, ficam inacessíveis nesta tela (limitação conhecida).
- Ajustar créditos: adicionar ou subtrair saldo.
- Alterar o nível do plano (Gratuito, Básico, Profissional ou Enterprise). Esse nível é genérico e não usa o catálogo real de Planos: não tem relação com os planos específicos cadastrados lá (nome, preço, créditos). Um plano específico do catálogo só é vinculado no momento da criação da empresa, dentro do assistente de 3 passos. Depois disso, não há como reatribuir um plano específico do catálogo a uma empresa já existente; só é possível mudar o nível genérico.
- Criar uma empresa (inclusive já com o usuário administrador) e remover.
Planos
A tela Planos gerencia o catálogo de planos da plataforma: os que aparecem para as empresas contratarem em Planos & Créditos.
Para cada plano: nome, descrição, preço/período, créditos por mês, recursos e Ativo/Inativo.
Depuração do Sistema
O painel técnico de saúde e operação (atalho em Configurações → Depuração do sistema). Serve para monitorar e destravar o processamento.
- Defeitos e alertas ativos: seção destacada no topo do painel, com problemas em andamento (por exemplo Redis fora do ar, agendador parado, um job falhando ou memória perto do limite).
- Bloqueios e avisos ativos: dois tipos distintos. Bloqueio de empresa (indicado em vermelho) é uma pausa real do processamento daquela empresa. Aviso por usuário (indicado em âmbar) não pausa nada: é apenas um aviso para revisão, como uma conexão do Google com permissão insuficiente.
- Saúde do sistema: status de banco, servidor e integrações.
- Fila de processamento: jobs pendentes, processando, com falha e em retentativa.
- Cron / agendamentos: os jobs automáticos do sistema, com status, intervalo e última execução.
- Coleta (polling): espaços monitorados e taxas de coleta por janela de tempo.
- Histórico de erros: inclui aba de Arquivadas e busca no histórico.
- Recuperação: reprocessar análises com falha, destravar as presas e retomar o processamento quando estiver pausado.
Atraso de até 15 segundos ao atualizar. As seções "Diagnóstico geral" e "Contas conectadas" usam um cache de 15 segundos. Depois de usar uma ação de recuperação (por exemplo o botão Continuar para destravar um bloqueio), o painel pode continuar mostrando o estado antigo por até 15 segundos antes de refletir a correção. Isso é esperado, não é um defeito.
Pausa por empresa. Quando uma empresa fica sem créditos, a EvoluAI pausa só a coleta daquela empresa (não a plataforma inteira) e avisa os administradores. Resolvido o saldo, o processamento é retomado por aqui.
App OAuth do Google Meet — cadastrar o redirect URI
Antes de tudo, selecione a empresa "EvoluAI" no seletor de empresa no topo da tela. Só assim o botão de credenciais mostra o rótulo "Credenciais (app global)". Se outra empresa estiver selecionada no momento de salvar, o mesmo botão salva um app OAuth próprio daquele tenant, não o app global: é um erro fácil de cometer sem perceber.
O app OAuth do Google Meet é único, de plataforma, cadastrado só pelo Super Admin em
Configurações → Integrações → Google Meet → "Credenciais (app global)". Além do
client_id/client_secret, o Google exige que a URL de callback (redirect URI) do
EvoluAI esteja registrada; sem isso a conexão dos usuários falha com redirect_uri_mismatch.
A URL de callback exata aparece no próprio diálogo de credenciais, com um botão Copiar. Use essa URL: ela muda por ambiente (produção, dev, local).
Como registrar no Google Cloud Console:
- Abra o Google Cloud Console → Credenciais e selecione o projeto do app.
- Em OAuth 2.0 Client IDs, clique no client OAuth usado pelo EvoluAI.
- Em Authorized redirect URIs, clique + Add URI e cole a URL copiada do diálogo.
- Salve. As mudanças propagam em ~1 min (às vezes 5–10 min).
A URL precisa bater byte a byte: mesmo protocolo (https, exceto localhost),
host, porta, caminho e sem barra final. Um / a mais ou http↔https
já dispara o redirect_uri_mismatch.
Registrada a URL, os usuários conectam a própria conta no perfil (Preferências → Conectar Google), sem mexer no Console.
Seletor de empresa
Em telas administrativas (como Integrações), o Super Admin vê um seletor de empresa, usado para escolher em nome de qual empresa está operando. Os demais níveis não veem esse seletor, pois agem sempre dentro da própria empresa.
Voltar ao início do manual.
Admin da Empresa
Tudo do Supervisor + integrações, objetivos, configurações da empresa e plano. Telas e direitos do Admin da Empresa.
Coleta — Google Meet
Como a EvoluAI coleta reuniões do Google Meet detalhe por detalhe — app OAuth único de plataforma, conexão por usuário, data de corte, polling, transcrição com locutor, contatos e atribuição.