Python

Kirim email pertama Anda dari skrip Python biasa menggunakan klien sinkron Bird Python SDK. Tiga langkah: instal, kirim, jalankan.

1. Instal SDK

Contoh kode

python -m pip install messagebird-sdk

Membutuhkan Python 3.10+. Paket impor adalah bird.

2. Kirim email

Ekspor kunci API Anda. SDK membaca BIRD_API_KEY dari environment dan menentukan region (us1 atau eu1) dari prefiks bk_us1_ / bk_eu1_, sehingga Bird() tidak memerlukan argumen:

Contoh kode

export BIRD_API_KEY="bk_us1_..."

Buat send.py:

Contoh kode

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_ adalah bentuk Python dari field from (from adalah kata cadangan). onboarding@messagebird.dev adalah pengirim onboarding bersama milik Bird (tidak perlu verifikasi domain) dan delivered@messagebird.dev adalah penerima sandbox yang selalu berhasil terkirim.

SDK mencoba ulang kegagalan sementara secara otomatis dan menggunakan kembali kunci idempotensi pemanggilan pada setiap percobaan. Ini mencegah percobaan ulang mengirim pesan dua kali.

3. Jalankan

Contoh kode

python send.py

Skrip mencetak ID pesan dan statusnya:

Contoh kode

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted adalah 202 dari API: Bird sudah menerima pesan dan mengirimkannya secara asinkron. Ambil pesan berdasarkan em_ ID menggunakan client.email.get(message.id) dan pantau statusnya berubah dari accepted ke delivered.

Langkah berikutnya

Referensi Python SDK: semua method dan opsi.
Kirim email pertama Anda: alur yang sama dengan curl dan daftar lengkap alamat sandbox.
Domain pengiriman: verifikasi domain Anda sendiri untuk pengiriman produksi.
Referensi Email API: skema request dan response lengkap.

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaTesting email without spamming anyone Jelajahi kemampuannyaTest email delivery Ikuti jalur pembelajaranOperate messaging reliably

Coba praktiknya dan dapatkan ringkasan implementasi