Sign inGet Started

Python

Senden Sie Ihre erste E-Mail aus einem einfachen Python-Skript mit dem synchronen Client des Bird Python SDK. Drei Schritte: installieren, senden, ausführen.

1. SDK installieren

Codebeispiel
python -m pip install messagebird-sdk
Erfordert Python 3.10+. Das Import-Paket ist bird.

2. Eine E-Mail senden

Exportieren Sie Ihren API-Schlüssel. Der SDK liest BIRD_API_KEY aus der Umgebung und leitet die Region (us1 oder eu1) aus dem Präfix bk_us1_ / bk_eu1_ ab, sodass Bird() keine Argumente benötigt:
Codebeispiel
export BIRD_API_KEY="bk_us1_..."
Erstellen Sie send.py:
Codebeispiel
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_ ist die Python-Schreibweise des Feldes from (from ist ein reserviertes Wort). onboarding@messagebird.dev ist der gemeinsame Onboarding-Absender von Bird (keine Domain-Verifizierung nötig) und delivered@messagebird.dev ist ein Sandbox-Empfänger, der immer zugestellt wird.
Der SDK wiederholt fehlgeschlagene Anfragen bei vorübergehenden Fehlern automatisch und verwendet bei jedem Versuch den Idempotenzschlüssel des Aufrufs erneut. Das verhindert, dass ein erneuter Versuch die Nachricht doppelt sendet.

3. Ausführen

Codebeispiel
python send.py
Das Skript gibt die Nachrichten-ID und den Status aus:
Codebeispiel
em_01ky7ma8y2es1s2akzk53tmjn0 accepted
accepted ist der 202 des API: Bird hat die Nachricht und stellt sie asynchron zu. Rufen Sie sie über ihre em_-ID mit client.email.get(message.id) ab und beobachten Sie, wie der Status von accepted zu delivered wechselt.

Nächste Schritte