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

Exemple de code

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 :

Exemple de code

export BIRD_API_KEY="bk_us1_..."

Créez send.py :

Exemple de code

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

Exemple de code

python send.py

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

Exemple de code

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.

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Regarder le guideTesting email without spamming anyone Explorer la fonctionnalitéTest email delivery Suivre le parcours d'apprentissageOperate messaging reliably

Essayez la pratique et obtenez un guide d'implémentation