Preferências de notificação

As preferências de notificação são o interruptor por tipo × canal das mensagens que o sistema envia ao devedor. Elas respondem a perguntas como "quero lembretes por e-mail, mas não por SMS" sem tocar em nenhuma régua.

A matriz tipo × canal

Seis tipos de mensagem, três canais controláveis:

Tipo	O que é
Lembrete pré-vencimento (reminder)	Aviso amigável antes de vencer
Cobrança pós-vencimento (overdue)	Cobrança de dívida vencida
Proposta de negociação (negotiation)	Oferta de acordo/desconto
Aviso de negativação (negativation_warning)	Comunicado prévio de negativação
Aviso de protesto (protest_warning)	Comunicado prévio de protesto
Confirmação de pagamento (payment_confirmation)	Recibo de pagamento identificado

Cada tipo pode ser ligado/desligado por canal: e-mail, SMS e WhatsApp. Ligação de voz e registros manuais não passam por esse filtro.

Opt-out: o padrão é tudo ligado

O modelo é de opt-out: sem configuração, todos os tipos saem por todos os canais que a régua mandar. Você só registra preferência para desligar algo (ou religar depois).

Desligado não é descartado em silêncio

Quando uma etapa da régua tenta enviar um tipo desativado, o sistema não descarta a mensagem silenciosamente: ele a suprime com motivo registrado ("Tipo de notificação 'X' desativado para o canal Y nas preferências da conta"). O motivo aparece na tela de Notificações e na telemetria da etapa: você sempre consegue explicar por que algo não foi enviado. É a mesma filosofia do compliance de contato: todo não-envio tem um porquê auditável.

Como a preferência se combina com o resto

A preferência da conta é uma das camadas avaliadas antes de cada envio, junto com:

• Supressões do devedor (opt-out individual, "não sou eu", disputa...): sempre vencem;
• Janela legal de contato por estado;
• Limites de contato por pessoa.

Ou seja: preferência ligada não força envio (as outras camadas ainda valem), e preferência desligada bloqueia o tipo×canal para a conta inteira.

Gerenciando via API

• GET /api/v1/notification-preferences (permissão settings.show): devolve os seis tipos com o estado efetivo por canal.
• PUT /api/v1/notification-preferences (permissão settings.update): grava a matriz; cada alteração vai para a auditoria como notification_preferences.updated.

Não confunda

• Preferências de notificação (esta página): o que o devedor recebe, por tipo e canal, no âmbito da conta.
• Canais de envio (Configurações → Notificações): os provedores técnicos de e-mail/SMS/WhatsApp que efetivamente entregam.
• Notificações do operador (o sino no topo): avisos internos para a equipe, descritos em Tarefas e equipe.