Referencia
Catálogo de correos
Cada tipo de correo que envía la Academia, cuándo se envía, a quién y cuánto duran sus enlaces.
Todos los correos de la Academia pasan por una sola clase, plugins/local_deltamodules/classes/mailer.php, que define los tipos de correo en la constante KINDS. Las notificaciones estándar de Moodle no salen por correo (configure-mail.php desactiva esa salida): quedan en la campana de avisos.
Funcionamiento general
| Aspecto | Comportamiento |
|---|---|
| Servidor | Office 365 (smtp.office365.com, puerto 587, STARTTLS) con las variables de entorno MOODLE_SMTP_*. Sin servidor configurado no se envía nada y cada pantalla funciona como antes. La clave nunca se ve ni se cambia desde la plataforma. |
| Cola y registro | Cada correo se guarda en la tabla local_deltamodules_mail, que es también el registro de envíos. La tarea send_mail corre cada minuto y entrega lo pendiente. |
| Límites | Por defecto 20 correos por minuto (máximo configurable 30, el límite aproximado de Office 365 por buzón) y 2000 por día (máximo 10 000). |
| Reintentos | Hasta 3 intentos, con espera creciente (5 minutos después del primero, 10 después del segundo). Desde el registro se puede reintentar un correo fallido. |
| Conservación | El registro se conserva 180 días; los enlaces de contraseña vencidos se borran a los 30 días de vencer. |
| Encender y apagar | Cada tipo se puede apagar en Administración → Correos (clave mail_off_<tipo>); el envío completo se puede pausar. El correo de prueba siempre sale. |
| Destinatarios excluidos | No se envía a cuentas eliminadas, suspendidas, sin inicio de sesión (nologin) o sin correo válido. |
| Diseño | Plantilla institucional: encabezado azul con el logo incrustado, línea roja y tarjeta blanca; los enlaces van en botones, nunca escritos; pie "Este correo fue enviado de forma automática. Por favor, no respondas a este mensaje." y el correo de soporte si está configurado. |
| Trato | Se saluda con el primer nombre y el primer apellido (respetando apellidos compuestos). |
Enlaces para crear contraseña
Los correos de bienvenida y recuperar contraseña llevan un enlace de un solo uso que se crea en el momento del envío y se guarda solo cifrado (hash SHA-256). El registro guarda el correo con un marcador en lugar del enlace, de modo que nadie puede obtener un enlace válido del registro. Crear un enlace nuevo anula los anteriores del mismo tipo, y usar uno anula todos los de esa persona. Solo sirve para cuentas activas con autenticación manual.
Tipos de correo
| Clave | Nombre | Cuándo se envía | A quién | Vigencia del enlace |
|---|---|---|---|---|
reset | Recuperar contraseña | Cuando alguien usa ¿Olvidó su contraseña? con su usuario o correo (y la cuenta tiene correo registrado). | Al correo registrado de la cuenta | 1 hora, un solo uso |
welcome | Bienvenida al personal | Al crear la cuenta de un colaborador (formulario, importación o asistente de gestión), al pulsar Enviar la bienvenida en la ficha de la persona o al enviar las bienvenidas pendientes desde Correos. | Al colaborador: su usuario y el botón Crear mi contraseña | 7 días, un solo uso |
clientwelcome | Cuenta de cliente creada | Cuando el empleado de una empresa cliente crea su cuenta con el código de la empresa. | Al nuevo usuario cliente: confirma que ingresa con su correo y la contraseña que creó | Sin enlace de contraseña (botón al ingreso) |
clientcode | Código para una empresa cliente | Cuando se envía el código de registro desde Clientes → Códigos de registro. | Al contacto que se indique: el código, su vigencia y número de usos, y el botón para crear la cuenta | La del código (fecha de vencimiento y número de usos definidos al generarlo) |
candidatecode | Código de prueba técnica | Cuando se envía el código de acceso desde Postulantes → Códigos de acceso. | Al postulante: el código, el cargo y la fecha de vencimiento | La del código: 1, 3, 7, 15 o 30 días (por defecto 7), elegida al generarlo |
candidatedone | Prueba técnica recibida | Cuando el postulante envía su prueba técnica (sale en el minuto siguiente). | Al postulante: confirmación de recepción, sin la nota; Talento Humano se pondrá en contacto | No aplica |
module | Módulo asignado | Cuando a una persona que ya entró alguna vez a la Academia se le da un módulo nuevo y visible (matrícula activa como estudiante). | A la persona | No aplica |
completed | Módulo terminado y certificado | Cuando alguien completa un módulo visible. | A la persona: felicitación y botón a su certificado (o al módulo si no tiene) | No aplica |
reminder | Recordatorio de módulos pendientes | Los lunes a las 09:00 (tarea mail_reminders), a quien tiene módulos sin terminar y no entra a ellos hace 14 días. | A la persona, con la lista de módulos y su porcentaje de avance | No aplica; como máximo un recordatorio cada 14 días |
test | Correo de prueba | Solo cuando se envía desde Administración → Correos (prueba o ejemplo de un tipo). | A la dirección que se escriba | Los ejemplos llevan enlaces no válidos |
Reglas para no repetir ni molestar
clientwelcome,candidatedone,moduleycompletedusan una clave de no repetición: el mismo aviso no se envía dos veces a la misma persona por el mismo módulo, prueba o cuenta.moduleno se envía a quien nunca entró (esa persona recibe la bienvenida), ni para el curso de la Prueba Técnica de Selección, ni a super administradores, ni a personas excluidas del módulo.completedyreminderno se envían para la Prueba Técnica de Selección ni a super administradores.remindersolo considera cursos visibles con seguimiento de finalización.candidatedonesolo se envía por intentos reales (no vistas previas) de postulantes en el cursoPTS.
Asuntos
| Clave | Asunto |
|---|---|
welcome | Activa tu cuenta — Academia Deltamontero |
reset | Restablece tu contraseña — Academia Deltamontero |
clientwelcome | Tu cuenta en la Academia Deltamontero está lista |
clientcode | Código de acceso a la Academia Deltamontero — (nombre de la empresa) |
candidatecode | Tu código para la prueba técnica — Deltamontero |
candidatedone | Recibimos tu prueba técnica — Deltamontero |
module | Nuevo módulo asignado: (nombre del módulo) |
completed | ¡Felicidades! Completaste (nombre del módulo) |
reminder | Tienes módulos pendientes — Academia Deltamontero |
test | Correo de prueba — Academia Deltamontero, o "[Ejemplo]" seguido del asunto del tipo |
Avisos que no pasan por este catálogo
| Aviso | Canal | Cuándo |
|---|---|---|
| Revisión anual de módulos pendiente | Notificación interna de Moodle (campana), sin correo | Día 1 de cada mes a las 08:00, a las cuentas con perfil de Administrador de Formación |
| Falló el respaldo de la Academia Deltamontero | Correo estándar de Moodle (email_to_user) con la configuración de correo de la Academia | Cuando el respaldo diario del servidor informa un fallo; va a los super administradores y al correo de soporte. Ver Operación. |
| Contraseñas temporales (restablecer varias, contraseña temporal al crear un colaborador, recuperar con cédula) | En pantalla, una sola vez | No se envían por correo |
Mientras la variable MOODLE_MAIL_DIVERT_TO tenga una dirección, todos los correos se desvían a esa dirección sin cambiar el asunto (útil en pruebas). En entornos locales con noemailever no sale ningún correo.