Registros de E-mail
Requisitos previos de acceso
- Permiso (módulo): acceso restringido al administrador (guard
admin) - Licencia/Feature: Ninguna
- Contenedor del menú: GENERAL → grupo Auditoría
Qué es / cuándo usar
La pantalla Registros de E-mail (/email-logs) lista todos los correos electrónicos que la plataforma intentó enviar a través del NotificationService (proveedor de envío — ej.: Mailgun/Brevo/SendGrid/SES). Cada registro muestra destinatario, remitente, asunto, estado (SUCCESS/FAILURE), fecha y — en el detalle — el cuerpo y el HTML del correo, además del mensaje de error cuando hay una falla.
Use esta pantalla para confirmar si una notificación fue entregada (ej.: correo de confirmación de registro, recuperación de contraseña, aviso de transacción) y para diagnosticar fallas de envío.
Requisitos previos
- Permiso: ruta protegida por guard de administrador. El permiso es doble — enum CPM en el backend + módulo dinámico en la BD.
- Licencia/Feature: ninguna.
- Dependencias de otras pantallas: los registros son grabados automáticamente por el NotificationService en cada intento de envío.
Paso a paso
- Acceda al menú GENERAL → Auditoría → Registros de E-mail (botón de guía integrado disponible — ícono de libro).
- El listado carga la página actual (20 elementos por página).
- (Opcional) Filtre por correo electrónico del destinatario y haga clic en Buscar.
- Haga clic en Ver detalles para abrir el modal con el contenido completo del correo.
- Navegue entre páginas con Anterior/Siguiente.
Filtros y columnas
| Filtro / Columna | Qué muestra | Origen del dato |
|---|---|---|
| E-mail (filtro) | Filtra por destinatario | Parámetro email enviado al backend |
| Estado | SUCCESS (enviado) o FAILURE (falló). Las fallas muestran indicación de error | status / error_message |
| Para | Destinatario; también muestra el template_id cuando existe | to_email / template_id |
| De | Remitente | from_email |
| Asunto | Asunto del correo | subject |
| Enviado en | Fecha/hora del intento | sent_at |
| Acciones | Abre el detalle | — |
Campos (modal de detalles)
| Campo | Qué es | Origen |
|---|---|---|
| Asunto | Asunto enviado | subject |
| Cuerpo (texto) | Contenido de texto del correo | body |
| HTML | Contenido HTML renderizado | html_content |
| Mensaje de error | Detalle de la falla (cuando FAILURE) | error_message |
Acciones y modales
- Buscar: reinicia la paginación y repite la consulta filtrando por correo electrónico.
- Ver detalles: abre el
EmailLogDetailsModalcon asunto, cuerpo, HTML y error. - Guía integrada (ícono de libro): abre la ayuda contextual (
helpGuide.emailLog).
Reglas de negocio / advertencias
Atención
- La paginación es estimada: como el backend retorna únicamente la página actual, el total se infiere (si vienen menos elementos que el tamaño de página, es la última). No confíe en el contador "X de Y" como número exacto de correos.
- Un correo con cuerpo presente pero HTML vacío (o viceversa) suele indicar el bug clásico
bodyData × htmlData: algunos proveedores (Brevo/SendGrid/Mailgun) fallan cuando solo uno de los campos está completo, mientras que SES oculta el problema. Si ve fallas solo en un proveedor específico, sospeche de esto.