Python
Invia la tua prima email da un semplice script Python usando il client sincrono dell'Bird Python SDK. Tre passaggi: installa, invia, esegui.
1. Installa l'SDK
Esempio di codice
python -m pip install messagebird-sdkRichiede Python 3.10+. Il pacchetto da importare è bird.
2. Invia un'email
Esporta la tua chiave API. L'SDK legge BIRD_API_KEY dall'ambiente e deduce la regione (us1 o eu1) dal prefisso bk_us1_ / bk_eu1_, quindi Bird() non richiede argomenti:
Esempio di codice
export BIRD_API_KEY="bk_us1_..."Crea send.py:
Esempio di codice
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_ è la forma Python del campo from (from è una parola riservata). onboarding@messagebird.dev è il mittente condiviso di onboarding di Bird (nessuna verifica del dominio necessaria) e delivered@messagebird.dev è un destinatario sandbox che consegna sempre.
L'SDK ripete automaticamente i tentativi in caso di errori transitori e riutilizza la chiave di idempotenza della chiamata a ogni tentativo. Questo impedisce che un nuovo tentativo invii il messaggio due volte.
3. Eseguilo
Esempio di codice
python send.pyLo script stampa l'ID del messaggio e lo stato:
Esempio di codice
em_01ky7ma8y2es1s2akzk53tmjn0 acceptedaccepted è il 202 dell'API: Bird ha il messaggio e lo consegna in modo asincrono. Recuperalo tramite il suo em_ ID con client.email.get(message.id) e osserva lo stato passare da accepted a delivered.
Passaggi successivi
- Riferimento Python SDK: ogni metodo e opzione.
- Invia la tua prima email: lo stesso flusso con curl e l'elenco completo degli indirizzi sandbox.
- Domini di invio: verifica il tuo dominio per l'invio in produzione.
- Riferimento email API: lo schema completo di richiesta e risposta.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaTesting email without spamming anyoneEsplora la funzionalitàTest email deliverySegui il percorso di apprendimentoOperate messaging reliably
Prova l'esercitazione e ottieni un brief di implementazione