Configurações - Notificações Automáticas

O que é

Esta página concentra todas as notificações automáticas que o Viagilize dispara para a equipe da agência. São dois blocos: Notificações de Atividade, que cobrem o dia a dia do operacional (nova reserva, cancelamento, pagamento, novo cliente, cotação aceita/recusada, relatório diário, recibo ao cliente e lembrete de excursão), e Alertas do Sistema Viagilize, que tratam da relação com a própria plataforma (pagamentos da assinatura, renovação, vencimento, novidades e manutenções).

O usuário normalmente chega aqui logo após cadastrar os dados da empresa, quando quer parar de receber um aviso específico, quando deseja mandar alertas para uma caixa diferente da empresa (financeiro, vendas, marketing) ou quando precisa habilitar o envio de notificações por WhatsApp. Cada gatilho pode ser ligado independentemente por canal (E-mail e WhatsApp), e os defaults centralizados em EMAIL_DEFAULTS deixam ativos por padrão Nova Reserva, Reserva Cancelada, Pagamento Confirmado, Cotação Aceita e Cotação Recusada.

Como usar

1. Vá em Configurações > Notificações no menu lateral (acessível para quem tem a permissão configuracoes.notificacoes).
2. No bloco Notificações de Atividade, escolha primeiro para onde vão os e-mails, no card cinza à esquerda:
   • Email da empresa - usa o e-mail cadastrado em Dados da Empresa (mostrado logo abaixo da opção).
   • Emails por tipo - libera, em cada gatilho ativado, um campo extra para informar e-mails separados por vírgula (até 500 caracteres por evento).
3. No card cinza à direita, defina o destino do WhatsApp:
   • WhatsApp da empresa - usa o número cadastrado em Dados da Empresa.
   • Outro número - abre um campo de texto onde você digita um número no formato internacional (ex.: 5547999999999). Mínimo de 10 dígitos.
4. Para cada gatilho da seção Notificações de Atividade, ative os toggles desejados ao lado direito (azul = E-mail, verde = WhatsApp). Os gatilhos disponíveis são:
   • Nova Reserva - dispara quando uma reserva é registrada.
   • Reserva Cancelada - dispara quando uma reserva é cancelada.
   • Pagamento Confirmado - dispara quando um pagamento é aprovado.
   • Novo Cliente - dispara quando um cadastro novo entra na base.
   • Cotação Aceita - dispara quando o cliente aceita uma proposta de cotação.
   • Cotação Recusada - dispara quando o cliente recusa uma cotação.
   • Relatório Diário - envia um resumo diário das atividades (apenas e-mail).
   • Recibo de Pagamento ao Cliente - manda automaticamente um PDF com o recibo ao cliente quando o pagamento é confirmado (apenas e-mail).
   • Lembrete de Excursão - envia lembrete 24h antes da viagem (apenas WhatsApp).
5. Se você escolheu Emails por tipo, preencha os campos de e-mails que aparecem logo abaixo de cada gatilho ativado. Vários e-mails separados por vírgula são aceitos; o sistema remove espaços extras e descarta endereços vazios.
6. Desça até o bloco Alertas do Sistema Viagilize e ative/desative os toggles dos avisos sobre a sua assinatura, agrupados em três seções:
   • Pagamentos - Confirmação de pagamento, Pagamento pendente, Falha no pagamento.
   • Assinatura - Renovação próxima, Assinatura vencida.
   • Sistema - Novidades e atualizações, Manutenção programada.
7. Clique em Salvar Configurações no rodapé do formulário. O sistema valida e redireciona com a mensagem "Configurações de notificações salvas com sucesso!".

Casos especiais

E-mail da empresa não cadastrado

Se você tentar ativar qualquer notificação por e-mail enquanto você ainda não tem o campo E-mail preenchido em Dados da Empresa, a tela mostra um alerta laranja com um link direto para Dados da Empresa e o salvamento é bloqueado com a mensagem "Configure o e-mail da empresa em Dados da Empresa antes de ativar notificações.". Cadastre o e-mail e volte para esta página.

Modo "Emails por tipo" sem preencher a caixa

Ao escolher Emails por tipo e ativar um gatilho sem informar nenhum endereço no campo correspondente, o salvamento é recusado com mensagens específicas por evento (ex.: "Informe os e-mails para receber notificações de Nova Reserva."). Cada gatilho ativado precisa ter ao menos um e-mail no seu campo.

WhatsApp sem número válido

Se você ligar qualquer toggle de WhatsApp e escolher Outro número, o número precisa ter pelo menos 10 caracteres. Caso contrário, o sistema retorna "Informe um número de WhatsApp válido para receber notificações.". Se escolher WhatsApp da empresa sem o campo estar preenchido em Dados da Empresa, o erro será "Configure o WhatsApp da empresa em Dados da Empresa antes de ativar notificações.".

Gatilhos só de um canal

Três gatilhos não suportam os dois canais ao mesmo tempo: Relatório Diário e Recibo de Pagamento ao Cliente só existem em E-mail; Lembrete de Excursão só existe em WhatsApp. Nestes itens a coluna do canal indisponível aparece desabilitada (com opacidade reduzida).

Defaults para empresas novos

empresas recém-criados já vêm com Nova Reserva, Reserva Cancelada, Pagamento Confirmado, Cotação Aceita e Cotação Recusada ligados por e-mail; os demais começam desligados. Esses valores ficam centralizados na constante EMAIL_DEFAULTS do controller e são também o fallback usado pelos observers para decidir se enviam ou não a mensagem.

Erros comuns e como resolver

• "Configure o e-mail da empresa em Dados da Empresa antes de ativar notificações." - Causa: você ativou pelo menos um gatilho de e-mail com a opção Email da empresa marcada, mas você não tem e-mail cadastrado. Solução: clique no link Dados da Empresa no próprio alerta, preencha o campo de e-mail principal e salve. Volte aqui para concluir.
• "Informe os e-mails para receber notificações de Nova Reserva." (ou Reserva Cancelada, Pagamento Confirmado, Novo Cliente, Relatório Diário) - Causa: modo Emails por tipo ativo com aquele gatilho ligado, sem nenhum endereço no campo. Solução: digite ao menos um e-mail (vários podem ser separados por vírgula) ou troque o modo de destino para Email da empresa.
• "Configure o WhatsApp da empresa em Dados da Empresa antes de ativar notificações." - Causa: você ligou um toggle de WhatsApp usando o número da empresa, mas o campo está vazio. Solução: cadastre o WhatsApp em Dados da Empresa ou escolha Outro número e digite o destino.
• "Informe um número de WhatsApp válido para receber notificações." - Causa: opção Outro número ativa com menos de 10 caracteres no campo. Solução: digite o número completo no formato internacional (DDI + DDD + número), por exemplo 5547999999999.
• Toggle ativado mas nada chega - Causa: o canal pode estar ativo no painel, mas você não tem o destino válido configurado, ou o gatilho específico depende de um observer/evento que ainda não foi disparado naquela operação. Solução: confira se o e-mail/WhatsApp da empresa está em Dados da Empresa, salve a página novamente para reconfirmar o estado e refaça a operação de teste (criar uma reserva fictícia, por exemplo).

Onde encontrar

• URL: /admin/configuracoes/notificacoes
• Caminho no menu: Configurações > Notificações
• Permissão necessária: configuracoes.notificacoes para acessar a tela e editar as configurações para salvar
• Módulo necessário: nenhum (envio por WhatsApp respeita o módulo whatsapp-mensagens, sinalizado por um banner de upsell no rodapé da página quando o módulo não está ativo)

Veja também

• Configurações - Central de Notificações
• Templates de E-mail