Notificações

Resumo

O sistema de Notificações entrega avisos ao usuário em múltiplos canais (email, SMS, WhatsApp, push, in-app). O usuário visualiza em /dashboard/notifications, ajusta preferências em /dashboard/profile?tab=notifications (notifications.php + preferences-center.php). O admin gerencia templates, broadcast, canais e logs em /admin/settings/notifications/.

Para quem é (personas)

• Usuário final que quer controlar quais notificações recebe.
• Admin de comunicação que envia broadcasts e configura templates.
• Super admin que audita entrega e custos de canais (SMS, WhatsApp).

O que você pode fazer

Central de Notificações (/dashboard/notifications)

• Listar notificações via GET /api/notifications e /api/notifications/all.
• Contador (badge) via GET /api/notifications/count.
• Marcar como lida: POST /api/notifications/read.
• Reagir a uma notificação: POST /api/notifications/react.

Preferências (tab notifications no perfil)

Estados default (notificationPrefs):

• email_enabled — 1 (ligado).
• sms_enabled — 0 (desligado).
• whatsapp_enabled — 0 (desligado).
• push_enabled — 1 (ligado).
• internal_enabled — 1 (notificação in-app sempre ligada por padrão).

Controle por categoria (segurança, billing, marketing, suporte, etc.) quando configurado pelo admin.

Administração

Views em app/Admin/Views/settings/notifications/:

• central.php — visão consolidada.
• templates.php — templates de email/SMS/WhatsApp/push.
• channels.php — configuração dos provedores (SMTP, Twilio, WhatsApp

Business, FCM, etc.).

• broadcast.php — envio em massa.
• logs.php — auditoria de entrega (sucesso, bounce, falha).
• settings.php — políticas gerais.

Como acessar

Central

1. Clique no ícone de sino no header.
2. Ou acesse /dashboard/notifications.

Preferências

1. Acesse /dashboard/profile?tab=notifications.
2. Ative/desative canais e categorias.
3. Salve (AJAX).

Tutoriais

Desligar notificações de marketing por email

Objetivo: Reduzir volume de emails promocionais.

Passos:

1. Acesse /dashboard/profile?tab=notifications.
2. Em Categorias, desmarque Marketing no canal Email.
3. Salve.

Habilitar push no navegador

Objetivo: Receber alertas em tempo real.

Passos:

1. Acesse /dashboard/profile?tab=notifications.
2. Marque Push.
3. Aprove a permissão no navegador (Service Worker registra o token).

Enviar broadcast (admin)

Objetivo: Comunicar todos os usuários de um tenant.

Passos:

1. Acesse /admin/settings/notifications/broadcast.
2. Selecione canal, segmento e template.
3. Agende ou envie imediatamente.

Integrações

• Email: SMTP nativo ou providers (SendGrid, Mailgun, SES).
• SMS: Twilio e equivalentes.
• WhatsApp: API oficial WhatsApp Business.
• Push: FCM (Android/web) e APNs (iOS).
• In-app: tabela core_notifications, entregue via WebSocket/polling.
• Event Bus: eventos de domínio disparam templates automaticamente.

Perguntas frequentes

Posso bloquear todas as notificações? Notificações críticas (segurança, billing) não podem ser desligadas. Demais categorias sim.

Por que não recebo emails? Verifique spam, confirme se o email foi verificado, e veja status em /admin/settings/notifications/logs (se for admin).

O P8W envia SMS mesmo no plano básico? Depende do plano do tenant. SMS tem custo por mensagem.

Como funcionam as reações em notificações? Algumas notificações permitem resposta rápida (ex: aprovar, rejeitar, marcar lida) via POST /api/notifications/react.

Push funciona offline? Sim. FCM/APNs entregam quando o dispositivo volta online.

Posso agendar envio? Sim, no broadcast do admin. Usa o sistema de filas interno.

Quanto tempo as notificações ficam salvas? Retenção configurável. Padrão: 90 dias para in-app.

Limitações e políticas

• CAN-SPAM / LGPD / GDPR respeitados — opt-out sempre disponível.
• Rate limiting em canais pagos (SMS/WhatsApp) para evitar abuso.
• Double opt-in pode ser exigido para canais sensíveis.
• Logs retidos para auditoria e compliance.

Relacionados

• Meu Perfil
• Segurança e Privacidade
• LGPD e Privacidade de Dados