Python

Envía tu primer correo electrónico desde un script de Python usando el cliente síncrono del Bird Python SDK. Tres pasos: instalar, enviar, ejecutar.

1. Instala el SDK

Ejemplo de código

python -m pip install messagebird-sdk

Requiere Python 3.10+. El paquete de importación es bird.

2. Envía un correo electrónico

Exporta tu clave API. El SDK lee BIRD_API_KEY del entorno e infiere la región (us1 o eu1) a partir del prefijo bk_us1_ / bk_eu1_, así que Bird() no necesita argumentos:

Ejemplo de código

export BIRD_API_KEY="bk_us1_..."

Crea send.py:

Ejemplo de código

from bird import APIError, Bird

with Bird() as client:
    try:
        message = client.email.send(
            from_={"email": "onboarding@messagebird.dev", "name": "Bird"},
            to=["delivered@messagebird.dev"],
            subject="Hello from Bird",
            html="<p>My first Bird email.</p>",
        )
        print(message.id, message.status)
    except APIError as err:
        print("send failed:", err)

from_ es la forma en Python del campo from (from es una palabra reservada). onboarding@messagebird.dev es el remitente compartido de incorporación de Bird (no requiere verificación de dominio) y delivered@messagebird.dev es un destinatario de sandbox que siempre entrega.

El SDK reintenta fallos transitorios automáticamente y reutiliza la clave de idempotencia de la llamada en cada intento. Esto evita que un reintento envíe el mensaje dos veces.

3. Ejecútalo

Ejemplo de código

python send.py

El script imprime el ID del mensaje y su estado:

Ejemplo de código

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted es el 202 del API: Bird tiene el mensaje y lo entrega de forma asíncrona. Consúltalo por su ID em_ con client.email.get(message.id) y observa cómo el estado pasa de accepted a delivered.

Próximos pasos

Referencia del SDK de Python: todos los métodos y opciones.
Envía tu primer correo electrónico: el mismo flujo con curl y la lista completa de direcciones del sandbox.
Dominios de envío: verifica tu propio dominio para envío en producción.
Referencia del API de email: el esquema completo de solicitud y respuesta.

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaTesting email without spamming anyone Explorar la funcionalidadTest email delivery Seguir la ruta de aprendizajeOperate messaging reliably

Prueba el ejercicio y obtén un resumen de implementación