Notificações - Administração

Resumo

Central de notificações da plataforma: templates de e-mail/SMS/push/whatsapp, canais disponíveis, broadcast massivo, configurações globais (rate limit, remetente, assinatura), preferências por usuário e log de envios.

Para quem é (papel/role)

• super-admin - templates e canais globais.
• tenant-admin - templates e broadcast do próprio tenant.

O que você pode fazer

Central

• Painel: envios por canal, taxa de entrega, falhas.

Templates

• CRUD de templates: assunto, corpo, variáveis dinâmicas.
• Multilíngue: versão por idioma (i18n).
• Tipos: transacional, marketing, sistema.

Canais

• E-mail: SMTP/API (Sendgrid, Mailgun, SES).
• SMS: Twilio, Zenvia, outros.
• Push: web push e mobile push.
• WhatsApp: via provider oficial.
• In-app: notificações dentro do painel.

Broadcast

• Enviar em massa: segmentar por tenant/plano/tag.
• Agendamento.
• Preview e teste antes de disparar.

Preferências

• Preferências globais: canais habilitados por tipo de evento.
• Override por usuário.

Logs

• Log de envios: canal, destinatário, status, falha.
• Reenvio manual.

Settings

• Rate limit por canal/usuário.
• Remetente padrão.
• Assinatura de rodapé.

Como acessar

1. /admin.
2. Settings → Notificações ou /admin/settings/notifications.

Tutoriais

Criar template de "fatura paga"

1. /admin/settings/notifications/templates.
2. Nome: Fatura paga, tipo: e-mail transacional.
3. Assunto: Recebemos seu pagamento - {{invoice_number}}.
4. Corpo com variáveis {{user.name}}, {{amount}}, {{date}}.
5. Salve e ative.

Enviar broadcast de lançamento

1. /admin/settings/notifications/broadcast.
2. Selecione template, segmento (ex: plano Pro).
3. Agende para amanhã às 10:00.
4. Faça teste para si mesmo.
5. Confirme envio.

Configurar rate limit anti-spam

1. /admin/settings/notifications/settings.
2. Defina limite: máximo 5 e-mails/hora por usuário.
3. Salve.

Reenviar notificação falha

1. /admin/settings/notifications/logs.
2. Filtre por Falha.
3. Selecione e clique em Reenviar.

Integrações

• Eventos - emissão automática ao capturar invoice.paid, user.created, etc.
• Billing - dunning usa templates (billing-gateways.md).
• Loyalty - missões completadas disparam notificação (loyalty-fidelidade.md).
• External APIs - credenciais SMTP/SMS (external-apis-chaves-globais.md).

Perguntas frequentes

Templates suportam HTML rico? Sim, com sanitização.

Posso ter template por idioma? Sim, por i18n (27 idiomas).

Notificação falhada tenta de novo? Sim, retry com backoff exponencial.

Como evito spam? Via rate limit por usuário e categoria.

Usuário pode optar por não receber? Sim, nas preferências pessoais e via link de opt-out.

Broadcast tem preview? Sim, obrigatório enviar teste antes do disparo em massa.

Logs guardam conteúdo enviado? Apenas metadata e template usado (não o corpo final, por privacidade).

Push pede permissão ao usuário? Sim, conforme padrão do browser/SO.

Limitações, políticas e avisos

• Marketing exige opt-in explícito (LGPD).
• Rate limit aplica por canal e por usuário.
• Transacionais não respeitam opt-out de marketing.
• Templates excluídos permanecem no histórico dos envios já feitos.

Relacionados

• billing-gateways.md
• loyalty.md
• external-apis-global-keys.md
• compliance-lgpd.md