Python

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

1. Installer le SDK

python -m pip install messagebird-sdk

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() n'a besoin d'aucun argument :

export BIRD_API_KEY="bk_us1_..."

Créez send.py :

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_ est l'équivalent 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 une nouvelle tentative d'envoyer le message deux fois.

3. Exécuter le script

python send.py

Le script affiche l'identifiant du message et son statut :

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted est le 202 du API : Bird a le message et le distribue de manière asynchrone. Récupérez-le par son em_ ID avec client.email.get(message.id) et observez le statut passer de accepted à delivered.

Étapes suivantes

• Référence 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 la requête et de la réponse.