Topik ini membantu Anda mengidentifikasi, mendiagnosis, dan menyelesaikan kesalahan pada Alibaba Cloud Short Message Service (SMS) secara cepat. Dokumen ini mencakup kode kesalahan sepanjang siklus hidup pesan, mulai dari panggilan API dan pengiriman pesan hingga tanda terima pengiriman, serta menyediakan solusi yang dapat ditindaklanjuti.
Klasifikasi kode kesalahan
Dokumen ini cukup panjang. Anda dapat menggunakan Ctrl+F (atau Command+F) untuk mencari kode kesalahan tertentu.
Untuk mengidentifikasi masalah secara akurat, Anda perlu memahami berbagai jenis kode kesalahan yang muncul selama siklus hidup pesan.
Kode kesalahan umum: Dikembalikan dalam respons HTTP saat Anda memanggil API, seperti
SendMessageToGlobe. Kode-kode ini menunjukkan adanya masalah pada permintaan itu sendiri—misalnya, parameter tidak valid atau izin tidak mencukupi—atau bahwa platform menolak permintaan tersebut.Kode status tanda terima pengiriman: Dikembalikan setelah platform menerima pesan, baik melalui callback asinkron maupun dengan memanggil API
SmsReport. Kode-kode ini mencerminkan hasil akhir pengiriman dari penyedia layanan ke perangkat penerima, seperti berhasil, gagal, atau diblokir.Kode kesalahan SMPP dan status pesan: Hanya tersedia jika Anda menggunakan protokol Short Message Peer-to-Peer (SMPP). Kode-kode ini menunjukkan hasil perintah SMPP atau status akhir pesan, sesuai dengan Spesifikasi Protokol SMPP V3.4.
Kode kesalahan umum
Kode kesalahan | Kode kesalahan SMPP | Deskripsi | Solusi |
OK | 20 | Permintaan berhasil. | - |
INVALID_SENDERID | 25 | Sender ID tidak valid atau belum disetujui. |
|
FORBIDDEN_ACTION | 26 | Izin panggilan API akun Anda telah diturunkan. | Kirim tiket untuk memulihkan akses panggilan API. |
OUT_OF_SERVICE | 27 | Layanan SMS dihentikan sementara. | - |
ACCOUNT_NOT_EXISTS | 29 | Akun tidak ada. | Aktifkan SMS dan lengkapi verifikasi identitas. |
SMS_CONTENT_CODE_ILLEGAL | 31 | Templat pesan tidak valid, tidak ada, atau telah ditolak. | Masuk ke SMS Console. Di panel navigasi kiri, pilih . Periksa status persetujuan. Jika statusnya Rejected, klik Create Template. |
SMS_SIGN_NAME_ILLEGAL | 32 | Signature tidak valid, tidak ada, atau telah ditolak. | Masuk ke SMS console. Di panel navigasi kiri, pilih . Periksa apakah signature yang dikirimkan persis sama dengan yang telah disetujui. Jika statusnya Rejected, tinjau alasan penolakan dan ajukan signature baru. |
MOBILE_NUMBER_ILLEGAL | 33 | Format nomor telepon seluler salah. | Verifikasi format nomor telepon dan kirim ulang permintaan. |
MOBILE_COUNT_OVER_LIMIT | 34 | Jumlah nomor telepon seluler melebihi batas 1.000. | Operasi BatchSendMessageToGlobe mendukung maksimal 1.000 penerima per permintaan. Bagi daftar yang lebih besar menjadi beberapa permintaan. |
CONTENT_MISSING_PARAMETERS | 35 | Nilai variabel dalam templat pesan tidak diberikan. | Periksa parameter |
INVALID_PARAMETERS | 36 | Satu atau beberapa parameter tidak valid. | Periksa konfigurasi parameter Anda untuk memastikan semua nilainya benar. |
INVALID_JSON_PARAM | 42 | Parameter kosong, atau string JSON tidak dapat diurai. | Periksa konfigurasi parameter Anda untuk memastikan semua nilainya benar. |
PARAM_LENGTH_LIMIT | 44 | Panjang nilai variabel templat melebihi batas. |
|
AMOUNT_NOT_ENOUGH | 45 | Saldo atau paket sumber daya akun Anda tidak mencukupi. | Beli paket sumber daya atau isi ulang saldo Anda. |
SYSTEM_ERROR | 46 | Terjadi kesalahan sistem internal. | Terjadi kesalahan sementara pada platform Alibaba Cloud. Coba lagi nanti. Jika masalah berlanjut, kirim tiket dan sertakan RequestId. |
DATA_NOT_EXIST | - | Catatan pesan yang diminta tidak ada. | Coba lagi nanti. |
QPS_LIMIT_CONTROL | 48 | Batas QPS pengiriman pesan telah tercapai. | Kurangi frekuensi panggilan API agar tetap berada di bawah batas QPS akun Anda. |
ONLINE_BILLING_FAILED | 49 | Penagihan online gagal, atau terjadi kesalahan sistem internal. | Sistem penagihan online sedang sibuk. Coba lagi nanti. |
QUERY_DATE_ILLEGAL | 52 | Rentang waktu kueri tidak valid. | Periksa konfigurasi parameter Anda untuk memastikan semua nilainya benar. |
RAM_PERMISSION_DENY | 55 | Verifikasi Resource Access Management (RAM) gagal karena izin tidak mencukupi. | Berikan izin yang diperlukan kepada Pengguna RAM untuk memanggil API, lalu coba lagi. |
PRODUCT_NOT_SUBSCRIBED | 57 | SMS belum diaktifkan. | Masuk ke SMS console dan aktifkan layanan tersebut. |
SMS_SECURITY_INTERCEPTED | 61 | Pesan diblokir oleh kebijakan pengendalian risiko. | - |
SMS_CONTENT_ILLEGAL | 62 | Konten pesan tidak sesuai ketentuan. | Pastikan konten pesan Anda mematuhi semua peraturan dan undang-undang yang berlaku. |
ACCOUNT_ILLEGAL | 63 | Akun Anda masuk dalam blacklist karena mengirim konten yang tidak sesuai ketentuan. | - |
BLACK_KEY_CONTROL_LIMIT | 64 | Variabel dalam konten pesan mengandung kata kunci yang masuk dalam blacklist. | Nilai variabel tersebut memicu kebijakan keamanan platform. Tinjau dan ubah konten sensitif atau tidak sesuai dalam variabel tersebut. |
NOT_SUPPORTED_COUNTRY | 65 | Pengiriman pesan ke negara atau wilayah ini tidak didukung. | - |
SENDERID_BLACKLISTED | 67 | Sender ID diblokir oleh kebijakan pengendalian risiko. | - |
IMDA_COMPANY_REQUIRE_LOA | 68 | Sender ID harus didaftarkan ke Infocomm Media Development Authority (IMDA). | Daftarkan Sender ID Anda ke IMDA. |
SYSTEM_LIMIT_CONTROL | 81 | Batas pengiriman harian sistem telah tercapai. | - |
FREQUENCY_LIMIT_DAY | 83 | Batas pengiriman harian untuk satu nomor telah tercapai. | Di Konsol, buka dan atur ulang batas pengiriman harian untuk satu nomor. Batas default: 20 pesan per hari. |
ALERT_LIMIT_DAY | 84 | Batas pengiriman harian akun Anda telah tercapai. | Di Konsol, buka dan atur ulang batas harian. |
ALERT_LIMIT_MONTH | 85 | Batas pengiriman bulanan akun Anda telah tercapai. | Di Konsol, buka dan atur ulang batas bulanan. |
COUNTRY_TRAFFIC_LIMIT | 86 | Batas pengiriman harian untuk negara atau wilayah tujuan tertentu telah tercapai. | Di Konsol, buka dan atur ulang batas pengiriman harian untuk tujuan tersebut. |
CONTENT_EXCEED_LIMIT | - | Konten pesan melebihi batas ukuran 512 KB. | Kurangi ukuran pesan agar berada di bawah batas 512 KB. |
QUANTITY_INCONSISTENT | - | Jumlah penerima (di bidang | Pastikan jumlah penerima sesuai dengan jumlah pesan. |
Specified AccessKeyId is not found | - | AccessKeyId yang ditentukan tidak ada. | Periksa apakah AccessKeyId yang dikonfigurasi dalam kode Anda benar, valid, dan belum dinonaktifkan. |
Kode status tanda terima pengiriman
Kode status | Kode kesalahan SMPP | Deskripsi |
success | 0 | Pesan berhasil dikirim. |
IN_SMS_CONTENT | 201 | Konten atau panjang pesan tidak valid. |
INVALID_NUM | 202 | Nomor telepon penerima tidak valid. |
INVALID_SENDERID | 203 | Sender ID tidak valid. |
OPERATOR_NOT_SUPPORT | 204 | Penyedia layanan tidak mendukung nomor telepon tersebut. |
PHONE_NOT_AVAILABLE | 205 | Nomor telepon atau perangkat penerima tidak tersedia, atau penyimpanan perangkat penuh. |
PORTED_NUM | 206 | Penyedia layanan untuk nomor telepon tersebut telah berubah. |
RECEIVER_BLACKLIST | 207 | Nomor penerima masuk dalam blacklist penyedia layanan. |
SYSTEM_ERR | 208 | Terjadi kesalahan sistem pada penyedia layanan. |
SP_UNKNOWN_ERR | 209 | Pengiriman pesan gagal karena alasan yang tidak diketahui. |
URL_FAILURE | 210 | URL dalam konten pesan masuk dalam blacklist. |
expired | 211 | Pesan tidak dapat dikirim karena perangkat penerima dimatikan atau berada di luar jangkauan layanan dalam periode yang lama. |
NO_VALID_SUPPLIER | 212 | Tidak tersedia penyedia layanan yang memenuhi persyaratan IMDA untuk Singapura. |
SMPP status pesan
Status pesan SMPP | Status pesan akhir | Deskripsi |
DELIVERED | DELIVRD | Pesan telah dikirim ke tujuan. |
EXPIRED | EXPIRED | Periode validitas pesan telah berakhir. |
DELETED | DELETED | Pesan telah dihapus. |
UNDELIVERABLE | UNDELIV | Pesan tidak dapat dikirim. |
ACCEPTED | ACCEPTD | Pesan berada dalam status diterima. |
UNKNOWN | UNKNOWN | Pesan berada dalam status tidak valid. |
REJECTED | REJECTD | Pesan berada dalam status ditolak. |
Untuk informasi lebih lanjut, lihat SMPP Protocol Specification V3.4.