Como configurar alertas proativos (Slack + Email)

Cron diário (08:00 UTC) checa taxa de erro das últimas 24h. Se exceder o threshold configurado, dispara alerta por Slack e/ou email.

Onde configurar

No detalhe da empresa (/admin/empresa/[id]), seção Alertas proativos.

4 campos

Slack Incoming Webhook URL (opcional) — vazio = sem alerta no Slack
Email pra alerta (opcional) — vazio = sem alerta por email
Threshold = % de erro mínima pra alertar (default 5%)
Volume mínimo = mensagens/24h pra considerar significativo (default 10)

Você pode preencher só Slack, só email, ou os dois.

Setup do Slack

Vai em api.slack.com/messaging/webhooks
Cria nova app ou usa existente
Habilita Incoming Webhooks → Add New Webhook to Workspace
Escolhe canal (ex: #alerts-nexio)
Copia a URL https://hooks.slack.com/services/T0/B0/xxxx
Cola no campo do Lefia

Setup do email

Apenas digite o email no campo. O Lefia envia via Resend (sender configurado nas env vars RESEND_*). Email contém:

Taxa de erro vs threshold
Total de mensagens / total de erros nas últimas 24h
Botão direto pro /monitor/empresa/[id] da empresa

Comportamento do cron

Roda diariamente às 08:00 UTC
Se error_rate > threshold E volume > min_messages → dispara
Slack e email são disparados em paralelo (se ambos configurados)
Dedupe 24h: não alerta de novo no mesmo dia (evita spam)
Histórico das vezes que alertou fica em tenant_alerts_fired

Testar

Pra simular um alerta agora (sem esperar 24h), ajuste o threshold pra 0% temporariamente e force uma mensagem de erro. Depois volte o threshold pro valor normal.

Credencial recusada repetida (28/09/2026)

Na mesma seção Alertas fica o que fazer quando a origem de uma integração agendada recusa a credencial (HTTP 401 ou login do Oracle recusado) em várias execuções seguidas:

Falhas seguidas — de 1 a 20 (padrão 3). Só execuções agendadas contam, desde a última retomada ou troca de credencial.
Ao atingir — Pausar o agendamento e avisar (padrão) ou Não pausar, só avisar. Só avisar manda um aviso por sequência de falhas; um sucesso ou a retomada zera.

O aviso vai para o sino do administrador e para o e-mail e o Slack desta seção (sem canal, só o sino). HTTP 403, origem fora do ar e timeout nunca disparam. Cada integração pode sobrescrever na edição (Execução › Avançado). Detalhes no artigo "Execuções".

Webhook e e-mail guardados (28/09/2026)

Depois de salvos, o webhook do Slack e o e-mail aparecem mascarados (https://hooks.slack.com/…/•••• e o•••@empresa.com): o valor completo não volta para a tela nem pode ser lido pela API por quem é da empresa. Para trocar, use Substituir e cole o novo; para parar de alertar naquele canal, Remover. Salvar só o threshold ou o volume mínimo mantém o que já está guardado. A configuração fica em Configurações (admin da empresa) e no detalhe da empresa (backoffice).

Se a seção não carregar (03/10/2026)

Se a leitura do webhook e do e-mail falhar, só a seção Alertas mostra o aviso, com um Código do erro; o resto das Configurações funciona normalmente. Recarregue em alguns minutos; se continuar, abra um chamado com o código — é o mesmo registrado para a equipe Lefia.