Documentação HorusBI
Buscar K

Aparência

Disparo Condicional ​

O alerta de tipo condicional monitora os dados continuamente e só dispara quando uma regra é atendida. Diferente do agendado, o disparo aqui depende do que está nos dados, não do relógio.

TIP

Se a consulta da regra retorna 0 registros, silêncio total. Se retorna 1 ou mais, o alerta dispara. Esse padrão "exception-only" é o que diferencia um alerta condicional de um relatório agendado.

Como Funciona ​

O Lumo monta uma consulta com aplicação + filtros + agrupamentos definidos no alerta, executa periodicamente, e dispara se houver linhas no resultado.

Componentes ​

Aplicação Alvo ​

Toda condição se ancora em uma aplicação. É sobre os dados dessa aplicação que a regra será avaliada.

Filtros ​

A regra propriamente dita. Usa o mesmo editor de filtros que você já conhece de relatórios, dashboards e bookmarks.

Exemplos comuns:

CenárioRegra
Margem negativa"Margem é menor que zero"
SLA estourado"Tickets sem resolução há mais de 48 horas"
Estoque crítico"Quantidade em estoque abaixo do mínimo cadastrado"
Transação suspeita"Valor acima de R$ 50.000 e status pendente"
Venda cancelada"Status é 'cancelado' e data de cancelamento é de hoje"

Você monta esses filtros visualmente, sem precisar escrever código.

NOTE

Filtros de data podem usar períodos relativos (Ontem, Últimos 7 dias, Mês Atual, etc.) selecionados num dropdown. Útil para regras como "vendas de ontem com margem negativa", que vão se ajustando automaticamente a cada disparo.

Agrupamento (uma entrega por grupo) ​

Opcional. Quando você define uma ou mais colunas de agrupamento, o alerta agrupa o resultado por essas colunas e dispara uma vez por grupo. Ou seja, em vez de "1 alerta com 50 linhas suspeitas", você recebe "50 alertas, um por filial afetada".

Regra: vendas com margem negativa
Agrupar por: filial

Resultado:
- 1 alerta para "Filial Centro" (3 vendas suspeitas)
- 1 alerta para "Filial Sul"    (12 vendas suspeitas)
- ...

Útil quando o destinatário muda por grupo (cada gerente recebe só os da sua filial) ou quando o conteúdo de IA precisa analisar grupos isoladamente.

Frequência de Verificação ​

Define com que cadência o Lumo roda a consulta da regra.

ModoQuando rodaUso recomendado
A cada horaToda hora cheiaAnomalias em quase tempo real
DiariamenteUma vez por dia (madrugada)Regras de fechamento diário
A cada atualização de tabelaToda vez que a tabela alvo é atualizada via ETLCadência alinhada com o ciclo de ingestão

WARNING

Verificação "a cada hora" em aplicações com muitos alertas pode pressionar o banco de dados. Se a regra não precisa de quase tempo real, prefira "diariamente" ou alinhar com atualização de tabela.

Testar a Condição ​

Toda regra tem um botão "Testar Condicional" no editor. Ele executa a consulta agora com os filtros atuais e mostra:

  • ✅ Condição atendida: número de registros encontrados + amostra da tabela
  • ⛔ Condição não atendida: nenhum registro retornado

Use o teste para validar a regra antes de ativar o alerta. Ajuste filtros ou o período até obter o comportamento esperado.

Cenários Comuns ​

Anomalia de Margem ​

Aplicação: Vendas
Regra:
  data = Ontem
  margem é menor que zero
Agrupar por: filial
Verificação: Diariamente

Conteúdo:
  1. Texto: "🚨 {{count}} vendas com margem negativa em {{filial}}"
  2. Relatório PDF: detalhamento das vendas
  3. IA: análise das causas

Canais: WhatsApp (gerente da filial)

Cada gerente recebe só os alertas da sua filial porque o agrupamento segmenta a entrega.

SLA Vencido ​

Aplicação: Tickets de Suporte
Regra:
  status diferente de "resolvido"
  idade em horas é maior que 48
Verificação: A cada hora

Conteúdo:
  1. Texto: "{{count}} tickets fora do SLA"
  2. Relatório XLSX: lista completa

Canais: Email (líderes de suporte)

Roda a cada hora. Se a fila esvazia (zero registros), o alerta cala até voltar a estourar.

Meta Não Atingida (Fim do Mês) ​

Aplicação: Metas Comerciais
Regra:
  mês = Mês Atual
  data = Último dia do mês
  atingimento é menor que 100%
Agrupar por: vendedor
Verificação: Diariamente

Conteúdo:
  1. Texto + IA: análise individual por vendedor

Canais: WhatsApp (vendedor + gerente)

Agendado + Condicional Juntos? ​

Não no mesmo alerta. Um alerta é ou agendado ou condicional, escolhido no momento da criação. Se você precisa de algo híbrido (ex.: "todo dia às 08h, se houver anomalias..."), use condicional com verificação "diariamente". O sistema roda diariamente e o filtro decide se dispara.

Próximos Passos ​