Broadcast

Broadcast mengirim satu email ke seluruh audiens: newsletter, pengumuman, atau konten apa pun yang dikirim ke banyak penerima sekaligus. Anggota audiens diubah menjadi daftar penerima saat pengiriman dimulai, sehingga broadcast menjangkau siapa pun yang menjadi anggota audiens pada saat itu.

Buat broadcast di Email > Broadcasts di dashboard, melalui API broadcasts, dengan bird email broadcasts, atau melalui server MCP. SDK TypeScript, Python, Go, dan PHP menyediakan resource broadcasts untuk seluruh siklus: buat draf, ubah selagi masih draf, kirim sekarang atau di waktu mendatang, daftar broadcast workspace, baca satu beserta penghitungnya, batalkan yang sudah dijadwalkan atau sedang dikirim, hapus yang masih draf, dan baca penerima, event, tautan yang diklik, kuota pengiriman yang akan dipakai, serta jumlah audiens yang akan di-resolve saat pengiriman. Untuk daftar penerima sekali pakai, gunakan pengiriman batch atau pengiriman tunggal.

Mulai dari daftar Broadcasts dengan New broadcast. Composer adalah satu halaman: bilah audience dan pengirim di bagian atas, konten email di bawahnya, dan kontrol pengaturan untuk kategori, pelacakan, dan tag. Tidak ada langkah simpan terpisah. Setiap perubahan tersimpan otomatis begitu broadcast memiliki audience dan pengirim, jadi draf sudah ada segera setelah keduanya diatur, dan mengirimnya nanti adalah tindakan terpisah yang eksplisit.

Gunakan kolom To untuk memilih audience, atau pilih New untuk membuat audience baru tanpa meninggalkan composer.

Buka kontrol pengaturan di header composer untuk tiga hal lagi:

Broadcast dikirim dari alamat pada domain pengiriman terverifikasi. Pasangkan bagian lokal dengan salah satu domain terverifikasi Anda, dan tambahkan nama tampilan jika diperlukan. Tambahkan alamat Reply-To jika Anda ingin balasan diarahkan ke tempat lain. Memilih Review memberi peringatan jika domain belum terverifikasi.

Broadcast merujuk ke salah satu template email di workspace Anda, dan template tersebut memiliki baris subjek serta isi yang dikirim broadcast. Properti kontak setiap penerima mengisi variabel template saat pengiriman berjalan, sehingga satu broadcast mempersonalisasi kontennya per penerima. Broadcast hanya dapat mengisi properti kontak, jadi variabel template yang merujuk hal lain ditolak saat Anda mengirim, dan pesan kesalahan menyebutkan nama variabel tersebut.

Tulis konten langsung di kanvas di bawah baris subjek, atau pilih Choose a template untuk memulai dari template yang sudah ada. Opsi ini hanya tersedia selama broadcast masih kosong, karena memilih template setelah Anda menulis subjek atau isi akan menimpanya. Broadcast mengirim versi template yang sudah dipublikasikan, jadi template yang hanya memiliki draf tidak dapat digunakan untuk pengiriman.

Template yang memiliki lebih dari satu bahasa mengirimkan salah satunya ke seluruh audience. Tentukan bahasa tersebut sebagai template.language saat Anda membuat atau memperbarui broadcast, dan kosongkan untuk mengirim bahasa default template. Mengubah bahasa saja tidak mengubah versi yang sudah dikunci oleh broadcast, setelah broadcast memilikinya. Broadcast dikunci ke suatu versi saat disiapkan untuk pengiriman, jadi broadcast terjadwal mengirim versi yang dipublikasikan pada saat itu, terlepas dari apakah Anda mengubah bahasanya sebelumnya.

Pengiriman adalah tindakan terpisah dan eksplisit, tersedia dari tombol Review di composer atau dari halaman detail broadcast melalui Send or reschedule. Keduanya membuka dialog yang memeriksa kelengkapan broadcast, memperingatkan Anda tentang hal yang kemungkinan membuat pengiriman gagal, lalu memungkinkan Anda memilih Send now atau memilih waktu hingga satu tahun ke depan. Broadcast terjadwal tetap dapat diedit, dan Anda dapat menjadwalkan ulang hingga pengiriman benar-benar dimulai.

Pengiriman memeriksa apakah audience masih memiliki penerima yang dapat dijangkau. Audience yang tidak ada satu pun kontaknya memiliki alamat email, atau semua alamatnya disupresi, ditolak pada saat itu alih-alih gagal kemudian.

Dua batas tingkat organisasi diperiksa saat Anda mengirim.

