Configurações - Central de Notificações

O que é

A Central de Notificações é a página que reúne todas as notificações internas geradas automaticamente pelo Viagilize para a equipe da agência: avisos de pagamento, reservas pendentes, baixa ocupação de excursões, novos clientes, documentos vencendo, mensagens do sistema e alertas urgentes. Cada item pode ter um botão direto para o registro de origem (reserva, pagamento, excursão), o que torna a Central um ponto de partida para o trabalho diário.

O usuário normalmente chega aqui clicando no sino no cabeçalho do admin (que mostra um badge vermelho com o número de notificações não lidas) e depois em Ver todas, ou então pelo menu lateral em Configurações > Notificações. As notificações exibidas são apenas as válidas (não expiradas) e direcionadas ao usuário logado ou globais para todos os usuários da sua empresa.

Como usar

1. Acesse pelo sino no cabeçalho do admin e clique em Ver todas no rodapé do dropdown, ou pelo menu lateral em Configurações > Notificações.
2. Veja os 4 cards no topo com as estatísticas:
   • Total (azul) - todas as notificações válidas para você.
   • Não Lidas (âmbar) - quantas ainda esperam atenção.
   • Urgentes (vermelho) - não lidas com prioridade urgente.
   • Hoje (verde) - criadas no dia atual.
3. Use a barra de filtros para encontrar uma notificação específica:
   • Buscar notificações... - pesquisa pelo título ou pelo texto da mensagem.
   • Tipo - Pagamentos, Reservas, Excursões, Clientes, Documentos, Sistema ou Alertas.
   • Status - Não Lidas ou Lidas.
   • Prioridade - Urgente, Alta, Normal ou Baixa.
4. Em cada linha da lista o título aparece em negrito quando ainda não foi lida e ganha um ponto azul à esquerda. O badge colorido ao lado mostra o tipo, e há um badge extra "Urgente" (vermelho) ou "Alta" (laranja) para prioridades elevadas.
5. Para abrir o registro de origem, clique no botão azul à direita da notificação (o texto varia conforme o item: Ver pagamento, Ver reserva, Ver, etc.) - ao clicar, a notificação é marcada como lida automaticamente.
6. Para gerenciar sem sair da Central, use o menu de três pontos no fim da linha:
   • Marcar como lida - só aparece em notificações não lidas.
   • Excluir - abre confirmação e remove a notificação da sua visualização.
7. Quando houver notificações não lidas, o botão azul Marcar Todas como Lidas aparece no fim da barra de filtros. Confirma o lote inteiro e recarrega a página.

Casos especiais

Sino no cabeçalho (dropdown rápido)

O sino no canto superior direito mostra até 8 notificações recentes sem precisar abrir a Central inteira. No topo do dropdown ficam os atalhos Marcar todas como lidas e Limpar todas (ícone de lixeira). Limpar todas não apaga registros: define expira_em = agora em todas, ocultando da sua visualização sem perder o histórico no banco.

Dispensar versus excluir

A Central usa dois mecanismos diferentes:

• Excluir (lixeira no menu de três pontos da Central) - deleta o registro da tabela.
• Dispensar / Limpar todas (disponível pelo sino) - apenas marca como expirada. Útil quando você quer "limpar" sem perder o histórico.

Notificações globais e por usuário

Cada notificação pode ser direcionada a um usuário específico ou ser global (sem usuário). Você vê as duas categorias: as globais aparecem para todo mundo na sua empresa, e as direcionadas só aparecem para o usuário-alvo. A contagem do badge no sino e os cards de estatística respeitam essa regra.

Tipos disponíveis

O filtro Tipo lista as categorias definidas no sistema: Pagamentos, Reservas, Excursões, Clientes, Documentos, Sistema e Alertas. Cada tipo tem cor e ícone próprios na lista para facilitar o reconhecimento visual.

Erros comuns e como resolver

• "Nenhuma notificação" (mensagem em destaque no centro da página) - Causa: nenhuma notificação válida bateu com os filtros aplicados ou você está em dia. Solução: limpe os filtros usando o X ao lado dos chips ativos na barra de filtros, ou simplesmente aguarde novos eventos do sistema.
• Sino sem badge mas a Central mostra itens - Causa: o badge conta apenas não lidas; itens já lidos continuam na Central até serem excluídos. Solução: filtre por Status: Não Lidas para ver só as pendentes.
• "Erro ao marcar notificações como lidas" (toast vermelho) - Causa: falha na chamada AJAX (sessão expirada, perda de rede, CSRF inválido). Solução: recarregue a página com F5 e tente novamente; se o problema persistir, faça logout e login.
• Notificação some sozinha da lista - Causa: ela tinha expira_em definido e o prazo venceu, ou foi dispensada por outro usuário com acesso ao mesmo registro. Solução: comportamento esperado; verifique se realmente precisa daquela informação no registro de origem (reserva, pagamento, etc.).

Onde encontrar

• URL: /admin/notificacoes
• Caminho no menu: Configurações > Notificações (ou clique no sino no cabeçalho > Ver todas)
• Permissão necessária: nenhuma específica (qualquer usuário autenticado do admin da sua empresa)
• Módulo necessário: nenhum

Veja também

• Notificações Automáticas
• Alertas e Notificações do Dashboard