Python · Flask

Envoyez votre premier e-mail depuis une route Flask avec le client synchrone du Bird Python SDK. Trois étapes : installer, envoyer, exécuter.

1. Installer le SDK

python -m pip install messagebird-sdk flask

Nécessite Python 3.10+. Le paquet à importer est bird.

2. Envoyer un e-mail

Exportez votre clé API. Le SDK lit BIRD_API_KEY depuis l'environnement et déduit la région (us1 ou eu1) à partir du préfixe bk_us1_ / bk_eu1_, donc Bird() ne nécessite aucun argument :

export BIRD_API_KEY="bk_us1_..."

Créez app.py. Construisez un seul Bird au chargement du module et réutilisez-le entre les requêtes : il mutualise les connexions et peut être partagé entre les threads.

from bird import Bird, APIError
from flask import Flask, jsonify

app = Flask(__name__)
client = Bird()


@app.post("/send")
def send():
    try:
        message = client.email.send(
            from_="onboarding@messagebird.dev",
            to=["delivered@messagebird.dev"],
            subject="Hello from Bird",
            html="<p>My first Bird email.</p>",
        )
    except APIError as err:
        return jsonify({"error": str(err)}), 502
    return jsonify({"id": message.id, "status": message.status}), 202

from_ est l'écriture Python du champ from (from est un mot réservé). onboarding@messagebird.dev est l'expéditeur d'intégration partagé de Bird (aucune vérification de domaine requise) et delivered@messagebird.dev est un destinataire sandbox qui aboutit toujours.

Le SDK réessaye automatiquement les erreurs transitoires et réutilise la clé d'idempotence de l'appel à chaque tentative. Cela empêche un nouvel essai d'envoyer le message deux fois.

3. Tester

flask run
curl -X POST http://localhost:5000/send

Bird accepte le message avec un 202 et le distribue de façon asynchrone ; votre route renvoie l'ID em_ et le statut :

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}

Récupérez le message par son ID em_ avec client.email.get(...) et observez le statut passer de accepted à delivered.

Étapes suivantes

• Référence e-mail Python SDK : toutes les méthodes et options.
• Envoyer votre premier e-mail : le même flux avec curl et la liste complète des adresses sandbox.
• Domaines d'envoi : vérifiez votre propre domaine pour l'envoi en production.
• Référence API e-mail : le schéma complet de requête et de réponse.