SMS API, SMPP API MS Scheduler API
Pandhuan pangguna
SMS API, SMPP API MS Scheduler API
| Diowahi: | 6/24/2025 |
| Versi: | 1.7 |
| Pengarang: | Kenny Colander Norden, KCN |
Dokumen iki mung kanggo panampa sing ditunjuk lan bisa uga ngemot informasi hak istimewa, kepemilikan, utawa pribadi. Yen sampeyan salah nampa, tulung langsung ngabari pangirim lan mbusak asline. Sembarang panggunaan dokumen liyane dening sampeyan dilarang.
Ngganti riwayat
| Pdt | Tanggal | By | Owah-owahan saka release sadurungé |
| 1.0 | 2010-03-16 | KCN | Digawe |
| 1. | 2019-06-11 | TPE | Logo LINK sing dianyari |
| 1. | 2019-09-27 | PNI | Referensi ditambahake menyang spesifikasi SMPP 3.4 |
| 1. | 2019-10-31 | EP | Observasi babagan periode validitas tag |
| 1. | 2020-08-28 | KCN | Informasi sing ditambahake babagan versi TLS sing didhukung |
| 2. | 2022-01-10 | KCN | Nambahake informasi tambahan babagan laporan pangiriman Informasi sing dianyari babagan TLS 1.3 |
| 2. | 2025-06-03 | GM | Kode asil ditambahake 2108 |
| 2. | 2025-06-24 | AK | Tambah kuota |
Pambuka
LINK Mobility wis dadi distributor SMS wiwit taun 2001 lan wis akeh pengalaman nggarap operator lan agregator sambungan. Platform iki dirancang kanggo nangani volume lalu lintas sing akeh, njaga kasedhiyan dhuwur lan nggampangake rute lalu lintas liwat macem-macem sambungan.
Iki document njlèntrèhaké antarmuka SMPP kanggo SMSC-platform lan paramèter lan printah sing dibutuhake lan paramèter sing didhukung.
Dokumen iki ora bakal nangani kasus panggunaan tartamtu minangka pesen gabungan, WAPpush, Flash SMS, lsp. Informasi liyane babagan kasus kasebut bisa diwenehake kanthi ngubungi dhukungan.
Didhukung printah
Server LINK Mobility kudu dianggep minangka SMPP 3.4. Spesifikasi resmi bisa ditemokake ing https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Kabeh cara ora didhukung, lan kabeh beda ditetepake ing ngisor iki.
4.1 Ikatan
Printah bind ing ngisor iki didhukung.
- Pemancar
- Transceiver
- panrima
Parameter sing dibutuhake:
- system_id – dipikolehi saka dhukungan
- sandi - dijupuk saka support
Parameter opsional:
- addr_ton - nilai standar yen TON disetel menyang Ora dingerteni nalika ngirim.
- addr_npi - nilai standar yen NPI disetel menyang Ora dingerteni nalika ngirim.
Parameter sing ora didhukung:
- alamat_jarak
4.2 Mbukak ikatan
Printah unbind didhukung.
4.3 Njaluk link
Perintah link inquire didhukung lan kudu diarani saben 60 detik.
4.4 Kirim
Cara ngirim ngirim digunakake kanggo ngirim pesen.
Parameter sing dibutuhake:
- sumber_addr_ton
- sumber_addr_npi
- sumber_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_kelas
- data_coding
- sm_length
- short_pesen
Parameter sing ora didhukung:
- service_type
- protokol_id
- priority_flag
- schedule_delivery_time
- replace_if_present_flag
- sm_default_msg_id
Cathetan sing payload tag ora didhukung lan mung siji SMS bisa dikirim saben telpon lan dianjurake yen validity_period tag nduweni nilai paling sethithik 15 menit.
4.4.1 Dianjurake TON lan NPI
TON lan NPI ing ngisor iki kudu digunakake nalika ngirim pesen nggunakake printah kirim.
4.4.1.1 Sumber
Kombinasi TON lan NPI ing ngisor iki didhukung kanggo alamat sumber. Kabeh kombinasi liyane bakal dianggep ora sah. TON standar saka printah bind bakal digunakake yen TON disetel menyang Ora dingerteni (0). NPI standar saka printah bind bakal digunakake yen NPI disetel menyang Ora dingerteni (0).
| TON | NPI | Katrangan |
| Alfanumerik (5) | Ora dingerteni (0) ISDN (1) |
Bakal dianggep minangka teks pangirim Alphanumeric |
| Internasional (1) | Ora dingerteni (0) ISDN (1) |
Bakal dianggep minangka MSISDN |
| Nasional (2) Khusus jaringan (3) Nomer pelanggan (4) Singkatan (6) |
Ora dingerteni (0) ISDN (1) Nasional (8) |
Bakal dianggep minangka nomer singkat negara. |
4.4.1.2 Tujuan
Kombinasi TON lan NPI ing ngisor iki didhukung kanggo alamat tujuan. Kabeh kombinasi liyane bakal dianggep ora sah. TON standar saka printah bind bakal digunakake yen TON disetel menyang Ora dingerteni (0). NPI standar saka printah bind bakal digunakake yen NPI disetel menyang Ora dingerteni (0).
| TON | NPI | Katrangan |
| Internasional (1) | Ora dingerteni (0) ISDN (1) |
Bakal dianggep minangka MSISDN |
4.4.2 Enkoding sing didhukung
Enkoding ing ngisor iki didhukung. X bisa ngemot nilai apa wae.
| DCS | Enkoding |
| 0xX0 | Alfabet GSM standar kanthi ekstensi |
| 0xX2 | 8-bit binar |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
kuota
5.1 Kuota Luwihview
Kuota nemtokake jumlah maksimum pesen SMS sing bisa dikirim ing interval wektu tartamtu (kayata saben dina, minggu, sasi, utawa tanpa wates). Saben kuota diidentifikasi kanthi unik kanthi quotaId (UUID) lan direset miturut zona wektu pelanggan. Kuota bisa ditugasake ing negara, wilayah, utawa tingkat standar liwat Quota Profile. Kuota uga bisa ditugasake kanthi dinamis nggunakake Quota Mapping. Iki peta KuotaId induk (UUID) lan Kunci kuota unik (contone, pangirim utawa pangguna) menyang kuotaId tartamtu.
Kuota disetel miturut dhukungan lokal, manajer akun sing ditugasake utawa kanthi standar yen ora ana sing ditemtokake.
5.2 Status 106 – Kuota Ngluwihi
Pesen SMS bisa diblokir nganggo kode status 106 ("kuota ngluwihi") nalika:
- Pesen ngluwihi wates sing ditemtokake kanggo kuotaId sing cocog ing interval saiki.
- Negara utawa wilayah sing dituju ora duwe kuota sing diwenehake (yaiku, diblokir kanthi jelas karo pemetaan kuota null ing profile).
- Ora ana kuota sing cocog lan ora ana kuota standar sing ditetepake, nyebabake penolakan.
Ing kasus kasebut, sistem nyegah pangolahan pesen luwih lanjut kanggo ngetrapake watesan basis pelanggan utawa tujuan lan supaya ora digunakake.
Laporan pangiriman
Mung ora ana utawa pangiriman pungkasan kanthi asil sukses/gagal sing didhukung.
Format laporan pengiriman: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx tanggal rampung: yyMMddHHmm stat:
Nilai sing kasedhiya ing status:
- DELIVRD
- expired
- TOLAK
- UNDELIV
- DIBUKE
6.1 Format laporan pangiriman lengkap
Informasi lengkap ing laporan pangiriman bisa uga dijaluk ing kontak karo wakil dodolan sampeyan.
Format laporan pengiriman: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 tanggal kirim:
yyMMddHHmm rampung tanggal: yyMMddHHmm stat: salah: teks:
Nilai sing kasedhiya ing status:
- DELIVRD
- expired
- TOLAK
- UNDELIV
- DIBUKE
Kolom "sub" lan "dlvrd" mesthi disetel dadi 000, lan kolom "teks" bakal kosong.
Waca bab Kode kesalahan kanggo nilai kanggo kolom "err".
Versi TLS sing didhukung
TLS 1.2 utawa TLS 1.3 dibutuhake kanggo kabeh sambungan TLS liwat SMPP.
Dhukungan kanggo TLS 1.0 lan 1.1 mandheg wiwit 2020-11-15. Versi 1.0 lan 1.1 saka TLS minangka protokol lawas sing wis ora digunakake lan dianggep minangka risiko keamanan ing komunitas Internet.
LINK banget nyaranake nggunakake TLS yen sambungan SMPP sing ora dienkripsi digunakake saiki. Sambungan SMPP sing ora dienkripsi ora digunakake wiwit 2020-09-01 dening LINK, lan bakal dibusak ing mangsa ngarep. Tanggal kanggo mbusak sambungan sing ora dienkripsi durung ditemtokake.
Sambungan menyang server SMPP kanggo TLS ana ing port 3601 tinimbang ora dienkripsi ing port 3600.
Sampeyan isih bisa nggunakake TLS sanajan implementasi SMPP sampeyan ora ndhukung TLS nggunakake stunnel, deleng https://www.stunnel.org/
Kode kesalahan
Kode kesalahan ing ngisor iki bisa dijawab ing kolom err yen kolom kasebut diaktifake.
| Kode kesalahan | Katrangan |
| 0 | Kesalahan sing ora dingerteni |
| 1 | Kesalahan rute sementara |
| 2 | kesalahan routing permanen |
| 3 | Throttling maksimum ngluwihi |
| 4 | wektu entek |
| 5 | Operator kesalahan sing ora dingerteni |
| 6 | Kesalahan operator |
| 100 | Layanan ora ditemokake |
| 101 | Pangguna ora ditemokake |
| 102 | Akun ora ditemokake |
| 103 | Tembung sandhi ora sah |
| 104 | Kesalahan konfigurasi |
| 105 | Kesalahan internal |
| 106 | Kuota ngluwihi |
| 200 | OK |
| 1000 | Dikirim |
| 1001 | Dikirim |
| 1002 | kadaluwarsa |
| 1003 | Dibusak |
| 1004 | Mobile lengkap |
| 1005 | antri |
| 1006 | Ora dikirim |
| 1007 | Dikirim, biaya telat |
| 1008 | Dikenani biaya, pesen ora dikirim |
| 1009 | Dikenani biaya, pesen ora dikirim |
| 1010 | Kadaluwarsa, ora ana laporan pangiriman operator |
| 1011 | Dikenani biaya, pesen dikirim (menyang operator) |
| 1012 | Antri adoh |
| 1013 | Pesen dikirim menyang operator, ngisi daya telat |
| 2000 | Nomer sumber ora valid |
| 2001 | Nomer singkat ora didhukung minangka sumber |
| 2002 | Alpha ora didhukung minangka sumber |
| 2003 | MSISDN ora didhukung minangka nomer sumber |
| 2100 | Nomer singkat ora didhukung minangka tujuan |
| 2101 | Alpha ora didhukung minangka tujuan |
| 2102 | MSISDN ora didhukung minangka tujuan |
| 2103 | Operasi diblokir |
| 2104 | Langganan sing ora dingerteni |
| 2105 | Tujuan diblokir |
| 2106 | Kesalahan nomer |
| 2107 | Tujuan diblokir sementara |
| 2108 | Tujuan ora sah |
| 2200 | Kesalahan ngisi daya |
| 2201 | Pelanggan duwe imbangan kurang |
|
2202 |
Pelanggan dilarang amarga dikenani biaya berlebihan (premium)
pesen |
|
2203 |
Pelanggan isih enom (kanggo khusus iki
isi) |
| 2204 | Pelanggan prabayar ora diidini |
| 2205 | Layanan ditolak dening pelanggan |
| 2206 | Pelanggan ora kadhaptar ing sistem pembayaran |
| 2207 | Pelanggan wis tekan imbangan maksimal |
| 2208 | Konfirmasi pangguna pungkasan dibutuhake |
| 2300 | dibalekake |
|
2301 |
Ora bisa mbalekaken amarga ilegal utawa ilang
MSISDN |
| 2302 | Ora bisa mbalekaken amarga ilang messageId |
| 2303 | Antrian kanggo mbalekaken |
| 2304 | mbalekaken wektu entek |
| 2305 | Gagal mbalekaken |
| 3000 | Encoding GSM ora didhukung |
| 3001 | Enkoding UCS2 ora didhukung |
| 3002 | Encoding binar ora didhukung |
| 4000 | Laporan pangiriman ora didhukung |
| 4001 | Isi pesen ora valid |
| 4002 | Tarif ora sah |
| 4003 | Data pangguna ora valid |
| 4004 | Header data pangguna ora valid |
| 4005 | Kodhe data ora valid |
| 4006 | PPN ora sah |
| 4007 | Konten sing ora didhukung kanggo tujuan |
Dokumen / Sumber Daya
 |
link mobilitas SMS API, SMPP API MS Scheduler API [pdf] Pandhuan pangguna SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |