HOWTO · Python
Enviar correos electrónicos a múltiples direcciones usando Python
Este artículo demuestra cómo enviar correos electrónicos a múltiples direcciones usando Python.
En esta página
Enviar el mismo mensaje a varias direcciones es una tarea de la biblioteca estándar en Python: smtplib gestiona la sesión SMTP, y EmailMessage de email.message contiene los encabezados y el cuerpo. Coloque cada dirección que un destinatario deba ver en el encabezado To o Cc, coloque las direcciones ocultas en Bcc y llame a send_message una sola vez: el servidor SMTP se encarga de entregar una copia a cada buzón.
Cómo funcionan los múltiples destinatarios de correo electrónico
Un correo electrónico lleva dos listas de destinatarios independientes, y distinguirlas explica la mayoría de las sorpresas con varios destinatarios:
- Los destinatarios del sobre son las direcciones que su cliente entrega al servidor SMTP en comandos
RCPT TO. La entrega depende por completo de esta lista. - Los destinatarios del encabezado son las líneas
To,CcyBccdentro del mensaje. Son pistas de visualización para los clientes de correo; el servidor no enruta en función de ellas.
To y Cc se comportan igual para la entrega: todos los destinatarios pueden ver ambas listas. Los destinatarios de Bcc reciben el mensaje como cualquier otro, pero send_message elimina el encabezado Bcc antes de transmitir, de modo que nadie ve quién recibió una copia oculta.
Cuando llama a server.send_message(message), smtplib lee los encabezados To, Cc y Bcc y envía un RCPT TO por dirección. También puede pasar una lista explícita como to_addrs, que sustituye a los encabezados para la entrega; resulta útil cuando la línea To visible debe diferir de la lista real de entrega, por ejemplo para una lista de distribución oculta.
Cada dirección recibe una copia idéntica byte a byte del mensaje. Si cada persona necesita un contenido diferente, cree y envíe un EmailMessage independiente por destinatario; la última sección cubre ese patrón.
Elija un servidor SMTP y una autenticación segura
Para llegar a un proveedor de correo real necesita tres cosas: el nombre de host y el puerto SMTP del proveedor, un nombre de cuenta y una credencial. La documentación del proveedor es la autoridad: los requisitos cambian, así que confirme los valores actuales en lugar de confiar en un fragmento copiado.
Son comunes dos estilos de conexión cifrada:
- TLS implícito desde el primer byte, normalmente en el puerto
465: usesmtplib.SMTP_SSL(host, port). - Una conexión sin cifrar que se actualiza con STARTTLS, normalmente en el puerto
587: usesmtplib.SMTP(host, port)y luego llame aserver.starttls()antes deserver.login(...).
Muchos proveedores ya no aceptan la contraseña normal de la cuenta por SMTP. Emiten una contraseña de aplicación, una clave de API usada como contraseña, o exigen OAuth2: genere la opción que el proveedor admita. Guarde la credencial fuera del código fuente; las variables de entorno, como hace el segundo ejemplo, son el punto de partida más sencillo. Nunca guarde credenciales reales en un repositorio.
Cree un EmailMessage para varios destinatarios
EmailMessage se comporta como un diccionario ordenado de encabezados más un cuerpo. Establezca primero los encabezados:
message["From"]: el remitente. La mayoría de los proveedores exige que coincida con la cuenta autenticada o con un alias verificado; una discrepancia es una causa frecuente de rechazo.message["To"]: una cadena separada por comas. Una una lista de Python con", ".join(recipients)para que el programa siga siendo fácil de ampliar.message["Cc"]ymessage["Bcc"]: opcionales, en el mismo formato separado por comas.message["Subject"]: la línea de asunto.
message.set_content("...") rellena un cuerpo de texto plano y establece Content-Type: text/plain por usted. Para una versión HTML, llame a message.add_alternative(html, subtype="html") después de set_content, de modo que los clientes que prefieren texto conserven una alternativa. message.add_attachment(...) añade archivos como PDF o imágenes.
Envíe el mensaje con smtplib
send_message transmite el mensaje construido una sola vez y deja que el servidor lo distribuya a cada destinatario del sobre. Usado como gestor de contexto, el objeto SMTP cierra la sesión correctamente con QUIT cuando termina el bloque with.
Ejecute este script completo. Inicia un pequeño servidor SMTP de prueba en localhost, envía un EmailMessage a un par de direcciones To más direcciones Cc y Bcc a través de smtplib, e imprime cada destinatario del sobre que el servidor registró:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
import smtplib
import socket
import threading
from email.message import EmailMessage
recipients_seen = []
def run_server(sock):
conn, _ = sock.accept()
conn.sendall(b"220 localhost ESMTP test server\r\n")
data_mode = False
buffer = b""
while True:
chunk = conn.recv(1024)
if not chunk:
return
buffer += chunk
while b"\r\n" in buffer:
line, buffer = buffer.split(b"\r\n", 1)
if data_mode:
if line == b".":
data_mode = False
conn.sendall(b"250 Message stored\r\n")
continue
command = line.decode().split(" ", 1)[0].upper()
if command == "RCPT":
address = line.decode().rsplit(":", 1)[-1].strip().strip("<>")
recipients_seen.append(address)
conn.sendall(b"250 OK\r\n")
elif command == "DATA":
data_mode = True
conn.sendall(b"354 End data with <CR><LF>.<CR><LF>\r\n")
elif command == "QUIT":
conn.sendall(b"221 Bye\r\n")
return
else:
conn.sendall(b"250 OK\r\n")
listener = socket.socket()
listener.bind(("127.0.0.1", 0))
listener.listen(1)
port = listener.getsockname()[1]
thread = threading.Thread(target=run_server, args=(listener,))
thread.start()
message = EmailMessage()
message["Subject"] = "Team update"
message["From"] = "sender@example.com"
message["To"] = "alice@example.com, bob@example.com"
message["Cc"] = "carol@example.com"
message["Bcc"] = "dave@example.com"
message.set_content("Here is this week's team update.")
with smtplib.SMTP("127.0.0.1", port) as server:
server.send_message(message)
thread.join()
listener.close()
print("Delivered to these envelope recipients:")
for recipient in recipients_seen:
print(recipient)
Delivered to these envelope recipients:
alice@example.com
bob@example.com
dave@example.com
carol@example.com
El servidor de prueba registró cuatro direcciones RCPT TO, una por cada dirección del encabezado, incluida dave@example.com, cuyo encabezado Bcc se elimina de la copia transmitida pero sigue dirigiendo la entrega. Esa es la división entre sobre y encabezado en acción. El servidor de prueba local habla SMTP sin cifrar, por eso este script usa smtplib.SMTP sin cifrado.
Para enviar a través de un proveedor real, adapte el mismo mensaje así. El script lee los datos de conexión de variables de entorno y le recuerda que las configure cuando faltan:
import os
import smtplib
from email.message import EmailMessage
SMTP_HOST = os.environ.get("SMTP_HOST", "")
SMTP_PORT = int(os.environ.get("SMTP_PORT", "465"))
SMTP_USER = os.environ.get("SMTP_USER", "")
SMTP_PASSWORD = os.environ.get("SMTP_PASSWORD", "")
recipients = [
"alice@example.com",
"bob@example.com",
"carol@example.com",
]
message = EmailMessage()
message["Subject"] = "Team update"
message["From"] = SMTP_USER
message["To"] = ", ".join(recipients)
message.set_content("Here is this week's team update.")
if SMTP_HOST and SMTP_USER and SMTP_PASSWORD:
with smtplib.SMTP_SSL(SMTP_HOST, SMTP_PORT) as server:
server.login(SMTP_USER, SMTP_PASSWORD)
refused = server.send_message(message)
print("Accepted for all recipients" if not refused else f"Refused: {refused}")
else:
print("Set SMTP_HOST, SMTP_PORT, SMTP_USER, and SMTP_PASSWORD to send this message.")
Set SMTP_HOST, SMTP_PORT, SMTP_USER, and SMTP_PASSWORD to send this message.
Con las variables definidas y un proveedor accesible, el mismo script inicia sesión con server.login, envía a través de SMTP_SSL e imprime Accepted for all recipients.
Gestione los errores de entrega y adapte el ejemplo
Los fallos se concentran en unos pocos puntos predecibles:
- Autenticación:
server.logingenerasmtplib.SMTPAuthenticationErrorcuando la credencial es incorrecta o cuando el proveedor exige una contraseña de aplicación u OAuth2 en lugar de la contraseña de la cuenta. - Conexión: un nombre de host incorrecto genera
socket.gaierror; un puerto equivocado o una ruta bloqueada aparece comosmtplib.SMTPConnectErroro un tiempo de espera agotado. Compruebe que el puerto coincida con el estilo de cifrado:SMTP_SSLpara465,SMTPmásstarttls()para587. - Rechazo de destinatarios: si el servidor rechaza todas las direcciones,
send_messagegenerasmtplib.SMTPRecipientsRefused. Si solo rechaza algunas, aún envía al resto y devuelve un diccionario que asigna a cada dirección rechazada su código de estado SMTP y su mensaje; inspeccione ese valor de retorno en lugar de suponer que el silencio significa éxito.
Una respuesta SMTP 250 significa que el servidor aceptó el mensaje para reenviarlo, no que haya llegado a una bandeja de entrada. Los proveedores aún pueden filtrarlo, ponerlo en cuarentena o rebotarlo, así que vigile el buzón del remitente por avisos de rebote durante los envíos reales.
Para adaptar el ejemplo, sustituya la lista recipients por direcciones cargadas desde un archivo, una base de datos o una variable de entorno. Para contenido personalizado, mantenga la conexión abierta en un único bloque with y recorra send_message con un EmailMessage por persona: reutilizar la sesión es mucho más rápido que reconectar. Para anuncios masivos, Bcc mantiene las direcciones privadas, pero vigile los límites de velocidad del proveedor; las listas muy grandes pertenecen a un servicio de envío dedicado.