Skip to content

Alertas Inteligentes

O módulo de Alertas permite que o Lumo monitore seus dados 24/7 e notifique os usuários proativamente, seja por um agendamento fixo ou quando uma regra de negócio for atendida.

Um alerta é montado em três camadas:

┌────────────┐    ┌────────────┐    ┌────────────┐
│  DISPARO   │ →  │  CONTEÚDO  │ →  │   CANAIS   │
│ (quando?)  │    │  (o quê?)  │    │ (por onde?)│
└────────────┘    └────────────┘    └────────────┘
CamadaResponde aOpções
DisparoQuando o alerta roda?Agendamento, Condicional
ConteúdoO que vai na mensagem?Texto, Gráfico, Relatório, IA
CanaisPor onde sai?Email, WhatsApp, Telegram, Webhook

TIP

Um alerta pode combinar vários blocos de conteúdo (ex.: texto introdutório + análise da IA + relatório PDF anexo) e enviar pra múltiplos canais ao mesmo tempo.


Tipos de Disparo

Por Agendamento

O alerta dispara em horários fixos, independente do que está nos dados.

  • Diário: ex., "todo dia útil às 08:00"
  • Semanal: ex., "segundas às 09:00"
  • Mensal: ex., "dia 05 de cada mês"

Uso típico: digest diário com KPIs do dia anterior, fechamento mensal, briefing semanal de equipe.

Detalhes em Agendamento →

Condicional

O alerta monitora os dados continuamente e só dispara se uma regra for atendida.

  • Verificação: a cada atualização de tabela, a cada hora, ou diariamente
  • Lógica: você define filtros sobre uma aplicação. O sistema testa periodicamente se "existem dados que atendem àqueles filtros"
  • Silêncio é normal: se a consulta retorna 0 registros, nada é enviado

Uso típico: anomalias (margem negativa, estoque abaixo do mínimo), SLA estourado, transações suspeitas.

Detalhes em Condicional →


Tipos de Conteúdo

Cada alerta pode ter um ou mais blocos de conteúdo que compõem a mensagem entregue.

TipoQuando usar
TextoMensagem fixa com variáveis dinâmicas (ex.: "Vendas de hoje: ")
GráficoSnapshot visual de um widget ou dashboard inteiro
RelatórioTabela detalhada exportada em PDF ou Excel
IAAnálise gerada por IA com base em relatórios de exemplo e briefing

NOTE

A ordem dos blocos no editor é a ordem em que aparecem na mensagem entregue.


Canais de Entrega

Os mesmos blocos de conteúdo podem ser enviados simultaneamente para:

  • 📧 Email: anexo de PDF/XLSX, imagens inline
  • 💬 WhatsApp: texto + imagens, PDF/XLSX como documento
  • 📲 Telegram: texto + imagens, PDF/XLSX como documento
  • 🔌 Webhook: payload JSON, ideal para integrações

Configuração de canais →

TIP

Integrando com sistemas externos via webhook (n8n, Make, Zapier, WhatsApp via Meta, Slack)? Veja a seção dedicada Webhook com contrato completo do payload, exemplos por ferramenta e código receptor pronto em Node.js e Python.


Fluxo Completo

Cada entrega gera um registro auditável com status, erros e os assets gerados. Falha em um canal não impede os demais, mas se qualquer canal esperado falhar, a entrega inteira é marcada com status de erro (filosofia "fail loud", sem falha silenciosa).


Permissões

O criador do alerta tem controle total (editar, excluir, forçar envio). Administradores podem ajudar a editar, mas a autoria não muda. Veja Permissões e Compartilhamento para o detalhamento por papel.


Próximos Passos

  1. Configure o disparo (agendado) ou a condição (regra)
  2. Adicione conteúdos: texto, gráfico, relatório ou IA
  3. Escolha os canais de entrega: Email/WhatsApp/Telegram/Webhook
  4. Teste com o botão "Pré-visualizar" antes de ativar