E-mails automáticos

Rascunho — ainda não verificado em hml

Escrito a partir do código, sem percorrer as telas em hml. Nomes de campo e ordem de passos podem divergir do que a interface mostra. Ao validar, corrija o que estiver diferente e remova este aviso.

Objetivo

Controlar quais e-mails o sistema envia sozinho, para quem, e com que texto.

Antes de começar

Duas coisas diferentes, e confundi-las é a causa da maioria dos problemas aqui:

• Modelo (template) — o texto do e-mail: assunto e corpo.
• Gatilho (trigger) — quando aquele texto é disparado, e para quem.

Um modelo sem gatilho nunca sai. Um gatilho ativo com o modelo errado sai com o texto errado.

Antes de mexer aqui, o envio precisa estar configurado em /<slug>/admin/settings — veja o passo 3 de Primeiro acesso.

Os eventos disponíveis

Os gatilhos ficam em /<slug>/admin/email-triggers. Cada um escuta um evento:

Cadastro

• Cliente cadastrado

Conclusão de etapa — o processo tem cinco:

1. Cadastro concluído
2. Avaliação Psicológica concluída
3. Laudo de Capacidade Técnica concluído
4. Juntada de Documentos concluída
5. Submissão ao SINARM-CAC concluída

Agendamento

• Agendamento de Avaliação Psicológica
• Confirmação de Agendamento de Laudo Técnico

Mudança de status no SINARM

• Iniciado · Solicitado · Aguardando Baixa GRU · Em Análise · Correção Solicitada · Deferido · Indeferido

Passos

Criar um gatilho

1. Vá em /<slug>/admin/email-triggers.
2. Clique em criar e preencha:
   • Nome do Trigger — descritivo, para você se achar depois. Ex.: Boas-vindas ao cliente.
   • Evento Disparador — um da lista acima.
   • Destinatários — cliente, operador, usuários específicos, ou ambos.
   • Templates de Email — o modelo com o texto.
   • Trigger ativo — deixe ligado para valer.
3. Salve. Aparece Trigger criado com sucesso.

Eventos de agendamento aceitam antecedência em horas (ex.: 24), para o aviso sair antes da data marcada.

Testar sem incomodar cliente

Crie um cliente de teste com um e-mail seu e leve o processo até a etapa que dispara o gatilho. É o único jeito de ver o texto final, com os dados substituídos, do jeito que o cliente vai receber.

Não use cliente real para testar.

Desligar um aviso sem perdê-lo

Desmarque Trigger ativo em vez de excluir. O gatilho para de disparar e a configuração fica guardada para quando você quiser religar.

Como saber que deu certo

• O e-mail de teste chega, com o nome do clube no remetente e os dados do cliente preenchidos no lugar certo.
• O gatilho aparece na lista marcado como ativo.

Se der errado

Nenhum e-mail sai. O problema costuma ser antes daqui: confira o envio em /<slug>/admin/settings e dispare o e-mail de teste de lá. Se o teste não chega, gatilho nenhum vai funcionar.

O e-mail sai com o texto errado. O gatilho está apontando para outro modelo. Confira o campo Templates de Email do gatilho.

Configurei o e-mail em outro ambiente e aqui não veio junto. A configuração de e-mail tem camadas, e os gatilhos seguem o clube — não são copiados junto com as configurações gerais da plataforma. Precisam ser criados neste clube.

O cliente diz que não recebeu. Peça para checar spam, e confira o e-mail cadastrado dele. Depois confirme em Auditoria se a ação que deveria disparar o aviso realmente aconteceu.