Kesalahan pengiriman SMS
SMS yang gagal memiliki status pengiriman dan kesalahan yang menjelaskan hasilnya. Gunakan referensi ini untuk memahami alasan kegagalan dan kode numerik penyedia yang dilaporkan bersama pesan.
Kesalahan permintaan seperti payload pengiriman yang tidak valid menggunakan katalog kesalahan API. Kode di halaman ini menjelaskan pesan yang telah diterima lalu gagal atau ditolak.
Membaca kesalahan
Buka pesan di log SMS dan pilih Details. Error menampilkan deskripsi dan alasan kegagalan yang dinormalisasi. Carrier error code menampilkan kode numerik penyedia jika tersedia.
Melalui API, baca GET /v1/sms/messages/{message_id}. last_error berisi:
| Field | Arti |
|---|---|
code | Alasan kegagalan yang dinormalisasi oleh Bird, seperti unreachable atau unknown |
description | Penjelasan yang dilaporkan dalam kata-kata |
carrier_error_code | Kode mentah dari penyedia, jika tersedia |
occurred_at | Waktu terjadinya kegagalan |
Event webhook kegagalan dan event timeline pesan memuat field yang sama di error.
Nama field carrier_error_code juga mencakup kode yang diterbitkan oleh penyedia pengiriman Bird, termasuk pemblokiran perlindungan penipuan. Kode yang kosong berarti penyedia tidak memberikan kode atau pesan ditolak sebelum pengiriman.
Alasan kegagalan yang dinormalisasi
Berikut adalah alasan kegagalan yang didefinisikan oleh API pesan. Tanda terima dari penyedia dapat memuat kode numerik yang lebih spesifik daripada yang tercermin dalam alasan yang dinormalisasi. Misalnya, pesan dengan code: unknown tetap dapat membawa carrier_error_code yang dikenali.
| Alasan | Arti |
|---|---|
invalid_destination | Nomor tidak terdaftar atau tidak valid |
unreachable | Perangkat mati atau di luar jangkauan |
blocked_by_carrier | Operator penerima memfilter pesan |
blocked_by_fraud_protection | Perlindungan penipuan Bird memblokir dugaan pumping SMS |
blocked_by_recipient | Perangkat penerima memblokir pengirim |
landline_unreachable | Telepon tetap tidak menerima SMS |
content_rejected | Operator menolak konten |
sender_unregistered | Pengirim tidak memiliki registrasi yang diperlukan |
recipient_opted_out | Penerima ada di daftar supresi |
provider_unavailable | Penyedia atau jaringan tidak tersedia |
insufficient_balance | Saldo workspace tidak mencukupi untuk pengiriman |
unknown | Kegagalan tidak dapat diklasifikasikan |
Ini adalah kumpulan terbuka: terima nilai yang belum dikenal dan simpan deskripsi serta kode mentah untuk investigasi. Penyebab sementara tetap mengakhiri percobaan pengiriman pesan ini; hal itu tidak menjamin pengiriman ulang otomatis.
Kode kesalahan provider
Cari string numerik yang dikembalikan di carrier_error_code. Kode-kode ini milik provider pengiriman SMS Bird; provider lain mungkin memberikan arti berbeda untuk nomor yang sama.
| Kode | Arti |
|---|---|
0 | Tidak ada kesalahan |
1 | Pelanggan tidak dikenal |
2 | Base station tidak dikenal |
3 | Mobile switch tidak dikenal |
5 | Pelanggan tidak teridentifikasi |
7 | Perangkat tidak dapat terhubung |
8 | Roaming dilarang |
9 | Autentikasi pelanggan gagal |
10 | Bearer SMS tidak disediakan |
11 | Layanan SMS tidak disediakan |
12 | Perangkat masuk daftar hitam |
13 | Layanan SMS diblokir |
21 | SMS tidak didukung |
26 | Handover jaringan gagal |
27 | Pelanggan tidak tersedia |
28 | Di luar jangkauan |
29 | Perangkat dimatikan |
30 | Kegagalan mobile switch |
31 | Pelanggan sibuk |
32 | Kegagalan pengiriman SMS |
33 | Penyimpanan pesan tertunda penuh |
34 | Kegagalan sistem jaringan |
35 | Data yang diperlukan tidak ada |
36 | Nilai field pesan tidak sesuai |
39 | Nomor routing roaming tidak tersedia |
40 | Memori jaringan habis |
71 | Alfabet tidak didukung |
72 | USSD sibuk |
100 | Saldo pengiriman tidak mencukupi |
101 | Saldo pelanggan tidak mencukupi |
103 | Pelanggan telah berhenti berlangganan |
104 | Pengirim tidak terdaftar |
105 | Konten tidak terdaftar |
106 | Volume kampanye terlampaui |
107 | Throughput kampanye terlampaui |
110 | Operator memfilter pesan |
130 | SurgeGuard mendeteksi traffic pumping |
131 | SurgeGuard memblokir tujuan yang dicurigai pumping |
Kode 0 dihilangkan dari carrier_error_code pada pembacaan pesan dan event Bird. Kode yang tidak dikenal sebaiknya tetap tersedia di catatan Anda saat menghubungi dukungan.
Pemblokiran perlindungan penipuan
SurgeGuard adalah perlindungan penipuan SMS dari Bird.
Pesan yang diblokir oleh perlindungan penipuan memiliki alasan kegagalan blocked_by_fraud_protection dan deskripsi "Blocked by fraud protection: suspected SMS pumping." Status pengiriman tetap failed, rejected, atau expired, sesuai laporan penyedia. Alasan dan deskripsi yang sama muncul di detail pesan, event timeline, dan webhook kegagalan. Kode mentah penyedia tetap tersedia di carrier_error_code jika disertakan.
Di log SMS, filter Failure reason dengan Blocked by fraud protection untuk menemukan pesan-pesan ini.
Catatan lama mungkin masih menampilkan unknown dan generic_delivery_failure. Label ini saja tidak mengidentifikasi pemblokiran oleh perlindungan penipuan. Cari carrier_error_code di Kode kesalahan penyedia untuk mengidentifikasi penyebabnya. Jika kode tidak ada atau tidak dikenal, hubungi dukungan dengan workspace ID, message ID, timestamp, dan kode penyedia jika disertakan.
Saat menyelidiki OTP yang diblokir, korelasikan SMS dengan akun atau permintaan verifikasi yang memicunya. Hindari pengiriman ulang otomatis atau pengalihan rute untuk melewati pemblokiran. Jika Anda menduga permintaan yang sah diblokir, hubungi dukungan dengan workspace ID, message ID, timestamp, dan kode penyedia.
Langkah selanjutnya
- Log SMS: periksa pesan dan riwayat pengirimannya.
- Event SMS: konsumsi webhook pengiriman dan kegagalan.
- Metrik SMS: tinjau hasil kegagalan agregat.
- Kesalahan SMS API: interpretasikan kesalahan yang dikembalikan oleh permintaan API.
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.