Perguntas Frequentes - Administrador

Respostas rápidas para as dúvidas mais comuns sobre a administração do sistema Endotech.

Configuração#

Como adiciono uma nova conta de e-mail?

  1. Acesse Avatar, Administração, E-mail (/admin/email)
  2. Clique em "Nova conta"
  3. Preencha os dados da conta (endereço, IMAP, SMTP)
  4. Gere uma senha de aplicativo no provedor (Gmail, Outlook, etc.)
  5. Teste a conexão IMAP e SMTP
  6. Salve e ative a conta
Sempre use senha de aplicativo, nunca a senha normal da conta. Para Gmail, ative verificação em 2 etapas antes de gerar a senha de app.

Detalhes completos: Integração de E-mail

Como troco o modelo de IA?

  1. Acesse Avatar, Administração, Agentes IA (/admin/agents)
  2. Clique no agente que deseja alterar
  3. No campo "Modelo de IA", selecione o novo modelo
  4. Ajuste temperatura e max_tokens se necessário
  5. Teste a classificação com e-mails de exemplo
  6. Salve as alterações

Modelos disponíveis (OpenAI)

  • gpt-4o: Mais preciso, mais caro. Ideal para extração de dados complexos.
  • gpt-4o-mini: Rápido, barato e bom para classificação. Recomendado para a maioria.
  • gpt-3.5-turbo: Mais barato, menos preciso. Para volumes altos e classificação simples.

O que acontece se a conexão IMAP falhar?

Se a conexão IMAP falhar durante o polling:

  • O sistema tenta reconectar automaticamente na próxima rodada de polling (2 min)
  • Se falhar por 5 tentativas consecutivas, o status da conta muda para "Erro"
  • Você recebe notificação no painel administrativo
  • E-mails não processados ficam na caixa de entrada aguardando reconexão
  • Nenhum e-mail é perdido - ficam no servidor IMAP até serem processados

Banco de Dados#

Como regenero os tipos após uma migration?

  1. Execute a migration: cd endotech && npx supabase db push
  2. Gere os tipos: npx supabase gen types typescript --linked > supabase/remote_types.ts
  3. Copie o conteúdo para o app: copie supabase/remote_types.ts para endotech/src/lib/supabase/types.ts
  4. Verifique: cd endotech && npx tsc --noEmit
Ambos os arquivos precisam ser atualizados. Se esquecer de copiar para endotech/src/lib/supabase/types.ts, o app usa tipos desatualizados e pode causar erros de TypeScript.

Posso deletar um ticket?

Não recomendado. O Endotech usa exclusão lógica (soft delete): mude o status para "Arquivado" em vez de deletar.

Nunca: DELETE FROM tickets WHERE id = ...

Quebra auditoria, relatórios e referências em mensagens

Correto: UPDATE tickets SET status = &após;archived&após; WHERE id = ...

Ticket desaparece das listas ativas mas mantém histórico

Como faço backup do banco de dados?

Opção 1: Supabase Dashboard (recomendado)

  1. Acesse Supabase Dashboard, Database, Backups
  2. Backups diários automáticos com retenção de 7 dias
  3. Para restaurar: selecione backup, Restore

Opção 2: pg_dump (manual)

pg_dump -h db.xxx.supabase.co -U postgres -d postgres > backup.sql
Faça backup manual antes de migrations grandes. Teste a restauração mensalmente para garantir integridade.

Segurança e Usuários#

Como vejo o log de auditoria?

  1. Acesse Avatar, Administração, Auditoria (/admin/audit)
  2. Filtre por data, usuário, tipo de ação ou recurso
  3. Cada entrada mostra: data/hora, usuário, ação, recurso, estado antes/depois
ticket.endotechsistemas.com.br
Data: últimos 7 dias
Usuário: todos
Ação: todas
Recurso: todos
Filtros disponíveis no log de auditoria

Detalhes completos: Segurança e Auditoria

Como reseto a senha de um usuário?

  1. Acesse Avatar, Administração, Usuários
  2. Clique no usuário que precisa de reset
  3. Clique em "Resetar senha"
  4. O sistema gera nova senha temporária
  5. Envie a senha ao usuário por canal seguro (não por e-mail)
  6. O usuário será forçado a trocar a senha no próximo login
Nunca envie senhas temporárias por e-mail. Use canal seguro (mensagem direta, ligação) para transmitir credenciais.

Operações#

Como sei se a IA está classificando corretamente?

Monitore estes indicadores:

ticket.endotechsistemas.com.br

< 10%

Taxa de exceções (meta)

< 5%

Taxa de reclassificação

> 85%

Confiança média

< 5s

Tempo de processamento

KPIs de saude da classificação por IA

Se as métricas estão fora do esperado, ajuste os prompts dos agentes. Veja dicas em Agentes de IA.

Quantos e-mails o sistema consegue processar?

O sistema faz polling IMAP a cada 2 minutos. Para cada rodada:

  • Cada e-mail é processado individualmente pela IA (2-5 segundos)
  • Lote típico: 10-20 e-mails por rodada
  • Capacidade estimada: ~300-600 e-mails/hora por conta
  • Para volumes maiores, considere múltiplas contas ou webhook

Como configuro uma nova fila de atendimento?

  1. Acesse Avatar, Administração, Filas (/admin/queues)
  2. Clique em "Nova fila"
  3. Preencha nome, descrição, cor e SLA
  4. Crie um agente de IA para a nova fila
  5. Atribua operadores a nova fila nas permissões de cada usuário
  6. Teste com e-mails de exemplo

Detalhes completos: Configuração de Filas

Solução de Problemas#

E-mails não estão sendo processados

  • 1. Verifique se a conta de e-mail está ativa no painel
  • 2. Teste a conexão IMAP (botão "Testar")
  • 3. Verifique se a senha de app não expirou
  • 4. Confirme que a pasta monitorada é INBOX
  • 5. Verifique se os e-mails estão como "Não lidos"
  • 6. Consulte logs do webhook/n8n para erros de processamento

IA está classificando muitos tickets como Exceções

  • 1. Verifique o threshold de confiança (padrão 80%)
  • 2. Analise os e-mails em Exceções - padrões em comum?
  • 3. Adicione sinônimos e variações ao prompt do agente
  • 4. Adicione contra-exemplos para evitar confusão entre filas
  • 5. Se necessário, baixe temporariamente o threshold para 75%
  • 6. Após ajustes, teste com 10+ e-mails variados

TypeScript está dando erros de tipo após migration

  • 1. Regenerou os tipos em AMBOS os arquivos?
  • 2. Executou npx tsc --noEmit dentro de endotech/?
  • 3. Componentes que referenciam colunas removidas precisam ser atualizados
  • 4. Colunas novas podem precisar de tratamento para valores NULL
  • 5. Se adicionou tabela nova, crie tipo e importe nos componentes relevantes

Um operador não consegue ver tickets

  • 1. Verifique se o usuário está ativo
  • 2. Verifique se o usuário tem permissão para a fila
  • 3. Confirme que a fila tem tickets
  • 4. Peça ao usuário para fazer logout e login (JWT pode estar desatualizado)
  • 5. Verifique se a RLS está habilitada na tabela tickets

Ainda tem dúvidas?