Catatan dan status pengiriman
Cari status pesan dan kampanye, serta bedakan penerimaan, pengiriman kanal, pengiriman akhir, dan kegagalan umum.
Catatan pengiriman membedakan penerimaan platform, pengiriman ke kanal, dan pengiriman akhir. Sebelum menelusuri masalah, simpan Message ID, Request ID/Trace ID, dan nomor batch yang dikembalikan API.
Mencari catatan pengiriman
Buka Catatan Pengiriman. Rentang default adalah 7 hari terakhir, dan setiap kueri dapat mencakup maksimal 7 hari. Anda dapat memfilter berdasarkan:
- Email penerima persis;
- Message ID lengkap;
- Subjek;
- Status dan kategori;
- Waktu mulai dan selesai kustom.
Detail mencakup Request ID, nomor batch, jumlah percobaan ulang, template ID, waktu event penting, dan snapshot konten yang tersedia. Gambar dan tautan eksternal dinonaktifkan dalam pratinjau konten, sehingga pratinjau tidak menghasilkan event buka atau klik.
Status pesan
| Status | Arti |
|---|---|
| Menunggu | Pesan berada dalam antrean untuk diproses berikutnya. |
| Diproses | Pemrosesan atau konfirmasi hasil masih berlangsung. |
| Submitted / Accepted | Layanan pengiriman atau kanal menerima pesan; ini bukan pengiriman akhir. |
| Delivered | Server email penerima menerima pesan. Penempatan kotak masuk dan pembacaan tidak dijamin. |
| Bounced | Tanda terima bounce diterima; gunakan alasan aman dalam detail untuk penelusuran. |
| Complained | Penerima melaporkan pesan sebagai spam; tinjau persetujuan dan konten. |
| Ditolak | Kebijakan platform atau kanal menolak pesan, misalnya template tidak tersedia atau semua penerima disupresi. |
| Gagal | Kegagalan pasti terjadi selama perakitan konten, konfigurasi kanal, autentikasi, atau pemrosesan lainnya. |
| Tidak diketahui | Informasi belum cukup untuk menentukan status pasti. |
HTTP 202 hanya berlaku untuk penerimaan. Pesan yang diterima kemudian dapat ditolak, gagal, atau bounce. Jangan menggunakan keberhasilan HTTP sebagai pengganti catatan pengiriman.
Linimasa event
Linimasa menampilkan titik penting yang tercatat seperti pemrosesan, pengajuan, penerimaan kanal, tanda terima penyedia, pengiriman, bounce, penolakan, dan kegagalan. Buka dan klik hanya menampilkan kejadian pertama, bukan setiap tindakan.
Event buka dan klik bergantung pada dukungan serta konfigurasi pelacakan kanal. Pemuatan awal untuk privasi dapat meningkatkan angka pembukaan, sedangkan gambar jarak jauh yang diblokir dapat menyembunyikan pembukaan sebenarnya. Rasio buka bukan jumlah pembaca yang tepat.
Alasan kegagalan
Detail pelanggan menampilkan kosakata alasan tetap yang aman, bukan teks penyedia mentah atau diagnostik internal:
| Alasan | Yang perlu diperiksa |
|---|---|
invalid_recipient | Sintaks alamat dan penerima valid. |
suppressed | Catatan berhenti berlangganan atau supresi; jangan mencoba ulang untuk menghindari supresi. |
template_error | Review template, status aktif, versi, dan variabel. |
rate_limited | Laju pengiriman serta jendela atau kuota harian API Key. |
rejected | Identitas pengirim, template, tipe pesan, supresi, dan penolakan kanal. |
send_failed | Simpan Message ID dan hubungi dukungan tentang konten, konfigurasi kanal, atau autentikasi. |
delivery_failed | Terjadi bounce; tinjau alamat, konten, reputasi domain, dan kebijakan penerima. |
complained | Persetujuan audiens, penanganan berhenti berlangganan, dan akar penyebab keluhan. |
marketing_wait_expired | Kondisi tunggu pengiriman pemasaran kedaluwarsa; hubungi platform tentang kampanye dan kebijakan pengiriman. |
unknown | Tidak ada alasan aman yang lebih spesifik; berikan Message ID kepada platform. |
Status dan statistik kampanye
Status kampanye berbeda dari status setiap pesan:
| Status kampanye | Arti |
|---|---|
| Draf | Belum diajukan untuk review. |
| Menunggu review | Diajukan dan menunggu persetujuan platform. |
| Terjadwal | Jadwal tersedia tetapi distribusi belum terjadi atau persetujuan masih menunggu. |
| Mengirim | Distribusi sedang berlangsung dan tidak dapat ditarik kembali. |
| Distribusi selesai | Alur distribusi berakhir; tidak semua penerima selalu terkirim. |
| Dibatalkan | Rencana kampanye yang belum dijalankan dihentikan. |
| Gagal | Pemrosesan kampanye gagal; periksa detail dan baris penerima. |
“Dispatched” menghitung pesan yang memasuki alur pengiriman. Jumlah delivered, opened, clicked, dan bounced berasal dari hasil berikutnya. Segarkan statistik, filter penerima, dan coba ulang hanya penerima yang saat ini gagal dari halaman detail. Penerimaan percobaan ulang juga memerlukan pemeriksaan hasil berikutnya.
Informasi untuk penelusuran masalah
Berikan Message ID, Request ID/Trace ID, nomor batch, waktu kejadian, alamat pengirim, dan status saat ini. Simpan kunci idempotensi untuk tugas batch. Jangan pernah memberikan API Secret, materi tanda tangan lengkap, atau kredensial sebenarnya.
Lihat Webhook event untuk field event mentah, kode alasan send_failed, dan verifikasi tanda tangan.
Pertanyaan umum
Apakah status terkirim berarti masuk kotak masuk?
Tidak. Terkirim berarti server penerima menerimanya; penempatan kotak masuk bergantung pada sistem penerima.
Sumber terkait
Terakhir diperbarui pada