Documentación Técnica
SmartSMTP for Moodle
Guía completa de instalación, configuración y solución de problemas para administradores.
Introducción
SmartSMTP es un plugin para Moodle que permite configurar múltiples cuentas SMTP y enrutar las notificaciones del sistema a diferentes servidores de correo según el tipo de actividad. Esto evita que proveedores como Gmail o Yahoo bloqueen la cuenta por exceso de envíos.
El plugin se compone de dos componentes que trabajan juntos:
- local_smartsmtp — Panel de administración, gestión de cuentas, reglas de enrutamiento, logs y licencia.
- message_smartsmtp — Procesador de mensajes que intercepta las notificaciones de Moodle y las enruta al buzón correcto.
Plan gratuito vs. Premium
El plan gratuito incluye hasta 2 cuentas SMTP y 2 reglas de enrutamiento. El plan premium desbloquea cuentas y reglas ilimitadas, enrutamiento por nombre de notificación y balanceo de carga round-robin.
Requisitos
| Componente | Versión mínima |
|---|---|
| Moodle | 4.5 - 5.2 |
| Extensión PHP OpenSSL | Requerida para validación de licencia |
Importante
El servidor debe tener habilitada la extensión
openssl de PHP. Puedes verificarlo en Administración del sitio → Información del servidor → Información de PHP.
Instalación
Descarga
El plugin se distribuye en dos versiones:
- Gratuita — Disponible en el Moodle Marketplace.
- Premium — Disponible en raxelion.com/smartsmtp/premium tras la compra.
Pasos de instalación
- Descarga el paquete ZIP del plugin.
- Extrae la carpeta
local/smartsmtp/dentro de la carpetalocal/en la raíz de tu Moodle. - Extrae la carpeta
message/output/smartsmtp/dentro demessage/output/en la raíz de tu Moodle. - Inicia sesión como administrador en Moodle.
- Ve a Administración del sitio → Notificaciones.
- Moodle detectará los plugins nuevos y mostrará la pantalla de instalación. Confirma la instalación.
Activar el procesador de mensajes
- Ve a Administración del sitio → Mensajería → Procesadores de mensajes.
- Localiza SmartSMTP en la lista.
- Activa el procesador haciendo clic en el ícono de visibilidad.
Verificación
Una vez instalado, el menú de administración mostrará Administración del sitio → Plugins → Plugins locales → SmartSMTP Manager.
Cuentas SMTP
Las cuentas SMTP son los buzones de correo que SmartSMTP utilizará para enviar notificaciones. Puedes registrar hasta 2 cuentas en el plan gratuito o cuentas ilimitadas en el plan premium.
Agregar una cuenta
- Ve a Administración del sitio → Plugins → Plugins locales → SmartSMTP Manager → Cuentas.
- Haz clic en Agregar cuenta.
- Completa los campos del formulario.
- Guarda y prueba la conexión.
Campos del formulario
| Campo | Descripción |
|---|---|
| Nombre | Nombre identificador de la cuenta. Solo visible en el panel de administración. |
| Servidor SMTP | Dirección del servidor de correo. Ejemplo: smtp.gmail.com |
| Puerto | Puerto de conexión. Ver tabla de proveedores más abajo. |
| Seguridad | tls (recomendado), ssl o ninguno. |
| Usuario SMTP | Correo electrónico completo usado para autenticación. |
| Contraseña | Contraseña o App Password del proveedor. |
| Límite diario | Número máximo de correos por día. Usa 0 para sin límite. |
| Correo noreply | Dirección que aparece en el campo "De:" de los correos enviados. |
| Nombre del remitente | Nombre visible junto al correo noreply. |
| Predeterminado | Esta cuenta se usa cuando ninguna regla aplica al mensaje. |
Cuenta predeterminada
Solo puede haber una cuenta predeterminada activa. Esta cuenta también se usa para los correos del sistema como recuperación de contraseña y registro de usuarios nuevos.
Probar una cuenta
Desde la lista de cuentas, haz clic en Probar junto a la cuenta que deseas verificar. Ingresa una dirección de correo de destino y el plugin enviará un mensaje de prueba. El resultado mostrará si la conexión fue exitosa o el error específico.
Reglas de enrutamiento
Las reglas determinan qué cuenta SMTP se usa para cada tipo de notificación de Moodle. Puedes configurar hasta 2 reglas en el plan gratuito.
Crear una regla
- Ve a SmartSMTP Manager → Reglas.
- Selecciona el componente de Moodle (por ejemplo
mod_forum). - Selecciona la cuenta SMTP que se usará para ese componente.
- Asigna una prioridad. Las reglas con mayor prioridad se evalúan primero.
- Guarda la regla.
Lógica de selección de cuenta
Cuando Moodle necesita enviar una notificación, SmartSMTP evalúa las reglas en el siguiente orden:
- Busca reglas que coincidan con el componente del mensaje, ordenadas por prioridad de mayor a menor.
- Para cada regla encontrada, verifica si la cuenta asignada tiene capacidad disponible (no ha alcanzado su límite diario).
- Usa la primera cuenta con capacidad disponible.
- Si ninguna regla tiene capacidad, usa la cuenta predeterminada.
- Si la cuenta predeterminada tampoco tiene capacidad, el envío falla y Moodle reintenta la tarea.
Componentes comunes de Moodle
| Componente | Tipo de notificaciones Premium | Descripción |
|---|---|---|
mod_forum | posts, digests | Publicaciones suscritas en foros y resúmenes diarios |
mod_assign | assign_notification, assign_due_soon, assign_overdue | Notificaciones de entregas, tareas próximas a vencer y vencidas |
mod_quiz | submission, confirmation | Notificación al docente de intentos enviados y confirmación al alumno |
mod_workshop | submission, assessment | Entregas y evaluaciones entre pares en talleres |
mod_lesson | graded_essay | Notificación de ensayo calificado en una lección |
mod_feedback | submission | Envío de formularios de retroalimentación |
mod_data | newentry | Nueva entrada en una base de datos |
mod_glossary | add_entry_notification | Nueva entrada agregada a un glosario |
mod_chat | messages | Mensajes en sala de chat |
mod_choice | studentchoiceadded | Un alumno realizó una elección |
mod_scorm | launch | Inicio de un paquete SCORM |
core_badges | badgerecipientnotice, badgecreatornotice | Insignias otorgadas al alumno y notificación al creador |
enrol | expiry_notification | Aviso de vencimiento de inscripción a curso |
enrol_self | enrolment_expiry | Vencimiento de inscripción por autoinscripción |
core_calendar | eventreminder | Recordatorio de eventos del calendario |
moodle | instantmessage, emailconfirmation, passwordchangeconfirmation | Mensajes instantáneos, confirmación de cuenta y cambio de contraseña |
core_course | activity_modules | Notificaciones de módulos de actividades del curso |
Plan Premium — Round-Robin
Con el plan premium puedes activar balanceo de carga round-robin en una regla. Esto distribuye los envíos de forma rotatoria entre todas las cuentas asignadas al mismo componente, maximizando el uso de los límites de cada proveedor.
Licencia premium
Activar la licencia
- Adquiere tu licencia en raxelion.com/smartsmtp/premium.
- Recibirás una clave de licencia por correo electrónico.
- Ve a SmartSMTP Manager → Licencia.
- Pega la clave en el campo correspondiente y haz clic en Activar.
Detalles de la licencia
- La licencia es válida por 1 año a partir de la fecha de compra.
- La licencia está vinculada al dominio del sitio. No puede usarse en otro dominio sin adquirir una licencia adicional.
- La validación es completamente local — el plugin no hace llamadas externas para verificar la licencia.
- 30 días antes del vencimiento, el panel mostrará un aviso con los días restantes.
Vencimiento de la licencia
Cuando la licencia vence, el plugin degrada automáticamente al plan gratuito:
- Los correos continúan enviándose sin interrupción.
- No se pueden agregar nuevas cuentas si ya tienes más de 2 registradas.
- Si tienes más de 2 cuentas, la edición queda bloqueada hasta reducir a 2 o menos, o renovar la licencia.
- El round-robin se desactiva.
Renovación
Para renovar tu licencia visita raxelion.com/smartsmtp/premium o contacta a contacto@raxelion.com.
Registros de envío
SmartSMTP registra todos los envíos en SmartSMTP Manager → Registros. Puedes filtrar por cuenta y estado.
| Campo | Descripción |
|---|---|
| Fecha | Fecha y hora del envío. |
| Cuenta | Buzón SMTP utilizado. |
| Destinatario | Correo electrónico del destinatario. |
| Asunto | Asunto del mensaje enviado. |
| Estado | Enviado — éxito. Fallido — error en el envío. |
Los contadores diarios por cuenta se reinician automáticamente cada día a medianoche mediante una tarea programada. También puedes ver el consumo actual en la lista de cuentas (X / Y correos hoy).
Configuración por proveedor
Gmail
| Campo | Valor |
|---|---|
| Servidor SMTP | smtp.gmail.com |
| Puerto | 587 |
| Seguridad | tls |
| Usuario | Tu correo Gmail completo |
| Contraseña | App Password (no tu contraseña normal) |
App Password en Gmail
Gmail requiere una contraseña de aplicación si tienes verificación en 2 pasos activa. Genérala en Cuenta de Google → Seguridad → Contraseñas de aplicaciones. El límite de envío de Gmail es de 500 correos/día para cuentas gratuitas.
Outlook / Microsoft 365
| Campo | Valor |
|---|---|
| Servidor SMTP | smtp.office365.com |
| Puerto | 587 |
| Seguridad | tls |
| Usuario | Tu correo Outlook completo |
| Contraseña | Contraseña de tu cuenta o App Password |
Yahoo Mail
| Campo | Valor |
|---|---|
| Servidor SMTP | smtp.mail.yahoo.com |
| Puerto | 465 |
| Seguridad | ssl |
| Usuario | Tu correo Yahoo completo |
| Contraseña | App Password de Yahoo |
Servidor SMTP propio
| Campo | Valor |
|---|---|
| Servidor SMTP | Tu dominio o IP del servidor |
| Puerto | 587 (TLS) o 465 (SSL) |
| Seguridad | tls o ssl según tu servidor |
| Límite diario | 0 (sin límite) si controlas el servidor |
Solución de problemas
Los correos no se envían
- Verifica que el procesador SmartSMTP está activado en Administración del sitio → Mensajería → Procesadores de mensajes.
- Verifica que tienes al menos una cuenta SMTP configurada y marcada como predeterminada.
- Usa Probar cuenta para verificar que las credenciales son correctas.
- Revisa los registros en SmartSMTP Manager → Registros para ver si hay errores.
- Verifica que el cron de Moodle está ejecutándose correctamente.
Error de autenticación SMTP
Si el error menciona autenticación o credenciales incorrectas:
- Gmail: Verifica que estás usando una App Password, no tu contraseña normal.
- Yahoo: Genera una App Password desde la configuración de seguridad de tu cuenta Yahoo.
- Outlook: Verifica que el acceso SMTP está habilitado en la configuración de tu cuenta.
Los correos van solo por la cuenta predeterminada
Verifica que:
- Las reglas de enrutamiento están configuradas correctamente en SmartSMTP Manager → Reglas.
- El componente en la regla coincide exactamente con el componente del mensaje (por ejemplo
mod_forum). - La cuenta asignada en la regla no ha alcanzado su límite diario.
Los contadores diarios no se reinician
Los contadores se reinician mediante una tarea programada del cron. Verifica que el cron de Moodle está configurado y ejecutándose. Puedes reiniciar manualmente los contadores eliminando los registros de la tabla mdl_smartsmtp_daily_counts.
Error "sin buzón disponible"
Este error indica que todas las cuentas configuradas han alcanzado su límite diario. Soluciones:
- Aumenta el límite diario de alguna cuenta.
- Agrega más cuentas SMTP (requiere plan premium si ya tienes 2).
- Espera a que los contadores se reinicien al día siguiente.
Soporte
Si tienes dudas o problemas que no están cubiertos en esta documentación, contáctanos:
- Correo: contacto@raxelion.com
- Documentación actualizada: raxelion.com/smartsmtp/docs
- Versión premium: raxelion.com/smartsmtp/premium
Soporte prioritario
Los clientes con licencia premium reciben atención prioritaria por correo electrónico.