SMS API, SMPP API MS Scheduler API
Guide pamaké
SMS API, SMPP API MS Scheduler API
| Dirobih: | 6/24/2025 |
| Vérsi: | 1.7 |
| pangarang: | Kenny Colander Norden, KCN |
Dokumén ieu kanggo panarima anu ditunjuk wungkul sareng tiasa ngandung inpormasi hak istimewa, proprietary, atanapi sanés pribadi. Upami anjeun nampi kasalahan, punten wartosan pangirim langsung sareng hapus anu asli. Sagala pamakéan séjén dokumén ku anjeun dilarang.
Robah sajarah
| Pdt | titimangsa | By | Parobahan ti release saméméhna |
| 1.0 | 2010-03-16 | KCN | Kacipta |
| 1. | 2019-06-11 | TPE | Logo LINK anu diropéa |
| 1. | 2019-09-27 | PNI | rujukan ditambahkeun kana SMPP 3.4 spésifikasi |
| 1. | 2019-10-31 | EP | Observasi ngeunaan periode validitas tag |
| 1. | 2020-08-28 | KCN | Katambah inpormasi ngeunaan versi TLS anu dirojong |
| 2. | 2022-01-10 | KCN | Ditambahkeun inpormasi tambahan ngeunaan laporan pangiriman Inpormasi anu diropéa ngeunaan TLS 1.3 |
| 2. | 2025-06-03 | GM | Kode hasilna ditambahkeun 2108 |
| 2. | 2025-06-24 | AK | Ditambihan kuota |
Bubuka
LINK Mobility parantos janten distributor SMS ti 2001 sareng gaduh seueur pangalaman dina damel sareng operator sareng agrégator sambungan. Platform ieu dirancang pikeun nanganan volume lalu lintas anu ageung, ngajaga kasadiaan anu luhur sareng ngagampangkeun lalu lintas ngalangkungan sababaraha sambungan.
Ieu dokumen ngajelaskeun panganteur SMPP ka SMSC-platform jeung nu parameter jeung paréntah nu diperlukeun tur nu parameter dirojong.
Dokumén ieu moal nanganan kasus pamakean khusus sapertos pesen anu dihijikeun, WAPpush, Flash SMS, jsb. Inpormasi langkung seueur ngeunaan kasus éta tiasa disayogikeun ku ngahubungi dukungan.
paréntah dirojong
Server LINK Mobility kedah diperlakukeun salaku SMPP 3.4. spésifikasi resmi bisa kapanggih dina https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Sadaya metode henteu dirojong, sareng sadaya bédana dijelaskeun di handap.
4.1 Ngabeungkeut
Paréntah mengikat di handap ieu dirojong.
- Pamancar
- Transciever
- panarima
Parameter diperlukeun:
- system_id - dicandak tina dukungan
- sandi - dicandak ti rojongan
Parameter pilihan:
- addr_ton - nilai standar lamun TON disetel ka Teu kanyahoan salila ngirimkeun.
- addr_npi - nilai standar lamun NPI disetel ka Teu kanyahoan salila ngirimkeun.
Parameter anu teu didukung:
- alamat_rentang
4.2 Leupaskeun
Paréntah unbind dirojong.
4.3 Inquire link
Paréntah link inquire dirojong sareng kedah ditelepon unggal 60 detik.
4.4 Nepikeun
Métode kirimkeun kedah dianggo pikeun ngirim pesen.
Parameter diperlukeun:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- short_message
Parameter anu teu didukung:
- service_type
- protokol_id
- priority_flag
- schedule_delivery_time
- replace_if_present_flag
- sm_default_msg_id
Catetan yén payload tag teu dirojong sarta ngan hiji SMS bisa dikirimkeun per panggero jeung eta disarankeun yén validity_period tag ngabogaan nilai 15 menit lila sahenteuna.
4.4.1 Disarankeun TON jeung NPI
TON sareng NPI di handap ieu kedah dianggo nalika ngirim pesen nganggo paréntah kirimkeun.
4.4.1.1 Sumber
Kombinasi TON sareng NPI di handap ieu dirojong pikeun alamat sumber. Sadaya kombinasi anu sanés bakal dianggap teu sah. TON standar tina paréntah bind bakal dianggo upami TON disetel ka Unknown (0). NPI standar tina paréntah bind bakal dianggo upami NPI disetel ka Unknown (0).
| TON | NPI | Katerangan |
| Alfanumerik (5) | Teu kanyahoan (0) ISDN (1) |
Bakal dianggap salaku téks pangirim Alphanumeric |
| Internasional (1) | Teu kanyahoan (0) ISDN (1) |
Bakal diperlakukeun salaku MSISDN |
| Nasional (2) Jaringan husus (3) Jumlah palanggan (4) Disingget (6) |
Teu kanyahoan (0) ISDN (1) Nasional (8) |
Bakal dianggap salaku angka pondok husus nagara. |
4.4.1.2 Tujuan
Kombinasi TON sareng NPI di handap ieu dirojong pikeun alamat tujuan. Sadaya kombinasi anu sanés bakal dianggap teu sah. TON standar tina paréntah bind bakal dianggo upami TON disetel ka Unknown (0). NPI standar tina paréntah bind bakal dianggo upami NPI disetel ka Unknown (0).
| TON | NPI | Katerangan |
| Internasional (1) | Teu kanyahoan (0) ISDN (1) |
Bakal diperlakukeun salaku MSISDN |
4.4.2 Encodings dirojong
Encodings di handap ieu dirojong. X tiasa ngandung nilai naon waé.
| DCS | Encoding |
| 0xX0 | Alfabét GSM standar sareng ekstensi |
| 0xX2 | 8-bit binér |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kuota
5.1 Kuota Leuwihview
Kuota nangtukeun jumlah maksimum pesen SMS nu bisa dikirim dina interval waktu nu tangtu (saperti per poé, minggu, bulan, atawa salamina). Unggal kuota diidentipikasi sacara unik ku quotaId (UUID) sareng direset dumasar kana zona waktos palanggan. Kuota tiasa ditugaskeun di nagara, daérah, atanapi tingkat standar ngalangkungan Quota Profile. Kuota ogé tiasa ditugaskeun sacara dinamis nganggo Pemetaan Kuota. Ieu peta hiji QuotaId indungna (UUID) jeung Key kuota unik (misalna pangirim atawa pamaké) kana quotaID husus.
Kuota diatur saluyu sareng dukungan lokal anjeun, manajer akun anu ditugaskeun anjeun atanapi sacara standar upami teu aya anu ditunjuk.
5.2 Status 106 - Kuota ngaleuwihan
Pesen SMS tiasa diblokir nganggo kode status 106 ("kuota ngaleuwihan") nalika:
- Suratna ngaleuwihan wates anu ditetepkeun pikeun kuotaId anu saluyu dina interval ayeuna.
- Nagara atanapi wilayah tujuan teu gaduh kuota anu ditugaskeun (nyaéta, sacara eksplisit dipeungpeuk ku pemetaan kuota null dina profile).
- Henteu aya kuota anu cocog sareng henteu aya kuota standar anu ditetepkeun, nyababkeun panolakan.
Dina kasus ieu, sistem nyegah pamrosésan pesen salajengna pikeun ngalaksanakeun wates customer atanapi tujuan dumasar-tujuan sareng nyingkahan nyalahgunakeun.
laporan pangiriman
Ngan teu aya atanapi pangiriman final kalayan hasil suksés/gagal anu dirojong.
Format laporan pangiriman: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx tanggal rengse: yyMMddHHmm stat:
Nilai sadia dina status:
- DELIVRD
- Kadaluarsa
- DITOLAK
- UNDELIV
- DIHAPUS
6.1 Format laporan pangiriman nambahan
Inpormasi anu diperpanjang dina laporan pangiriman tiasa dipénta dina kontak sareng wawakil penjualan anjeun.
Format laporan pangiriman: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 tanggal kiriman:
yyMMddHHmm tanggal rengse: yyMMddHHmm stat: err: téks:
Nilai sadia dina status:
- DELIVRD
- Kadaluarsa
- DITOLAK
- UNDELIV
- DIHAPUS
Widang "sub" jeung "dlvrd" bakal salawasna disetel ka 000, sarta widang "teks" bakal salawasna kosong.
Tempo kode Kasalahan bab pikeun nilai pikeun widang "err".
Dirojong versi TLS
TLS 1.2 atawa TLS 1.3 diperlukeun pikeun sakabéh sambungan TLS ngaliwatan SMPP.
Rojongan pikeun TLS 1.0 sareng 1.1 dileungitkeun saprak 2020-11-15. Versi 1.0 sareng 1.1 tina TLS mangrupikeun protokol anu langkung lami anu parantos dileungitkeun sareng dianggap résiko kaamanan di komunitas Internét.
LINK nyarankeun pisan ngagunakeun TLS upami sambungan SMPP anu henteu énkripsi dianggo ayeuna. Sambungan SMPP anu henteu énkripsi dileungitkeun ti 2020-09-01 ku LINK, sareng bakal dipupus di hareup. Tanggal panyabutan sambungan anu teu énkripsi henteu acan diputuskeun.
Sambungan ka server SMPP pikeun TLS aya dina port 3601 tinimbang henteu énkripsi dina port 3600.
Anjeun masih tiasa nganggo TLS sanaos palaksanaan SMPP anjeun henteu ngadukung TLS nganggo stunnel, tingali https://www.stunnel.org/
Kodeu kasalahan
Kodeu kasalahan di handap ieu tiasa diwaler dina kolom err upami lapangan diaktipkeun.
| Kode kasalahan | Katerangan |
| 0 | Kasalahan teu dipikanyaho |
| 1 | Kasalahan routing samentara |
| 2 | Kasalahan routing permanén |
| 3 | throttling maksimum ngaleuwihan |
| 4 | Séép waktos |
| 5 | Kasalahan operator teu dipikanyaho |
| 6 | Kasalahan operator |
| 100 | Service teu kapanggih |
| 101 | Pamaké teu kapanggih |
| 102 | Rekening teu kapanggih |
| 103 | Kecap aksés salah |
| 104 | Kasalahan konfigurasi |
| 105 | Kasalahan internal |
| 106 | Kuota ngaleuwihan |
| 200 | OK |
| 1000 | Dikirim |
| 1001 | Dihaturkeun |
| 1002 | Kadaluwarsa |
| 1003 | Dipupus |
| 1004 | Mobile pinuh |
| 1005 | Ngantri |
| 1006 | Teu dianteurkeun |
| 1007 | Dikintunkeun, biaya ditunda |
| 1008 | Dicas, pesen teu dikirim |
| 1009 | Dieusi, pesen teu dikirimkeun |
| 1010 | Kadaluwarsa, henteuna laporan pangiriman operator |
| 1011 | Dicas, pesen dikirim (ka operator) |
| 1012 | Jauh ngantri |
| 1013 | Pesen dikirim ka operator, ngecas ditunda |
| 2000 | Nomer sumber teu valid |
| 2001 | Nomer pondok teu dirojong salaku sumber |
| 2002 | Alfa henteu dirojong salaku sumber |
| 2003 | MSISDN henteu dirojong salaku nomer sumber |
| 2100 | Nomer pondok teu dirojong salaku tujuan |
| 2101 | Alfa henteu dirojong salaku tujuan |
| 2102 | MSISDN henteu dirojong salaku tujuan |
| 2103 | Operasi diblokir |
| 2104 | Palanggan kanyahoan |
| 2105 | Tujuan diblokir |
| 2106 | Kasalahan angka |
| 2107 | Tujuan samentawis diblokir |
| 2108 | Tujuan teu valid |
| 2200 | Kasalahan ngecas |
| 2201 | Palanggan boga kasaimbangan low |
|
2202 |
Palanggan dilarang pikeun ditagihkeun (premium)
talatah |
|
2203 |
Palanggan ngora teuing (pikeun khusus ieu
eusi) |
| 2204 | Palanggan prabayar teu diwenangkeun |
| 2205 | Service ditolak ku palanggan |
| 2206 | Palanggan henteu kadaptar dina sistem pamayaran |
| 2207 | Palanggan parantos ngahontal kasaimbangan maksimal |
| 2208 | Konfirmasi pamaké tungtung diperlukeun |
| 2300 | Dibalikeun deui |
|
2301 |
Teu bisa ngabalikeun duit alatan ilegal atawa leungit
MSISDN |
| 2302 | Teu bisa ngabalikeun duit alatan messageId leungit |
| 2303 | Ngantri pikeun ngabalikeun duit |
| 2304 | Waktu ngabalikeun duit |
| 2305 | Ngabalikeun duit gagal |
| 3000 | Encoding GSM henteu dirojong |
| 3001 | Encoding UCS2 henteu dirojong |
| 3002 | Encoding binér henteu dirojong |
| 4000 | Laporan pangiriman teu didukung |
| 4001 | Eusi pesen teu valid |
| 4002 | Tarif teu sah |
| 4003 | Data pamaké teu valid |
| 4004 | lulugu data pamaké teu valid |
| 4005 | Coding data teu valid |
| 4006 | PPN teu sah |
| 4007 | Eusi anu teu dirojong pikeun tujuan |
Dokumén / Sumberdaya
 |
link mobilitas SMS API, SMPP API MS Scheduler API [pdf] Pituduh pamaké SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |