Webhook handler memerlukan pengujian untuk pengiriman gagal maupun berhasil. Pengujian yang berhenti di respons pengiriman tidak dapat mengonfirmasi bagaimana aplikasi Anda menangani event selanjutnya.
Magic destination memungkinkan Anda menguji hasil tersebut tanpa menjangkau inbox atau perangkat nyata. Validasi permintaan tetap berlaku, sehingga pengiriman yang salah format juga terdeteksi.
Bagaimana cara mengirim permintaan pengujian?
Kirim ke magic destination yang dikenali menggunakan kredensial dan endpoint API normal Anda.
Tidak ada mode pengujian yang perlu diaktifkan. Untuk email, gunakan alamat yang didokumentasikan di messagebird.dev. Untuk SMS, gunakan salah satu nomor di bawah.
Penerima simulasi mengikuti jalur event dan signed-webhook normal. Mereka tidak menguji pengiriman ke infrastruktur eksternal. Oleh karena itu, mereka tidak dapat memverifikasi penempatan inbox nyata atau rendering perangkat.
Gunakan hanya magic destination yang dikenali jika pengujian tidak boleh menghubungi siapa pun. Satu permintaan dapat mencampur penerima simulasi dan nyata. Penerima nyata dikirim secara normal.
Alamat email mana yang harus saya gunakan?
Gunakan delivered@messagebird.dev untuk menguji penerimaan oleh server penerima. Alamat lain di bawah ini menguji penanganan bounce, complaint, dan rejection.
| Alamat | Hasil |
|---|---|
delivered@messagebird.dev | Server penerima menerima pesan. |
bounce@messagebird.dev atau hardbounce@messagebird.dev | Hard bounce dengan SMTP 550; uji penanganan kegagalan permanen. |
softbounce@messagebird.dev | Soft bounce dengan SMTP 451; uji klasifikasi kegagalan sementara. |
deferred@messagebird.dev atau delay@messagebird.dev | Penundaan tanpa percobaan ulang simulasi berikutnya. |
complaint@messagebird.dev atau spam@messagebird.dev | Complaint spam. |
suppressed@messagebird.dev | Rejection sebagai penerima yang sudah di-suppress, tanpa event pemrosesan atau pengiriman. |
reject@messagebird.dev | Rejection sebelum percobaan pengiriman. |
Pencocokan mengabaikan huruf besar-kecil. +label dihapus sebelum menentukan hasil. Misalnya, bounce+signup-flow@messagebird.dev tetap menghasilkan bounce. Alamat lengkap tetap ada di event sehingga Anda dapat mengaitkannya dengan pengujian tersebut.
Hanya nama yang didokumentasikan pada domain tersebut yang bersifat magic. bounce@yourdomain.com adalah penerima normal, begitu juga nama yang tidak dikenali pada messagebird.dev.
Bounce dan complaint simulasi tidak menambahkan alamat ke daftar suppression Bird atau memengaruhi reputasi pengiriman. Aplikasi Anda tetap menerima event-nya, jadi periksa bagaimana logika suppression Anda sendiri menanganinya.
Uji pengiriman email mencantumkan urutan event lengkap dan aturan pencocokan.
Nomor telepon mana yang harus saya gunakan?
Gunakan +15005550006 untuk menguji pengiriman SMS yang berhasil. Nomor lain di bawah ini menguji jalur rejection dan kegagalan.
| Tujuan | Hasil |
|---|---|
+15005550001 | Rejection pengiriman dengan invalid_destination. |
+15005550002 | sms.sent, lalu sms.undelivered dengan unreachable. |
+15005550003 | sms.sent, lalu sms.failed dengan provider_unavailable. |
+15005550004 | sms.sent, lalu sms.failed dengan blocked_by_carrier. |
+15005550006 | sms.sent, lalu sms.delivered. |
+15005550009 | sms.sent, lalu sms.failed dengan recipient_opted_out. |
Aktifkan United States di bagian Destinations. Gunakan pengirim from yang valid untuk AS. Pengirim alfanumerik ditolak di sana, sehingga tidak dapat menguji nomor-nomor ini dengan berhasil.
Pengiriman ke +15005550006 dapat menguji handler sukses Anda. Gunakan +15005550002 untuk memeriksa jalur undelivered yang terpisah. Panduan migrasi SMS menyertakan urutan smoke-test.
Berapa biaya pengujian atau apa yang berubah?
Pengiriman simulasi menggunakan jatah nyata dan dapat memengaruhi statistik Anda.
SMS ke magic number dikenakan tarif normal tujuan. Batasi pengujian berulang karena setiap pengiriman simulasi dapat menimbulkan biaya.
Penerima email simulasi dihitung terhadap jatah pengiriman Anda. Lalu lintas sandbox email juga masuk ke statistik agregat, termasuk rasio bounce dan complaint. Pisahkan dalam analisis Anda agar kegagalan pengujian tidak terlihat seperti masalah pengiriman pelanggan.
Bagaimana cara mengidentifikasi hasil pengujian?
Cocokkan event dengan penerima pengujian atau identifier pesan yang Anda catat saat mengirim.
Email simulasi yang diterima mengembalikan 202 dan bentuk event normal. Tidak ada flag pengujian di payload. Oleh karena itu, penerimaan saja tidak mengidentifikasi suatu pengujian.
Gunakan label penerima seperti bounce+signup-flow@messagebird.dev untuk mengaitkan event email dengan suatu pengujian. Anda juga dapat membaca timeline atau event API pesan email tanpa mengoperasikan webhook receiver.
Pisahkan pemeriksaan pengiriman nyata jika Anda perlu memverifikasi rendering atau penerimaan. Magic destination tidak menguji bagian tersebut dari jalur pengiriman.
Singkatnya
Tujuan menentukan hasil pengujian.
Gunakan kunci dan endpoint API normal Anda. Alamat dan nomor yang dikenali memicu hasil pengiriman simulasi.
Batasi pengujian ke magic destination yang diketahui.
Satu permintaan dapat mencampur penerima simulasi dan nyata. Alamat yang tidak dikenali diperlakukan sebagai penerima normal.
Pengujian tetap menggunakan jatah nyata.
Penerima email simulasi menggunakan jatah pengiriman. Magic number SMS dikenakan tarif normal tujuan.
Catat pesan mana yang termasuk pengujian.
Event tidak memiliki flag pengujian. Label email tetap ada di alamat penerima, sehingga Anda dapat mengidentifikasi pengujian tertentu dari event-nya.