Canais
A fila atende os canais assíncronos utilizados pela plataforma, como:
- e-mail;
- Web Push Cliente;
- Web Push Painel;
- Web Push Consultor Py;
- WhatsApp automático quando integrado ao fluxo da outbox.
Evolução 0.11.0
A notification_outbox foi ampliada para dar mais visibilidade sobre processamento e falhas. A operação pode considerar:
- número de tentativas;
- retry;
- tratamento em lote;
- dead-letter para mensagens que excederam o fluxo normal de reprocessamento.
Estados e ações
Use os filtros e ações disponíveis para identificar itens pendentes, processados, cancelados ou com falha. Reprocessar deve ser uma ação consciente: antes, confirme se a causa original foi corrigida.
Dead-letter
Dead-letter separa mensagens que não devem continuar disputando processamento com a fila normal. Depois de corrigir a causa, o operador pode seguir o procedimento disponibilizado pela interface para reprocessamento ou encerramento.
Deduplicação
Eventos críticos podem usar chaves de deduplicação para evitar notificações repetidas para o mesmo fato operacional.
Worker
O cron cron/notification-worker.php deve ser executado periodicamente. Saúde dos Serviços deve ser usada para confirmar que o processamento está ocorrendo dentro do intervalo esperado.
Diagnóstico
Em caso de falha:
- confira canal e evento;
- veja tentativas e mensagem de erro;
- valide Saúde dos Serviços;
- confira configuração do provedor;
- consulte Observabilidade/Logs de Aplicação;
- corrija a causa;
- só então reprocese.