Logs de E-mail
Pré-requisitos de acesso
- Permissão (módulo): acesso restrito a administrador (guard
admin) - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Auditoria
O que é / quando usar
A tela Logs de E-mail (/email-logs) lista todos os e-mails que a plataforma tentou enviar via NotificationService (provedor de envio — ex.: Mailgun/Brevo/SendGrid/SES). Cada registro mostra destinatário, remetente, assunto, status (SUCCESS/FAILURE), data e — no detalhe — o corpo e o HTML do e-mail, além da mensagem de erro quando há falha.
Use esta tela para confirmar se uma notificação foi entregue (ex.: e-mail de confirmação de cadastro, recuperação de senha, aviso de transação) e para diagnosticar falhas de envio.
Pré-condições
- Permissão: rota protegida por guard de administrador. Permissão é dupla — enum CPM no backend + módulo dinâmico no DB.
- Licença/Feature: nenhuma.
- Dependências de outras telas: os logs são gravados automaticamente pelo NotificationService a cada tentativa de envio.
Passo a passo
- Acesse o menu GERAL → Auditoria → Logs de E-mail (botão de guia embutido disponível — ícone de livro).
- A listagem carrega a página atual (20 itens por página).
- (Opcional) Filtre por e-mail do destinatário e clique em Buscar.
- Clique em Ver detalhes para abrir o modal com o conteúdo completo do e-mail.
- Navegue entre páginas com Anterior/Próxima.
Filtros e colunas
| Filtro / Coluna | O que mostra | Origem do dado |
|---|---|---|
| E-mail (filtro) | Filtra por destinatário | Parâmetro email enviado ao backend |
| Status | SUCCESS (enviado) ou FAILURE (falhou). Falhas exibem indicação de erro | status / error_message |
| Para | Destinatário; mostra também o template_id quando houver | to_email / template_id |
| De | Remetente | from_email |
| Assunto | Assunto do e-mail | subject |
| Enviado em | Data/hora da tentativa | sent_at |
| Ações | Abre o detalhe | — |
Campos (modal de detalhes)
| Campo | O que é | Origem |
|---|---|---|
| Assunto | Assunto enviado | subject |
| Corpo (texto) | Conteúdo de texto do e-mail | body |
| HTML | Conteúdo HTML renderizado | html_content |
| Mensagem de erro | Detalhe da falha (quando FAILURE) | error_message |
Ações e modais
- Buscar: reinicia a paginação e refaz a consulta filtrando por e-mail.
- Ver detalhes: abre o
EmailLogDetailsModalcom assunto, corpo, HTML e erro. - Guia embutido (ícone de livro): abre a ajuda contextual (
helpGuide.emailLog).
Regras de negócio / cuidados
Atenção
- A paginação é estimada: como o backend retorna apenas a página, o total é inferido (se vier menos que o tamanho de página, é a última). Não confie no contador de "X de Y" como número exato de e-mails.
- Um e-mail com corpo presente mas HTML vazio (ou vice-versa) costuma indicar o bug clássico
bodyData × htmlData: alguns provedores (Brevo/SendGrid/Mailgun) quebram quando só um dos campos é preenchido, enquanto o SES mascara o problema. Se vir falhas só em determinado provedor, suspeite disso.