Envío de correos en Django mediante Mailtrap

▶

Enviar correos electrónicos desde Django es una de esas tareas que tarde o temprano todos necesitamos implementar. Ya sea para confirmar cuentas, recuperar contraseñas o notificar acciones al usuario, configurar el envío de correos correctamente es esencial así como otras tareas más avanzadas como crear chats con comunicaciones fullduplex con Websockets y Django.

Necesitaremos enviar emails para poder probar el módulo de reiniciar la contraseña; la configuración de un servidor de correos está fuera del alcance de este libro y debido a que no todos los lectores están en la capacidad de configurar uno propio o de ya tener uno servidor de correos, emplearemos un servicio que permite simular el envío de emails:

https://mailtrap.io/

¿Por qué necesitas enviar correos en una aplicación Django?

Django facilita enormemente la comunicación con usuarios a través del correo electrónico. Algunos escenarios comunes son:

• Confirmación de registro o verificación de cuenta.
• Recuperación o restablecimiento de contraseñas.
• Notificaciones de eventos, pedidos o cambios importantes.

Configuración inicial del envío de correos en Django

Una vez registrado y creado un servidor de desarrollo, debemos de configurar las siguientes variables:

customlogin\settings.py

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.mailtrap.io'
EMAIL_HOST_USER = '<YourUserMailTrap>'
EMAIL_HOST_PASSWORD = '<YourPasswordMailTrap>'
EMAIL_PORT = '2525'
EMAIL_USE_TLS = True

Las cuales determinan el host, usuario, contraseña y puerto del servidor de correos respectivamente; con esto, estamos listos para que la aplicación pueda enviar correos.

Usar Mailtrap para pruebas de envío de correos

Mailtrap es ideal para probar el envío sin afectar usuarios reales. Lo que hace es interceptar los correos y mostrarlos en una bandeja de entrada de desarrollo.

Pasos rápidos:

• Regístrate en mailtrap.io
• Crea un Inbox o entorno de desarrollo.
• Copia las credenciales SMTP que te proporciona.

Pégalos en el settings.py de tu proyecto (como en el bloque anterior).

De esta forma, cualquier correo que Django intente enviar llegará a tu bandeja de pruebas en Mailtrap, sin riesgo ni necesidad de un servidor real.

Enviar tu primer correo desde Django

Una vez configurado el servidor, puedes enviar tu primer correo con la función send_mail().

from django.core.mail import send_mail
send_mail(
   subject='Prueba de correo desde Django',
   message='¡Hola! Este es un correo de prueba enviado desde Django.',
   from_email='no-reply@miapp.com',
   recipient_list=['usuario@correo.com'],
   fail_silently=False,
)

Qué hace cada parámetro:

• subject: asunto del correo.
• message: contenido del mensaje.
• from_email: dirección del remitente.
• recipient_list: lista de destinatarios.
• fail_silently: si es True, no muestra errores al fallar.

✅ Tip: siempre prueba con varios destinatarios falsos y verifica que Mailtrap los reciba correctamente.

Enviar correos HTML y con archivos adjuntos

Si quieres dar un paso más, Django también permite enviar correos con formato HTML o archivos adjuntos usando EmailMessage o EmailMultiAlternatives.

from django.core.mail import EmailMessage
email = EmailMessage(
   subject='Bienvenido a mi aplicación',
   body='<h1>¡Hola!</h1><p>Gracias por registrarte en nuestra app.</p>',
   from_email='no-reply@miapp.com',
   to=['usuario@correo.com']
)
email.content_subtype = 'html'
email.send()

Consejos y buenas prácticas para entornos de producción

Cuando tu aplicación esté lista para enviar correos reales, ten en cuenta lo siguiente:

• Usa variables de entorno (por ejemplo, con python-decouple) para no exponer credenciales en el código.
• Activa TLS o SSL según lo requiera tu proveedor SMTP.
• Controla el envío masivo para no ser marcado como spam.
• Servicios recomendados: SendGrid, Amazon SES, Gmail SMTP (con App Passwords).

Errores comunes al enviar correos en Django (y cómo solucionarlos)

Error    Causa probable    Solución
smtplib.SMTPAuthenticationError    Usuario o contraseña incorrectos    Revisa credenciales o usa variables de entorno
ConnectionRefusedError    Puerto incorrecto o servidor caído    Verifica EMAIL_PORT y conexión
TimeoutError    Problemas de red o firewall    Prueba en otro entorno o cambia el puerto
Correo no llega    Bloqueo de Gmail o servidor real    Usa Mailtrap o revisa logs SMTP

Conclusión y próximos pasos

Enviar correos en Django es más sencillo de lo que parece si entiendes la estructura de settings.py y usas herramientas adecuadas para cada fase.

Mailtrap es tu mejor aliado para pruebas seguras; luego puedes pasar a un servicio SMTP real en producción.

Sigue practicando con:

• Adjuntos y plantillas personalizadas.
• Mensajes asíncronos con Celery.
• Integración con servicios externos como SendGrid o SES.

En resumen, con unas pocas líneas de código y un entorno bien configurado, puedes profesionalizar el envío de correos en Django sin complicaciones.

Preguntas frecuentes

1. ¿Puedo usar Gmail para enviar correos desde Django?
Sí, pero debes generar una contraseña de aplicación y habilitar TLS en el puerto 587.

2. ¿Qué diferencia hay entre send_mail y EmailMessage?
send_mail es más simple; EmailMessage permite HTML, adjuntos y mayor personalización.

3. ¿Cómo probar sin servidor real?
Con Mailtrap: intercepta y muestra los correos de desarrollo sin riesgo.

4. ¿Por qué no se envía mi correo en Django?
Verifica tus credenciales, puerto SMTP y que no tengas bloqueos de red.

Siguiente paso, Implementando un campo de búsqueda y filtros con formularios en Django para que puedas filtrar esos correos electrónicos.