Notificações

O sistema de Notificações do Sincroniza envia alertas por E-mail e Microsoft Teams quando eventos importantes ocorrem na plataforma.

O que são Notificações?

Notificações são alertas automáticos que mantêm administradores informados sobre eventos críticos do sistema, como:

• Ações que requerem aprovação
• Falhas de conectividade com provedores de identidade
• Recuperação de serviços após falha
• Ações que falharam após todas as tentativas
• Novas contas provisionadas

As notificações funcionam como um complemento ao painel do Sincroniza, garantindo que eventos críticos sejam comunicados proativamente, mesmo quando o administrador não está acessando a plataforma.

Canais de Notificação

O Sincroniza suporta dois canais de notificação que podem ser usados de forma independente ou simultânea:

Característica	E-mail	Teams
Serviço	Azure Communication Services	Incoming Webhook
Formato	HTML formatado	Cartão adaptativo (Adaptive Card)
Destinatários	Lista de e-mails de administradores	Canal do Teams (com @mentions opcionais)
Ideal para	Notificações formais e auditoria	Alertas rápidos e colaboração em equipe

Eventos que Geram Notificações

Evento	Descrição	Habilitado por Padrão
Aprovação necessária	Um lote de aprovação foi criado e aguarda revisão	✅ Sim
Falha de infraestrutura	Falha de conectividade com Active Directory ou Entra ID	✅ Sim
Recuperação de infraestrutura	Serviço restaurado após período de falha	✅ Sim
Ação falhou	Uma ação falhou após esgotar todas as tentativas de retentativa	✅ Sim
Conta provisionada	Uma nova conta foi criada para um funcionário	✅ Sim

Cada evento pode ser habilitado ou desabilitado individualmente, permitindo que a organização receba apenas as notificações relevantes.

Controle de Frequência (Throttling)

Para evitar sobrecarga de notificações — especialmente em cenários de falhas em cascata — o sistema implementa um controle de frequência:

• Intervalo mínimo: Configurável de 1 a 1440 minutos (1 dia)
• Padrão: 60 minutos
• Escopo: Por tipo de evento, por canal

Exemplo: Se o intervalo é de 60 minutos e ocorrem 50 falhas de infraestrutura em 30 minutos, apenas a primeira notificação é enviada. A próxima só será enviada após completar 60 minutos desde a última.

Ciclo de Vida da Notificação

Cada notificação passa por um ciclo de vida com os seguintes estados:

┌────────────┐     ┌───────────┐     ┌──────────┐
│ Enfileirada│────▶│ Enviando  │────▶│ Enviada  │
└────────────┘     └───────────┘     └──────────┘
                        │
                        │ (falha)
                        ▼
                ┌──────────────────┐     ┌──────────┐
                │    Aguardando    │────▶│ Enviada  │
                │   Retentativa    │     └──────────┘
                └──────────────────┘
                        │
                        │ (todas as tentativas esgotadas)
                        ▼
                   ┌─────────┐
                   │  Falha  │
                   └─────────┘

Estado	Descrição
Enfileirada	Notificação criada e aguardando processamento
Enviando	Notificação está sendo enviada ao canal
Enviada	Notificação entregue com sucesso
Aguardando Retentativa	Falha no envio, aguardando próxima tentativa
Falha	Falha permanente após todas as tentativas

Retry Automático

Quando o envio de uma notificação falha, o sistema realiza retentativas automáticas:

• Máximo de tentativas: 5
• Backoff exponencial: O intervalo entre tentativas aumenta progressivamente
• Jitter: 20% de variação aleatória para evitar picos de retentativa

Tentativa	Intervalo Aproximado
1ª	2 minutos
2ª	8 minutos
3ª	18 minutos
4ª	32 minutos
5ª	60 minutos

Após a 5ª tentativa, a notificação é marcada como Falha permanente e registrada no histórico para análise.

Boas Práticas

Recomendações

1. Habilite ambos os canais: Use e-mail para auditoria formal e Teams para alertas rápidos em tempo real.

2. Configure o throttle adequadamente: Valores muito baixos podem gerar excesso de notificações; muito altos podem atrasar alertas críticos. O padrão de 60 minutos é adequado para a maioria das organizações.

3. Mantenha a lista de destinatários atualizada: Remova pessoas que não são mais responsáveis pela administração do sistema.

4. Monitore o histórico de envio: Verifique periodicamente se as notificações estão sendo entregues com sucesso.

5. Use @mentions no Teams com moderação: Mencionar muitas pessoas pode dessensibilizar a equipe para alertas reais.

Próximos Passos

• Configurar Notificações - Guia passo a passo para administradores
• Monitoramento - Acompanhe a saúde do sistema
• Aprovações - Entenda o fluxo de aprovação que gera notificações