Notificações

As Notificações permitem que administradores recebam alertas por E-mail e Microsoft Teams quando eventos importantes ocorrem no Sincroniza.

Para entender os conceitos por trás deste recurso, consulte Notificações — Conceitos.

Acessando a Configuração

1. Acesse Configurações no menu lateral
2. Clique na aba Notificações

A página de configuração possui duas abas:

• Configuração: Definição de canais e eventos
• Histórico: Visualização de notificações enviadas

Configurando o Canal de E-mail

Habilitando

1. Na seção Canal de E-mail, ative o interruptor
2. Preencha os campos obrigatórios:

Connection String do Azure Communication Services

1. No campo Connection String, insira a string de conexão do Azure Communication Services
2. Este valor é armazenado de forma criptografada no banco de dados

Como obter a Connection String

Acesse o Portal do Azure → Azure Communication Services → seu recurso → Chaves → Connection String.

Endereço do Remetente

1. No campo Endereço do Remetente, insira o e-mail verificado no ACS
2. Exemplo: noreply@suaempresa.com
3. Este endereço deve estar configurado e verificado no Azure Communication Services

Destinatários

1. Na seção Destinatários, adicione os e-mails dos administradores que devem receber notificações
2. Clique no botão de adicionar para incluir cada e-mail
3. Para remover, clique no × ao lado do e-mail

Limite de Destinatários

O sistema suporta até 50 destinatários por canal de e-mail.

Configurando o Canal do Teams

Habilitando

1. Na seção Canal do Teams, ative o interruptor
2. Preencha os campos:

URL do Webhook

1. No campo URL do Webhook, insira a URL do Incoming Webhook do Teams
2. Este valor é armazenado de forma criptografada

Como criar um Webhook no Teams

1. No Microsoft Teams, acesse o canal desejado
2. Clique em ... → Conectores (ou Workflows)
3. Procure por Incoming Webhook
4. Configure um nome (ex: "Sincroniza") e copie a URL gerada

@Mentions (Opcional)

1. Na seção Mentions, adicione os e-mails dos usuários que devem ser mencionados nas mensagens
2. Quando configurados, as notificações do Teams incluirão @mentions para esses usuários
3. Para remover, clique no × ao lado do e-mail

Configurando Eventos

Pré-requisito

A seção de eventos só aparece quando pelo menos um canal (E-mail ou Teams) está habilitado.

Para cada evento, ative ou desative o interruptor:

Evento	Descrição	Recomendação
Aprovação necessária	Notifica quando um lote de aprovação é criado	✅ Manter habilitado
Falha de infraestrutura	Notifica sobre falhas de conectividade com AD/Entra ID	✅ Manter habilitado
Recuperação de infraestrutura	Notifica quando um serviço é restaurado após falha	✅ Manter habilitado
Ação falhou	Notifica quando uma ação falha após todas as tentativas	✅ Manter habilitado
Conta provisionada	Notifica quando uma nova conta é criada	⚠️ Opcional em grandes volumes

Controle de Frequência

1. No campo Intervalo Mínimo, configure o tempo mínimo entre notificações do mesmo tipo (em minutos)
2. Valores aceitos: 1 a 1440 (1 dia)
3. Padrão: 60 minutos

Cenários de configuração:

Cenário	Valor Recomendado
Ambiente de produção estável	60 minutos (padrão)
Implementação inicial / Monitoramento intenso	15 minutos
Ambiente com muitas ações automáticas	120 minutos

Histórico de Notificações

A aba Histórico exibe todas as notificações enviadas pelo sistema:

Informações Exibidas

• Data/Hora de criação
• Canal (E-mail ou Teams)
• Assunto da notificação
• Status (Enviada, Falha, Aguardando Retentativa, etc.)
• Tentativas de envio

Filtrando o Histórico

Use os filtros disponíveis para encontrar notificações específicas:

• Por canal (E-mail, Teams)
• Por status (Enviada, Falha, Enfileirada, etc.)
• Por período

Solução de Problemas

Problema	Causa Provável	Solução
E-mails não são enviados	Connection string inválida	Verifique a connection string do Azure Communication Services
E-mails rejeitados	Endereço do remetente não verificado	Verifique o domínio no Azure Communication Services
Teams não recebe mensagens	URL do webhook inválida ou expirada	Recrie o webhook no Teams e atualize a URL
Excesso de notificações	Throttle muito baixo	Aumente o intervalo mínimo entre notificações
Notificações com status "Falha"	Serviço indisponível após 5 tentativas	Verifique a conectividade com Azure/Teams e reenvie manualmente
Seção de eventos não aparece	Nenhum canal habilitado	Habilite pelo menos um canal (E-mail ou Teams)

Próximos Passos

• Notificações — Conceitos - Entenda o ciclo de vida das notificações
• Monitoramento - Acompanhe a saúde geral do sistema
• Fluxos de Aprovação - Configure políticas que geram notificações