Ikhtisar Email

Kirim email transaksional dan pemasaran melalui POST /v1/email/messages. Gunakan kunci bk_{region}_... dengan host regional yang sesuai: https://us1.platform.bird.com atau https://eu1.platform.bird.com. Kami menandatangani pesan dengan DKIM, mengirimkannya, dan melaporkan hasil untuk setiap penerima.

Untuk langsung mengirim sebelum membaca lebih lanjut, quickstart membawa Anda dari kunci API ke pesan yang terkirim. Halaman ini membahas model yang diasumsikan oleh bagian lainnya, dan menunjukkan panduan untuk setiap bagiannya.

Pengiriman diterima dalam satu panggilan dan dikirim secara asinkron. POST /v1/email/messages memvalidasi payload dan domain pengirim, lalu mengembalikan 202 Accepted dengan em_ message ID. Baca hasil setiap penerima melalui webhook event atau endpoint message. Mengirim email membahas payload, batas field, dan respons.

Dua konsekuensi dari model ini membentuk sisa bagian ini.

Satu pesan, banyak penerima, satu siklus hidup masing-masing. Pesan ke lima alamat menghasilkan lima hasil independen, dan status level pesan yang Anda baca adalah agregat dari semuanya. Supresi dievaluasi dengan cara yang sama: satu alamat yang disupresi dikembalikan sebagai rejected sementara empat lainnya tetap terkirim.

Setiap pesan menyatakan alasan Anda mengirimnya. Kategori berupa transactional atau marketing menentukan supresi mana yang berlaku. Seseorang yang berhenti berlangganan newsletter Anda tetap perlu menerima reset kata sandi, dan kategori inilah yang memberi tahu kami perbedaannya.

Pengiriman juga bisa masuk melalui jalur lain, atau dikirim nanti. SMTP menerima kiriman dari apa pun yang menggunakan protokol tersebut, dan pengiriman terjadwal menahan pesan hingga waktu yang Anda tentukan.

Email adalah salah satu channel di sidebar dashboard. Halaman-halamannya, sesuai urutan tampil:

Penerima berada di luar bagian Email, di Contacts pada sidebar: All contacts menyimpan orang dengan properti kustom bertipe (lihat Kontak), dan Audiences mengelompokkan mereka ke dalam daftar yang dapat digunakan ulang untuk pengiriman broadcast (lihat Audiens).

Pengiriman. Mengirim email adalah yang harus dibaca pertama: panduan ini memiliki payload yang menjadi dasar variasi semua jalur pengiriman lain. Dari sana, template menyimpan konten yang Anda gunakan ulang, lampiran menambahkan file, pengiriman batch mengirimkan hingga 100 pesan dalam satu permintaan, dan broadcast mengirim satu email ke seluruh audiens.

Domain dan autentikasi. Domain pengirim membahas cara mendaftarkan domain dan memverifikasinya. DKIM, SPF, dan DMARC menjelaskan apa yang dibuktikan setiap record kepada penyedia mailbox penerima, dan BIMI menampilkan logo Anda di samping pesan Anda di aplikasi email yang mendukungnya.

Reputasi. Supresi adalah daftar alamat yang kami hentikan pengirimannya, diisi otomatis dari hard bounce dan komplain; berhenti berlangganan menghentikan pengiriman dengan cara yang sama tetapi melalui preferensi yang dinyatakan, bukan catatan supresi. IP dedicated dan pool serta pemanasan IP membahas pengiriman dari alamat IP yang hanya digunakan organisasi Anda. Deliverabilitas email menghubungkan semuanya.

Mengetahui apa yang terjadi. Log email menampilkan satu pesan beserta timeline per penerima. Metrik email mengagregasi lalu lintas Anda. Event adalah kosakata event dan cara webhook mengirimkannya ke endpoint Anda.

Penerimaan. Menerima email membahas dua cara masuk: alamat penerusan yang kami buat tanpa perlu DNS, atau record MX pada subdomain milik Anda. Agent mailboxes melanjutkan dari sana dengan inbox tempat kode Anda mengirim sekaligus membaca.

Pengujian. Mail sandbox menguji integrasi Anda secara menyeluruh tanpa mengirim ke mana pun. Kirim ke bounce@messagebird.dev untuk menghasilkan hard bounce melalui pipeline event dan webhook yang sesungguhnya. Pengujian ini tidak menulis apa pun ke daftar supresi Anda.

Untuk memindahkan email produksi dari penyedia lain, ikuti panduan migrasi. Panduan ini mencakup pemetaan permintaan, DNS, supresi, webhook, pengujian sandbox, dan peralihan lalu lintas.