Topik ini membantu Anda mengidentifikasi, mendiagnosis, dan menyelesaikan kesalahan dengan cepat menggunakan Alibaba Cloud Short Message Service (SMS). Topik ini mencakup kode kesalahan untuk seluruh siklus hidup pesan, mulai dari pemanggilan API dan pengiriman pesan hingga tanda terima pengiriman, serta menyediakan solusi yang dapat ditindaklanjuti.
Klasifikasi kode kesalahan
Dokumen ini sangat luas. Anda dapat menggunakan Ctrl+F (atau Command+F) untuk mencari kode kesalahan tertentu.
Untuk menentukan masalah secara akurat, Anda harus memahami berbagai jenis kode kesalahan yang terjadi selama siklus hidup pesan.
Kode kesalahan umum: Dikembalikan dalam respons HTTP saat Anda memanggil API, seperti
SendMessageToGlobe. Kode-kode ini menunjukkan masalah dengan permintaan itu sendiri (misalnya, parameter tidak valid atau izin tidak cukup), atau bahwa platform menolak permintaan tersebut.Kode status tanda terima pengiriman: Dikembalikan setelah platform menerima pesan, baik melalui panggilan balik asinkron atau dengan memanggil API
SmsReport. Kode-kode ini mencerminkan hasil pengiriman akhir dari penyedia layanan ke perangkat penerima, seperti berhasil, gagal, atau diblokir.Kode kesalahan SMPP dan status pesan: Tersedia hanya saat Anda menggunakan Protokol Short Message Peer-to-Peer (SMPP). Mereka 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 | ID pengirim tidak valid atau belum disetujui. |
|
FORBIDDEN_ACTION | 26 | Izin pemanggilan API akun Anda telah diturunkan. | Ajukan tiket untuk memulihkan akses pemanggilan API. |
OUT_OF_SERVICE | 27 | Layanan SMS ditangguhkan. | - |
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 Konsol SMS. Di panel navigasi kiri, pilih . Periksa status persetujuan. Jika statusnya Rejected, klik Create Template. |
SMS_SIGN_NAME_ILLEGAL | 32 | Tanda tangan tidak valid, tidak ada, atau telah ditolak. | Masuk ke Konsol SMS. Di panel navigasi kiri, pilih . Periksa apakah tanda tangan yang diteruskan persis sama dengan yang disetujui. Jika statusnya Rejected, tinjau alasannya dan ajukan tanda tangan 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 hingga 1.000 penerima per permintaan. Pisahkan daftar yang lebih besar menjadi beberapa permintaan. |
CONTENT_MISSING_PARAMETERS | 35 | Nilai hilang untuk variabel dalam templat pesan. | Periksa parameter |
INVALID_PARAMETERS | 36 | Satu atau lebih 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. | Kesalahan sementara terjadi pada platform Alibaba Cloud. Coba lagi nanti. Jika masalah berlanjut, ajukan tiket dan berikan RequestId. |
DATA_NOT_EXIST | - | Catatan pesan yang diminta tidak ada. | Coba lagi nanti. |
QPS_LIMIT_CONTROL | 48 | Batas QPS untuk pengiriman pesan telah tercapai. | Kurangi frekuensi pemanggilan API untuk tetap berada dalam 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 Manajemen Akses Sumber Daya (RAM) gagal karena izin tidak mencukupi. | Berikan izin yang diperlukan kepada Pengguna RAM untuk memanggil API dan coba lagi. |
PRODUCT_NOT_SUBSCRIBED | 57 | SMS belum diaktifkan. | Masuk ke Konsol SMS dan aktifkan layanan. |
SMS_SECURITY_INTERCEPTED | 61 | Pesan diblokir oleh kebijakan pengendalian risiko. | - |
SMS_CONTENT_ILLEGAL | 62 | Konten pesan tidak sesuai. | Pastikan konten pesan Anda sesuai dengan semua hukum dan peraturan yang berlaku. |
ACCOUNT_ILLEGAL | 63 | Akun Anda telah masuk daftar hitam karena mengirimkan konten yang tidak sesuai. | - |
BLACK_KEY_CONTROL_LIMIT | 64 | Variabel dalam konten pesan berisi kata kunci yang masuk daftar hitam. | Nilai variabel memicu kebijakan keamanan platform. Tinjau dan ubah konten sensitif atau tidak sesuai dalam variabel. |
NOT_SUPPORTED_COUNTRY | 65 | Pengiriman pesan ke negara atau wilayah ini tidak didukung. | - |
SENDERID_BLACKLISTED | 67 | Kebijakan pengendalian risiko memblokir ID pengirim. | - |
IMDA_COMPANY_REQUIRE_LOA | 68 | ID pengirim harus didaftarkan dengan Infocomm Media Development Authority (IMDA). | Daftarkan ID pengirim Anda dengan 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 untuk akun Anda telah tercapai. | Di konsol, buka dan atur ulang batas harian. |
ALERT_LIMIT_MONTH | 85 | Batas pengiriman bulanan untuk 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 dalam 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 bahwa 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 | ID pengirim 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 telah berubah. |
RECEIVER_BLACKLIST | 207 | Nomor penerima masuk daftar hitam penyedia layanan. |
SYSTEM_ERR | 208 | Terjadi kesalahan sistem penyedia layanan. |
SP_UNKNOWN_ERR | 209 | Pengiriman pesan gagal karena alasan yang tidak diketahui. |
URL_FAILURE | 210 | URL dalam konten pesan masuk daftar hitam. |
expired | 211 | Pesan tidak dapat dikirim karena perangkat penerima dimatikan atau tidak tersedia untuk waktu yang lama. |
NO_VALID_SUPPLIER | 212 | Tidak ada penyedia layanan yang sesuai IMDA untuk Singapura. |
Status pesan SMPP
Status pesan SMPP | Status akhir pesan | Deskripsi |
DELIVERED | DELIVRD | Pesan terkirim ke tujuan. |
EXPIRED | EXPIRED | Masa berlaku pesan telah kedaluwarsa. |
DELETED | DELETED | Pesan telah dihapus. |
UNDELIVERABLE | UNDELIV | Pesan tidak dapat dikirim. |
ACCEPTED | ACCEPTD | Pesan dalam status diterima. |
UNKNOWN | UNKNOWN | Pesan dalam status tidak valid. |
REJECTED | REJECTD | Pesan dalam status ditolak. |
Untuk informasi lebih lanjut, lihat Spesifikasi Protokol SMPP V3.4.