Topik ini menjelaskan cara menyiapkan notifikasi asinkron. Fitur ini hanya tersedia untuk pengguna yang sudah ada. Pengguna baru disarankan menggunakan fitur "Publikasi Event". Untuk informasi lebih lanjut, lihat Setel Publikasi Event.
Setelah mengirim permintaan email melalui server DirectMail, hasil pengiriman akan dikirim ke terminal penerima (HTTP, antrian pesan, atau subjek) sesuai dengan aturan notifikasi event yang Anda tetapkan di Message Service. Hasil pengiriman dapat diperoleh secara asinkron melalui terminal penerima Message Service.
Untuk menyiapkan notifikasi asinkron, aktifkan terlebih dahulu Message Service. Layanan ini mungkin dikenakan biaya tambahan.
Untuk menyetel notifikasi asinkron, buat aturan notifikasi event di Konsol Manajemen Message Service dan konfigurasikan notifikasi asinkron di Konsol DirectMail. Pastikan Anda telah mengaktifkan Message Service, yang mungkin memerlukan biaya.
Gunakan akun utama Alibaba Cloud untuk menyiapkan notifikasi asinkron. Message Service saat ini tidak mendukung RAM.
Buat Aturan Notifikasi Event
Sebelum membuat aturan notifikasi, disarankan untuk membuat antrian penerimaan pesan sebagai terminal penerima.
Buat Antrian Penerimaan Pesan
Masuk ke Konsol Layanan Pesan.
Di panel navigasi sisi kiri, klik Antrian.
Klik tombol Buat Antrian di halaman, lalu kotak dialog akan muncul.
Isi nama antrian, gunakan nilai default untuk bidang lainnya, dan klik OK.
Buat Aturan Notifikasi Event
1. Di panel navigasi sisi kiri Konsol Message Service, klik Notifikasi Event.
2. Klik tombol Create Rule di halaman tersebut, maka sebuah kotak dialog akan muncul.
3. Periksa wilayah dan nama produk, isi nama aturan, pilih tipe event, tambahkan terminal penerima, dan klik OK. Sistem mendukung dua jenis terminal penerima: HTTP dan Antrian. Anda dapat memilih antrian penerimaan pesan yang telah dibuat sebagai terminal penerima.
Catatan: Umumnya dibutuhkan hingga 10 menit agar aturan baru mulai berlaku.
Silakan periksa referensi "Tipe Event" di bawah ini.
Buat Notifikasi Asinkron
Notifikasi asinkron mencakup tingkat akun dan tingkat alamat email. Untuk menerapkan notifikasi asinkron tentang hasil pengiriman untuk semua alamat pengirim, setel notifikasi tingkat akun. Untuk alamat email tertentu, setel notifikasi tingkat alamat email. Keduanya dapat diatur bersamaan, dengan prioritas lebih tinggi pada tingkat alamat email. Alamat pengirim tertentu akan menerima notifikasi tingkat alamat email, sedangkan alamat lainnya menerima notifikasi tingkat akun. Ini memungkinkan pengiriman notifikasi ke terminal penerima yang berbeda.
Buat Notifikasi Asinkron Tingkat Akun
1. Masuk ke Konsol DirectMail.
2. Di panel navigasi sisi kiri, klik Notifikasi Asinkron.
3. Klik tombol Notifikasi Asinkron Tingkat Akun Baru di halaman.
4. Pilih wilayah dan klik OK.
Buat Notifikasi Asinkron Tingkat Alamat Email
1. Klik Notifikasi Asinkron Tingkat Alamat Email di halaman Notifikasi Asinkron.
2. Klik tombol Notifikasi Asinkron Tingkat Alamat Baru di halaman.
3. Pilih alamat pengirim dan wilayah, lalu klik OK.
Konsol Message Service menerima pesan antrian dan memverifikasi bahwa tautan tersebut valid.
Setelah mengirim permintaan email melalui server DirectMail:
1. Masuk ke Konsol Message Service.
2. Di panel navigasi sisi kiri, klik Antrian.
3. Pilih wilayah untuk melihat pesan aktif di antrian yang telah dibuat sebelumnya.
4. Klik Kirim Pesan untuk melihat notifikasi event spesifik yang didorong ke antrian.
Tipe Event dan Metode Aktivasi
Tipe event saat ini mendukung kategori berikut:
Deliver:SendSuccessfully
Deliver:SendFailed
Deliver:Open
Deliver:Click
Bagaimana cara mengaktifkan statistik pada Deliver:SendSuccessfully dan Deliver:SendFailed?
Secara default, informasi pengiriman akan dikumpulkan.
Bagaimana cara mengaktifkan statistik pada Deliver:Open dan Deliver:Click?
Lihat Bagaimana Saya Mengaktifkan Fitur Pelacakan Data?.
Struktur Pesan Pengiriman Sukses dan Gagal
Contoh Pengiriman Sukses
X-Notify-Message-ID=3121639760461820&env_id=12769055421&msg_id=37483d95-7a08-41fb-9738-3d3ffa24d415@example.com&account=example@example.com&from=example@example.com&rcpt=example1@example.com&recv_time=2017-03-29 14:22:40&end_time=2017-03-29 14:22:43&status=0&event=deliver®ion=cn-hangzhou&err_code=250&err_msg=250 Send Mail OK&failed_type=SendOk
Contoh Pengiriman Gagal
X-Notify-Message-ID=3121639760461824&env_id=12625010655&msg_id=ac349efc-0d79-489b-affa-f178dce3e49e@example.com&account=example@example.com&from=example@example.com&rcpt=example1@example.com&recv_time=2017-03-28 19:09:49&end_time=2017-03-28 19:09:51&status=4&event=deliver®ion=cn-hangzhou&err_code=524&err_msg=524 Host not found by dns resolve [@ou070302]&failed_type=SysOutDnsResolveFail
Bagaimana Cara Menyelesaikan?
Gunakan "&" untuk memisahkan key-val dan "=" untuk memisahkan key dan val. Definisi key merujuk pada Daftar Nilai.
Bagaimana Membedakan Pesan Sukses dan Gagal?
Err_code 250 menunjukkan pengiriman berhasil. Kode balasan lainnya menunjukkan pengiriman gagal.
Daftar Nilai
Nama | Deskripsi |
X-Notify-Message-ID | Set Header Kustom X-Notify-Message-ID |
env_id | ID internal sistem (digunakan untuk umpan balik pertanyaan). |
msg_id | Bidang Message-ID dari teks email. |
account | Alamat pengirim. |
from | Alamat pengirim. |
rcpt | Alamat penerima. |
recv_time | Waktu ketika email diterima di antrian. |
end_time | Waktu ketika pengiriman email selesai. |
status | Hasil pengiriman (0-sukses, 2-alamat tidak valid, 3-email spam di sisi penerima, 4-gagal). |
event | Tipe event; deliver menunjukkan event pengiriman. |
region | Wilayah tempat event terjadi. |
err_code | Kode balasan ESP dari sisi penerima setelah pengiriman selesai. |
err_msg | Informasi balasan ESP dari sisi penerima setelah pengiriman selesai. |
Definisi failed_type umum:
Nilai | Definisi dan Saran |
SendOk | Pengiriman sukses |
SysOutDnsResolveFail | Resolusi DNS domain penerima gagal, biasanya karena domain tidak valid. Harap hapus domain dari daftar penerima Anda. |
SmtpMfFreq | Akun pengirim berada di bawah kontrol aliran. Harap kurangi frekuensi pengiriman Anda. |
SmtpContSpam | Konten dinilai sebagai spam oleh penerima. Harap optimalkan konten email Anda atau hentikan pengiriman email dengan template ini kepada penerima. |
SmtpAuthFail | Verifikasi SPF atau DKIM atau DMARC gagal. Harap selesaikan catatan SPF yang benar, periksa apakah ada catatan DMARC yang dikonfigurasi, dan uji apakah DKIM benar. |
SmtpNxBox | Alamat tidak valid, ditambahkan ke pustaka alamat tidak valid tingkat akun. |
SysOutInvRcpt | Mengenai pustaka alamat tidak valid global. Jika Anda yakin bahwa alamat tersebut valid, Anda dapat melaporkannya kepada kami atau memilih untuk tidak mengaktifkan pustaka alamat tidak valid tingkat global. |
SmtpRcptFreq | Kontrol kelelahan sistem penerima email. Harap hentikan sementara pengiriman email ke penerima saat ini. |
SmtpSslTlsErr | Kesalahan sementara. Koneksi SSL/TLS gagal karena gangguan jaringan atau ketidaktersediaan peer. Silakan coba lagi. |
SmtpTempErr | Kesalahan sementara. Silakan coba lagi. |
SmtpZPermErr | Kesalahan permanen. Jangan coba lagi. Tentukan penyebab kesalahan berdasarkan pesan yang dikembalikan oleh penerima. |
SysOutSocksConnError | Ada terlalu banyak kesalahan koneksi, kemungkinan penyebabnya adalah peer menolak tautan atau catatan MX dari nama domain yang diterima salah. |
SmtpFullBox | Kotak surat penerima penuh. Harap hentikan pengiriman email ke penerima. |
SmtpIPFreq | Sistem penerima mengontrol aliran IP masuk. Harap kurangi kecepatan pengiriman dan coba lagi nanti. |
SysOutSocksError | Ada terlalu banyak kesalahan koneksi, kemungkinan penyebabnya adalah peer menolak tautan atau catatan MX dari nama domain yang diterima salah. |
SysOutConnError | Ada terlalu banyak kesalahan koneksi, kemungkinan penyebabnya adalah peer menolak tautan atau catatan MX dari nama domain yang diterima salah. |
SysOutConnTooMuch | Ada terlalu banyak kesalahan koneksi, kemungkinan penyebabnya adalah peer menolak tautan atau catatan MX dari nama domain yang diterima salah. |
UnkSmtpError | Kesalahan tidak dikenal, silakan periksa pengaturan pengiriman dan alamat penerima sesuai dengan pesan kesalahan, dan pastikan tidak ada kesalahan sebelum mencoba mengirim lagi nanti. |
SmtpMfdFreq | Nama domain pengirim dikontrol aliran. Kurangi frekuensi email Anda |
SmtpMiscSpam | Konten dinilai sebagai spam oleh penerima. Optimalkan konten email Anda. |
SmtpMfBad | Pengirim dimasukkan dalam daftar hitam oleh sistem penerima, harap hentikan pengiriman email ke pihak lain, atau hubungi sistem penerima untuk menghapus daftar hitam |
SmtpSpfFail | Verifikasi SPF gagal. Pls selesaikan catatan SPF yang benar. |
SmtpMfLimit | Jumlah email yang dikirim oleh pengirim selama satu hari penuh melebihi batas domain penerima. Silakan coba lagi keesokan harinya. |
SmtpDmaFail | Domain dikonfigurasikan dengan DMARC, verifikasi SPF atau DKIM gagal. Harap selesaikan catatan SPF yang benar dan uji apakah DKIM benar. |
SmtpProtErr | Interaksi protokol peer salah, Anda dapat melaporkan ke troubleshooting Alibaba Cloud. |
SysOutRecipientReportedSpam | Penerima telah melaporkan alamat pengirim atau domain Anda. Harap hentikan pengiriman email ke penerima/domain tersebut. |
SysOutHoneypot | Penerima adalah alamat honeypot. Harap hentikan pengiriman email ke alamat ini, jika tidak Anda akan dihukum oleh organisasi anti-spam. |
SysOutRecipientUnsubscribed | Penerima telah berhenti berlangganan dari alamat pengirim atau domain Anda. Harap hentikan pengiriman email ke penerima/domain tersebut. |
SysIncomingInvRcpt | Mengenai pustaka alamat tidak valid global. Jika Anda yakin bahwa alamat tersebut valid, Anda dapat melaporkannya kepada kami atau memilih untuk tidak mengaktifkan pustaka alamat tidak valid tingkat global. |
SysOutRcptOnAccountLevelBounceList | Mengenai daftar pantulan tingkat akun. Jika Anda yakin bahwa alamat tersebut valid, Anda dapat menghapusnya di halaman daftar alamat tidak valid, atau memilih untuk tidak mengaktifkan daftar alamat tidak valid tingkat akun. |
SmtpDbl | Mengenai daftar hitam domain Spamhaus. Harap hentikan sementara pengiriman email dan pergi ke check.spamhaus.org untuk mengajukan delisting. Setelah delisting, harap perhatikan kualitas email Anda dan jangan kirim email ke pengguna yang telah berhenti berlangganan. |
Struktur Pesan Event Pembukaan
Contoh
event=Open®ion=cn-hangzhou&env_id=270016664318&msg_id=1688486074.7.1673022065730@example.com&from=example@example.com&rcpt=example@example.com&operate_time=2023-01-07 01:43:51
Daftar Nilai
Nama | Deskripsi |
event | Tipe event |
region | Wilayah tempat event terjadi |
env_id | ID internal sistem (digunakan untuk umpan balik pertanyaan) |
msgid | Bidang Message-ID dari teks email |
from | Alamat pengirim |
rcpt | Alamat penerima |
operate_time | Waktu operasi event |
Struktur Pesan Event Klik
Contoh
event=Click®ion=cn-hangzhou&env_id=17870283365788973187&msg_id=02785cb2-71b1-4fb5-bdbb-a49dfbe3326f@example.com&from=example@example.com&
rcpt=example@example.com&operate_time=2023-01-12 09:54:09&url=httpsxxx
Daftar Nilai
Nama | Deskripsi |
event | Tipe event |
region | Wilayah tempat event terjadi |
env_id | ID internal sistem (digunakan untuk umpan balik pertanyaan) |
msgid | Bidang Message-ID dari teks email |
from | Alamat pengirim |
rcpt | Alamat penerima |
operate_time | Waktu operasi event |
url | URL dari klik |