Yang pertama adalah berapa banyak broadcast yang dapat Anda kirim dalam satu periode penagihan. Paket Anda menentukan jumlahnya. Draf yang tersimpan tidak dihitung, dan membatalkan broadcast tidak mengembalikan jatah tersebut. Setelah jatah habis, Anda menunggu periode penagihan berikutnya atau beralih ke paket dengan batas lebih tinggi.

Yang kedua membatasi broadcast bersamaan. Jika Anda memilih Send now saat batas tercapai, permintaan ditolak. Broadcast terjadwal menunggu slot kosong.

Cari daftar berdasarkan tag atau nama template, atau filter berdasarkan status, audience, atau rentang tanggal. Rentang tanggal memfilter berdasarkan kapan broadcast dibuat, bukan kapan dikirim, jadi broadcast yang Anda jadwalkan minggu lalu untuk dikirim bulan depan tetap muncul di bawah "Last 7 days."

Ekspor tampilan saat ini sebagai CSV dari tombol di atas tabel, atau panggil Ekspor broadcast sebagai CSV, yang menerima filter yang sama. Di atas 50.000 baris, ekspor ditolak alih-alih dipotong diam-diam. Persempit filter dan coba lagi.

Broadcast selalu berada di salah satu dari empat tahap, dan filter Status pada daftar menggunakan keempat tahap tersebut:

Badge di setiap baris menunjukkan status tepat dalam tahapnya. Nilai yang sama itulah yang dikembalikan oleh field status pada API.

Batalkan broadcast terjadwal atau yang sedang dikirim dari halaman detailnya, dengan bird email broadcasts cancel, atau dengan Batalkan broadcast dan method SDK broadcasts.cancel. Penerima yang belum dijangkau dilewati, dan pesan yang sudah dalam perjalanan tidak dapat ditarik kembali. Hapus hanya berlaku untuk draf dan bersifat permanen, melalui tiga jalur yang sama: halaman detail, bird email broadcasts delete, atau Hapus broadcast.

Broadcast yang gagal menampilkan alasannya di halaman detail: reason, lalu kalimat yang menyebutkan penyebab pastinya. Melalui API, keduanya adalah field failure_reason dan failure_detail. failure_detail yang memberi tahu Anda penyebab spesifik dari beberapa kemungkinan penyebab dalam satu reason.

Konfigurasi pengiriman broadcast diperiksa hanya saat pengiriman dimulai. Jika domain pengirim sudah diverifikasi saat penjadwalan tetapi kehilangan verifikasi sebelum pengiriman, broadcast gagal pada saat itu. Verifikasi domain tersebut dan kirim broadcast lagi.

Broadcast dan single send menggunakan jatah email yang sama. Kartu paket di ringkasan penagihan organisasi Anda menunjukkan berapa banyak yang sudah terpakai. Paket dan harga menjelaskan apa saja yang termasuk di setiap paket.

Setelah pengiriman dimulai, tab Overview broadcast menampilkan jumlah penerima dan jumlah terkirim, lalu rasio dan jumlah pengiriman, buka, klik, bounce, dan keluhan. Tab Recipients mencantumkan setiap penerima beserta status pengirimannya, alasan jika tidak terkirim, waktu pengiriman, serta buka dan kliknya. Kotak pencarian tab ini memerlukan alamat email yang lengkap dan valid; alamat parsial atau domain saja gagal validasi, menandai kotak sebagai tidak valid, dan membiarkan tabel menampilkan apa pun yang ditampilkan sebelumnya. Tombol di atas tabel mengekspor tab sebagai CSV, dan Ekspor penerima broadcast sebagai CSV mengembalikan file yang sama ke key API; keduanya dibatasi 500.000 baris dengan perilaku tolak-bukan-potong yang sama seperti ekspor daftar broadcast. Tab Events adalah feed event mentah broadcast, menggunakan jenis event yang dijelaskan di event dan webhook.

Masukkan alamat sandbox ke dalam audience dan kontak tersebut disimulasikan alih-alih benar-benar dikirim: delivered@messagebird.dev melaporkan terkirim, bounce@messagebird.dev bounce, dan masing-masing menghasilkan event dan webhook yang sama seperti penerima sesungguhnya. Ini cara Anda menguji kampanye, dan handler yang membaca event-nya, tanpa mengirim email ke siapa pun. Audience dapat mencampur kontak sandbox dan kontak nyata; setiap kontak mendapatkan hasilnya sendiri. Penerima simulasi tetap dihitung terhadap jatah pengiriman Anda, jadi uji coba menggunakan kuota yang sama dengan pengiriman sesungguhnya.