SMS API,SMPP API MS Scheduler API
Isikhokelo somsebenzisi
SMS API,SMPP API MS Scheduler API
| Ilungisiwe: | 6/24/2025 |
| Inguqulelo: | 1.7 |
| Umbhali: | Kenny Colander Norden, KCN |
Olu xwebhu lolomamkeli ochongiweyo kuphela kwaye lunokuba nolwazi olukhethekileyo, olunobunikazi, okanye ngenye indlela yabucala. Ukuba uyifumene ngempazamo, nceda wazise umthumeli ngoko nangoko kwaye ucime eyoqobo. Nakuphi na okunye ukusetyenziswa koxwebhu nguwe akuvumelekanga.
Guqula imbali
| Umfundisi | Umhla | By | Utshintsho kukhupho lwangaphambili |
| 1.0 | 2010-03-16 | I-KCN | Yenziwe |
| 1. | 2019-06-11 | TPE | iilogo ezihlaziyiweyo zeLINK |
| 1. | 2019-09-27 | I-PNI | Isalathiso esongeziweyo kwinkcazo ye-SMPP 3.4 |
| 1. | 2019-10-31 | EP | Uqwalaselo malunga nexesha lokuqinisekisa tag |
| 1. | 2020-08-28 | I-KCN | Ulwazi olongeziweyo malunga neenguqulelo zeTLS ezixhaswayo |
| 2. | 2022-01-10 | I-KCN | Added additional information regarding delivery reports Updated information regarding TLS 1.3 |
| 2. | 2025-06-03 | GM | Added result code 2108 |
| 2. | 2025-06-24 | AK | Added quota |
Intshayelelo
I-LINK Ukuhamba kube ngumsasazi we-SMS ukususela ngo-2001 kwaye unamava amaninzi ekusebenzeni kunye nabaqhubi kunye ne-aggregators yokudibanisa. Eli qonga lenzelwe ukuphatha umthamo omkhulu wetrafikhi, ukugcina ukufumaneka okuphezulu kunye nokwenza kube lula ukuhambisa i-traffic ngokusebenzisa imidibaniso emininzi.
Olu xwebhu luchaza ujongano lweSMPP kwi-SMSC-platform kwaye zeziphi iiparamitha kunye nemiyalelo efunekayo kwaye zeziphi iiparamitha ezixhaswayo.
This document will not handle specific use cases as concatenated messages, WAPpush, Flash SMS, etc. More information about those cases can be provided by contacting support.
Imiyalelo exhaswayo
LINK Iseva ye-Mobility kufuneka iphathwe njenge-SMPP 3.4. Iinkcukacha ezisemthethweni zinokufunyanwa apha https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Zonke iindlela azixhaswanga, kwaye zonke iiyantlukwano zichazwe ngezantsi.
4.1 Zibophe
Le miyalelo yokubopha ilandelayo iyaxhaswa.
- Isidluliseli
- Transciever
- Umamkeli
Iiparamitha ezifunekayo:
- system_id – ifunyenwe kwinkxaso
- Igama lokugqitha – lifunyenwe kwinkxaso
Iiparamitha ozikhethayo:
- addr_ton - ixabiso elingagqibekanga ukuba i-TON imiselwe ku-Ayaziwa ngexesha lokungenisa.
- addr_npi - ixabiso elisisiseko ukuba i-NPI imiselwe ku-Ayaziwa ngexesha lokungenisa.
Iiparamitha ezingaxhaswanga:
- idilesi_uluhlu
4.2 Ukukhulula
Umyalelo wokukhulula uyaxhaswa.
4.3 Ikhonkco lokubuza
Umyalelo wekhonkco lokubuza uyaxhaswa kwaye kufuneka ubizwe rhoqo ngemizuzwana engama-60.
4.4 Ngenisa
Indlela yokungenisa kufuneka isetyenziswe ukuhambisa imiyalezo.
Iiparamitha ezifunekayo:
- umthombo_yongeza_ton
- umthombo_addr_npi
- umthombo_ukongeza
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_ubude
- umyalezo_omfutshane
Iiparamitha ezingaxhaswanga:
- uhlobo_lwenkonzo
- iprotocol_id
- i-priority_flag
- ishedyuli_yokuhambisa_ixesha
- replace_if_present_flag
- sm_default_msg_id
Phawula ukuba umvuzo tag ayixhaswanga kwaye inye kuphela iSMS enokuthi ithunyelwe ngomnxeba ngamnye kwaye kuyacetyiswa ukuba ivality_period tag inexabiso le-15 imizuzu ubude ubuncinane.
4.4.1 I-TON kunye ne-NPI ecetyiswayo
I-TON elandelayo kunye ne-NPI kufuneka isetyenziswe xa kuthunyelwa imiyalezo usebenzisa umyalelo wokungenisa.
4.4.1.1 Umthombo
The following TON and NPI combinations are supported for source address. All other combinations will be treated as invalid. The default TON from bind command will be used if TON is set to Unknown (0). The default NPI from bind command will be used if NPI is set to Unknown (0).
| I-TON | NPI | Inkcazo |
| Uluhlu lwamanani (5) | Akwaziwa (0) ISDN (1) |
Iza kuphathwa njengombhalo womthumeli we-Alphanumeric |
| Amazwe ngamazwe (1) | Akwaziwa (0) ISDN (1) |
Iya kuphathwa njenge-MSISDN |
| Esizwe (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Akwaziwa (0) ISDN (1) Esizwe (8) |
Iza kuphathwa njengenombolo emfutshane yelizwe elithile. |
4.4.1.2 Indawo ekuyiwa kuyo
Le ndibaniselwano ilandelayo ye-TON kunye ne-NPI ixhaswa kwidilesi yendawo ekuyiwa kuyo. Zonke ezinye iindibaniselwano ziya kuthathwa njengezingekho mthethweni. Ukungagqibekanga kweTON ukusuka kumyalelo wokubopha kuya kusetyenziswa ukuba i-TON imiselwe ku-Akwaziwa (0). I-NPI engagqibekanga esuka kumyalelo wokubopha iya kusetyenziswa ukuba i-NPI imiselwe ku-Akwaziwa (0).
| I-TON | NPI | Inkcazo |
| Amazwe ngamazwe (1) | Akwaziwa (0) ISDN (1) |
Iya kuphathwa njenge-MSISDN |
4.4.2 Iikhowudi ezixhaswayo
Ezi khowudi zilandelayo ziyaxhaswa. X ingaqulatha naliphi na ixabiso.
| DCS | Ufakelo lweekhowudi |
| 0xx0 | Ukuhlala kukho iAlfabhethi yeGSM enolwandiso |
| 0xx2 | 8-bit yokubini |
| 0xx8 | I-UCS2 (ISO-10646-UCS-2) |
Umlinganiselo
5.1 IQuota Overview
A quota defines the maximum number of SMS messages that can be sent within a specified time interval (such as per day, week, month, or indefinitely). Each quota is uniquely identified by a quotaId (UUID) and is reset according to the customer’s time zone. Quotas can be assigned at the country, region, or default level through a Quota Profile. Quota can also be dynamically assigned using Quota Mapping. This maps a parent QuotaId (UUID) and a unique quota Key (e.g., sender or user) to a specific quotaId.
I-quota imiselwe ngokuhambelana nenkxaso yakho yendawo, umphathi weakhawunti owabelweyo okanye ngokungagqibekanga ukuba akukho nto ichaziweyo.
5.2 Status 106 – Quota Exceeded
An SMS message may be blocked with status code 106 (“quota exceeded”) when:
- The message exceeds the defined limit for its corresponding quotaId within the current interval.
- The destination country or region has no quota assigned (i.e., is explicitly blocked with a null quota mapping in the profile).
- There is no matching quota and no default quota is defined, resulting in rejection.
Kwezi meko, inkqubo inqanda ukuqhubekeka komyalezo ukunyanzelisa umthengi okanye imida esekwe kwindawo ekuyiwa kuyo kwaye unqande ukusetyenziswa kakubi.
Ingxelo yonikezelo
Akukho nanye kuphela okanye unikezelo lokugqibela olunesiphumo esiyimpumelelo/esileleyo esixhaswayo.
Ubume kwingxelo yohambiso: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx umhla wokwenziwa: yyMMddHHmm ubalo:
Amaxabiso akhoyo kwimeko:
- DELIVRD
- IPHELELE
- KWAKHIWE
- UNDELIV
- Icinyiwe
6.1 Ifomathi eyandisiweyo yengxelo yonikezelo
Ulwazi olongeziweyo kwiingxelo zonikezelo lunokucelwa ukuba uqhagamshelane nommeli wakho wokuthengisa.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Amaxabiso akhoyo kwimeko:
- DELIVRD
- IPHELELE
- KWAKHIWE
- UNDELIV
- Icinyiwe
"sub" kunye "dlvrd" imihlaba iyakuhlala icwangciswe ku-000, kwaye indawo "yombhalo" iyakuhlala ingenanto.
Jonga isahluko Iikhowudi zeemposiso zamaxabiso kwindawo "yempazamo".
Iinguqulelo zeTLS ezixhaswayo
I-TLS 1.2 okanye i-TLS 1.3 iyafuneka kulo lonke uqhagamshelwano lwe-TLS nge-SMPP.
Inkxaso ye-TLS 1.0 kunye ne-1.1 inqanyuliwe ukususela ngo-2020-11-15. Iinguqulelo ze-1.0 kunye ne-1.1 ye-TLS ziiprothokholi ezindala eziye zayekiswa kwaye zithathwa njengengozi yokhuseleko kuluntu lwe-Intanethi.
I-LINK icebisa ngamandla ukusebenzisa i-TLS ukuba imidibaniso ye-SMPP engafihlwanga iyasetyenziswa namhlanje. Imidibaniso ye-SMPP engafihlwanga iyekisiwe ukusukela ngo-2020-09-01 yi-LINK, kwaye iya kususwa kwixesha elizayo. Umhla wokususwa komdibaniso ongafihlwanga awukagqitywa.
Uqhagamshelo olusingise kwiseva ye-SMPP ye-TLS ikwizibuko 3601 endaweni yokungafihlwa kwizibuko 3600.
Usenokusebenzisa i-TLS nokuba uphumezo lwakho lwe-SMPP aluxhasi i-TLS usebenzisa i-stunnel, bona https://www.stunnel.org/
Iikhowudi zeemposiso
Ezi khowudi zilandelayo zempazamo zinokuphendulwa kwindawo yempazamo ukuba umhlaba wenziwe ukuba usebenze.
| Ikhowudi yempazamo | Inkcazo |
| 0 | Imposiso engaziwayo |
| 1 | Imposiso yexeshana kwindlela |
| 2 | Imposiso esisigxina |
| 3 | Ubuninzi be-throttling bugqithiwe |
| 4 | Kuphele ixesha |
| 5 | Impazamo engaziwayo yomsebenzisi |
| 6 | Impazamo yomsebenzisi |
| 100 | Inkonzo ayifunyenwanga |
| 101 | Umsebenzisi akafunyanwanga |
| 102 | Iakhawunti ayifunyenwanga |
| 103 | Iphasiwedi engekhoyo |
| 104 | Impazamo yoqwalaselo |
| 105 | Impazamo yangaphakathi |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Ithunyelwe |
| 1001 | Inikezelwe |
| 1002 | Iphelelwe lixesha |
| 1003 | Icinyiwe |
| 1004 | Iselfowuni igcwele |
| 1005 | Ifakwe emgceni |
| 1006 | Ayiziswanga |
| 1007 | Inikezelwe, intlawulo ilibazisekile |
| 1008 | Ihlawulisiwe, umyalezo awuthunyelwanga |
| 1009 | Ihlawulwe, umyalezo awuthunyelwanga |
| 1010 | Iphelelwe lixesha, ukungabikho kwengxelo yokuhanjiswa komsebenzisi |
| 1011 | Ihlawulisiwe, umyalezo uthunyelwe (kumsebenzisi) |
| 1012 | Ukude emgceni |
| 1013 | Umyalezo uthunyelwe kumsebenzisi, ukutshaja kulibazisekile |
| 2000 | Inombolo yomthombo engasebenziyo |
| 2001 | Inombolo emfutshane ayixhaswanga njengomthombo |
| 2002 | IAlpha ayixhaswanga njengomthombo |
| 2003 | I-MSISDN ayixhaswanga njengenombolo yomthombo |
| 2100 | Inombolo emfutshane ayixhaswanga njengendawo yokufikela |
| 2101 | IAlpha ayixhaswanga njengendawo yokufikela |
| 2102 | I-MSISDN ayixhaswanga njengendawo yokufikela |
| 2103 | Umsebenzi uvaliwe |
| 2104 | Umrhumi ongaziwayo |
| 2105 | Indawo yokufikela ivaliwe |
| 2106 | Impazamo yenani |
| 2107 | Indawo yokufikela ivalwe okwexeshana |
| 2108 | Invalid destination |
| 2200 | Impazamo yokutshaja |
| 2201 | Umxhasi unebhalansi ephantsi |
|
2202 |
Subscriber barred for overcharged (premium)
imiyalezo |
|
2203 |
Subscriber too young (for this particular
umxholo) |
| 2204 | Umrhumi ohlawulwa kwangaphambili akavumelekanga |
| 2205 | Inkonzo yaliwe ngumrhumi |
| 2206 | Umxhasi akabhaliswanga kwinkqubo yentlawulo |
| 2207 | Umrhumi ufikelele kwibhalansi enkulu |
| 2208 | Isiqinisekiso somsebenzisi siyafuneka |
| 2300 | Ibuyiselwe |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Ayikwazanga kubuyiselwa imali ngenxa yomyalezoId ongekhoyo |
| 2303 | Kukrolwe ukubuyiselwa imali |
| 2304 | Ukuphelelwa kwembuyekezo |
| 2305 | Ukusilela kwembuyekezo |
| 3000 | Ufakelo lwekhowudi lwe-GSM aluxhaswanga |
| 3001 | Ukhowudo lwe-UCS2 aluxhaswanga |
| 3002 | Ubhalo lwekhowudi yokubini aluxhaswanga |
| 4000 | Ingxelo yokuhanjiswa ayixhaswanga |
| 4001 | Umxholo womyalezo ongasebenziyo |
| 4002 | Uluhlu lweerhafu olungasebenziyo |
| 4003 | Iinkcukacha zomsebenzisi ezingasebenziyo |
| 4004 | Isihloko esingasebenziyo sedatha yomsebenzisi |
| 4005 | Ukufakwa kwekhowudi kwidatha engasebenziyo |
| 4006 | I-VAT engekho |
| 4007 | Umxholo ongaxhaswayo wendawo |
Amaxwebhu / Izibonelelo
 |
link mobility SMS API,SMPP API MS Scheduler API [pdf] Isikhokelo somsebenzisi SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |