Saltar al contenido principal

Correo por SMTP

sol2flow envía correos para invitaciones, restablecimientos de contraseña, confirmaciones de correo, aprobaciones de registro, avisos de seguridad (por ejemplo «se añadió una llave de acceso») y resúmenes de notificaciones. Cada mensaje tiene una parte HTML y otra de texto plano, y se escribe en el idioma de quien lo recibe.

nota

Exigir confirmación del correo está activado por defecto: las cuentas nuevas, y las personas que cambian su dirección de correo, confirman la dirección con un enlace enviado por correo. Si tu instancia no puede enviar correos, desactívalo en Administración → Autenticación, o nadie podrá terminar de registrarse. Consulta Confirmación del correo.

Configurar SMTP​

  1. Consigue las credenciales SMTP de tu proveedor de correo (o de tu propio servidor de correo). Lo mejor es una dirección de remitente dedicada, como [email protected].

  2. Añade a .env:

    MAIL_DRIVER=smtp
    MAIL_FROM="sol2flow <[email protected]>"
    SMTP_HOST=smtp.example.com
    SMTP_PORT=587
    SMTP_USER=[email protected]
    SMTP_PASSWORD=…
    SMTP_SECURE=false

  3. Aplícalo: docker compose up -d.

  4. Pruébalo: en la página de inicio de sesión, elige ¿Olvidaste la contraseña? para tu propia cuenta y comprueba que llega el correo.

PuertoSMTP_SECURECifrado
587falseSTARTTLS (se activa después de conectar): la opción habitual
465trueTLS desde el primer byte
25falsede servidor a servidor; los proveedores de hosting suelen bloquearlo

Entregabilidad​

  • Envía desde un dominio que controles, y publica para él los registros SPF, DKIM y DMARC como indique tu proveedor de correo. Sin ellos, las invitaciones suelen acabar en spam.
  • MAIL_FROM debe ser una dirección desde la que tu cuenta SMTP tenga permiso para enviar.
  • Los enlaces de los correos usan APP_URL, así que asegúrate de que sea la dirección HTTPS pública.

Entrega y reintentos​

Los correos se ponen en cola y se envían en segundo plano, con reintentos cuando el servidor SMTP no está disponible. Nada de lo que hace un usuario espera al servidor de correo, y un correo fallido nunca deshace el cambio que lo provocó. Los fallos quedan en el log (consulta Solución de problemas).

Sin SMTP​

Con MAIL_DRIVER=log (el valor por defecto) los mensajes no se envían: su asunto y su texto, enlaces incluidos, se escriben en el log de la app (docker compose logs app). Sirve para una primera prueba, pero nadie podrá recibir invitaciones ni restablecer su contraseña.

Correos de notificación​

Además de los correos que se envían siempre (invitaciones, restablecimientos de contraseña, avisos de seguridad), las personas reciben correos de resumen sobre los cambios en sus tareas. El interruptor y la programación para toda la instancia están en Administración → General; cada persona puede desactivarlos en sus propios ajustes. Consulta Notificaciones.