I-SMS API,SMPP API MS Scheduler API
Umhlahlandlela Womsebenzisi
I-SMS API,SMPP API MS Scheduler API
| Kulungisiwe: | 6/24/2025 |
| Inguqulo: | 1.7 |
| Umbhali: | Kenny Colander Norden, KCN |
Le dokhumenti ngeyomamukeli oqokiwe kuphela futhi ingase ibe nolwazi olukhethekile, olungokobunikazi, noma ngenye indlela eyimfihlo. Uma uyithole ngephutha, sicela wazise umthumeli ngokushesha futhi ususe eyangempela. Noma yikuphi okunye ukusebenzisa kwakho idokhumenti akuvunyelwe.
Shintsha umlando
| Umfundisi | Usuku | By | Izinguquko kusukela ekukhishweni kwangaphambilini |
| 1.0 | 2010-03-16 | I-KCN | Kwakhiwe |
| 1. | 2019-06-11 | I-TPE | Kubuyekezwe amalogo e-LINK |
| 1. | 2019-09-27 | I-PNI | Ireferensi eyengeziwe ekucacisweni kwe-SMPP 3.4 |
| 1. | 2019-10-31 | EP | Ukubuka mayelana nesikhathi sokuqinisekisa tag |
| 1. | 2020-08-28 | I-KCN | Ulwazi olungeziwe mayelana nezinguqulo ze-TLS ezisekelwayo |
| 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 |
Isingeniso
I-LINK Mobility ingumsabalalisi we-SMS kusukela ngo-2001 futhi inolwazi oluningi ekusebenzeni nabo bobabili ama-opharetha kanye nezihlanganisi zokuxhuma. Le nkundla yakhelwe ukuphatha umthamo omkhulu wethrafikhi, igcine ukutholakala okuphezulu futhi yenze kube lula ukuhambisa ithrafikhi ngoxhumano oluningi.
Lona umbhalo ochaza isixhumi esibonakalayo se-SMPP kunkundla ye-SMSC nokuthi yimiphi imingcele nemiyalo edingekayo nokuthi yiziphi izinhlaka ezisekelwayo.
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.
Imiyalo esekelwe
Iseva ye-LINK Mobility kufanele ithathwe njenge-SMPP 3.4. Ukucaciswa okusemthethweni kungatholakala kokuthi https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Zonke izindlela azisekelwa, futhi wonke umehluko ucaciswe ngezansi.
4.1 Hlanganisa
Imiyalo yokuhlanganisa elandelayo iyasekelwa.
- I-Transmitter
- I-Transciever
- Umamukeli
Amapharamitha adingekayo:
- system_id - etholwe ekusekelweni
- iphasiwedi - etholwe kusekelo
Amapharamitha ongawakhetha:
- addr_ton - inani elizenzakalelayo uma i-TON isethelwe kokuthi Akwaziwa ngesikhathi sokuhambisa.
- addr_npi – inani elizenzakalelayo uma i-NPI isethelwe kokuthi Akwaziwa ngesikhathi sokuhambisa.
Amapharamitha angasekelwe:
- ikheli_ububanzi
4.2 Khipha
Umyalo wokukhulula uyasekelwa.
4.3 Isixhumanisi sokubuza
Umyalo wesixhumanisi sokubuza uyasekelwa futhi kufanele ubizwe njalo ngemizuzwana engama-60.
4.4 Thumela
Indlela yokuhambisa kufanele isetshenziselwe ukuletha imilayezo.
Amapharamitha adingekayo:
- umthombo_addr_ton
- umthombo_addr_npi
- umthombo_wengeza
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- idatha_yekhodi
- sm_ubude
- umlayezo_omfishane
Amapharamitha angasekelwe:
- uhlobo_lwesevisi
- iphrothokholi_id
- ifulegi_elibalulekile
- hlela_isikhathi_sokulethwa
- buyisela_if_present_flag
- sm_default_msg_id
Qaphela ukuthi umthwalo tag ayisekelwe futhi i-SMS eyodwa kuphela engalethwa ngekholi ngayinye futhi kuyanconywa ukuthi i-validity_period tag inenani lemizuzu engu-15 ubude okungenani.
4.4.1 I-TON ne-NPI enconyiwe
I-TON ne-NPI elandelayo kufanele isetshenziswe lapho kuthunyelwa imilayezo kusetshenziswa umyalo wokuthumela.
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 | I-NPI | Incazelo |
| I-alphanumeric (5) | Akwaziwa (0) ISDN (1) |
Izophathwa njengombhalo womthumeli we-Alphanumeric |
| Okwamazwe ngamazwe (1) | Akwaziwa (0) ISDN (1) |
Izophathwa njenge-MSISDN |
| Kuzwelonke (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Akwaziwa (0) ISDN (1) Kuzwelonke (8) |
Izophathwa njengenombolo emfushane yezwe elithile. |
4.4.1.2 Indawo
Izinhlanganisela ezilandelayo ze-TON ne-NPI zisekelwa ikheli lendawo. Zonke ezinye izinhlanganisela zizophathwa njengezingavumelekile. I-TON ezenzakalelayo evela kumyalo wokubopha izosetshenziswa uma i-TON isethelwe kokuthi Akwaziwa (0). I-NPI ezenzakalelayo evela kumyalo wokubopha izosetshenziswa uma i-NPI isethelwe kokuthi Akwaziwa (0).
| I-TON | I-NPI | Incazelo |
| Okwamazwe ngamazwe (1) | Akwaziwa (0) ISDN (1) |
Izophathwa njenge-MSISDN |
4.4.2 Umbhalo wekhodi osekelwayo
Umbhalo wekhodi olandelayo uyasekelwa. X ingaqukatha noma yiliphi inani.
| I-DCS | Ukufaka ikhodi |
| 0xx0 | I-Alfabhethi ye-GSM ezenzakalelayo enesandiso |
| 0xx2 | 8-bit kanambambili |
| 0xx8 | I-UCS2 (ISO-10646-UCS-2) |
Isabelo
5.1 Isabelo siphelileview
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.
Isabelo sisethwa ngokuvumelana nokusekela kwakho kwasendaweni, umphathi we-akhawunti owabelwe noma ngokuzenzakalela uma kungashiwongo lutho.
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.
Kulezi zimo, isistimu ivimbela ukucutshungulwa komlayezo okwengeziwe ukuze kuphoqelelwe ikhasimende noma imikhawulo esekelwe endaweni futhi igweme ukusetshenziswa kabi.
Umbiko wokulethwa
Akukho nokukodwa noma ukulethwa kokugcina okunomphumela oyimpumelelo/okwehluleka okusekelwayo.
Ifomethi yombiko wokulethwa: i-id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx idethi yokuphela: yyMMddHHmm izibalo:
Amanani atholakalayo ngesimo:
- DELIVRD
- KUPHELELWE ISIKHATHI
- KWAKHIWE
- UNDELIV
- SISIWE
6.1 Ifomethi yombiko wokulethwa okunwetshiwe
Ulwazi olunwetshiwe emibikweni yokulethwa lungase lucelwe ukuthintana nomele ukuthengisa kwakho.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Amanani atholakalayo ngesimo:
- DELIVRD
- KUPHELELWE ISIKHATHI
- KWAKHIWE
- UNDELIV
- SISIWE
Izinkambu ze-“sub” kanye ne-“dlvrd” zizohlala zisethelwe kokuthi 000, futhi inkambu ethi “text” izohlala ingenalutho.
Bona isahluko Amakhodi Ephutha ngamavelu enkambu ethi "iphutha".
Izinguqulo ze-TLS ezisekelwe
I-TLS 1.2 noma i-TLS 1.3 iyadingeka kukho konke ukuxhumana kwe-TLS nge-SMPP.
Ukusekelwa kwe-TLS 1.0 kanye ne-1.1 kunqanyuliwe kusukela ngo-2020-11-15. Izinguqulo 1.0 no-1.1 ze-TLS ziyizivumelwano ezindala ezihoxisiwe futhi zibhekwa njengezingozi zokuphepha emphakathini we-inthanethi.
I-LINK incoma kakhulu ukusebenzisa i-TLS uma kusetshenziswa uxhumo lwe-SMPP olungabethelwe namuhla. Ukuxhumeka okungabetheliwe kwe-SMPP kwehlisiwe kusukela ngo-2020-09-01 yi-LINK, futhi kuzosuswa ngokuzayo. Idethi yokukhishwa kokuxhumeka okungabetheliwe ayikanqunywa.
Uxhumano oluya kuseva ye-SMPP ye-TLS lusembobeni 3601 esikhundleni sokungabethelwe ku-port 3600.
Usengasebenzisa i-TLS ngisho noma ukusebenzisa kwakho i-SMPP kungayisekeli i-TLS usebenzisa isituneli, bona https://www.stunnel.org/
Amakhodi ephutha
Amakhodi ephutha alandelayo angase aphendulwe kunkambu yephutha uma inkambu inikwe amandla.
| Ikhodi yephutha | Incazelo |
| 0 | Iphutha elingaziwa |
| 1 | Iphutha lesikhashana lomzila |
| 2 | Iphutha elingunaphakade lomzila |
| 3 | I-throttling ephezulu idluliwe |
| 4 | Isikhathi siphelile |
| 5 | Iphutha elingaziwa lomsebenzisi |
| 6 | Iphutha lomsebenzisi |
| 100 | Isevisi ayitholakali |
| 101 | Umsebenzisi akatholakali |
| 102 | I-akhawunti ayitholakali |
| 103 | Iphasiwedi engavumelekile |
| 104 | Iphutha lokumisa |
| 105 | Iphutha langaphakathi |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Ithunyelwe |
| 1001 | Kulethiwe |
| 1002 | Iphelelwe yisikhathi |
| 1003 | Kususiwe |
| 1004 | Iselula igcwele |
| 1005 | Kufakwe kulayini |
| 1006 | Akulethiwe |
| 1007 | Kulethiwe, inkokhiso ibambezelekile |
| 1008 | Ishajiwe, umlayezo awuthunyelwanga |
| 1009 | Ishajiwe, umlayezo awulethiwe |
| 1010 | Kuphelelwe yisikhathi, ukungabikho kombiko wokulethwa komsebenzisi |
| 1011 | Kushajiwe, umlayezo uthunyelwe (ku-opharetha) |
| 1012 | Ikumugqa ukude |
| 1013 | Umlayezo uthunyelwe ku-opharetha, ukushaja kubambezelekile |
| 2000 | Inombolo yomthombo engavumelekile |
| 2001 | Inombolo emfushane ayisekelwe njengomthombo |
| 2002 | I-Alpha ayisekelwe njengomthombo |
| 2003 | I-MSISDN ayisekelwe njengenombolo yomthombo |
| 2100 | Inombolo emfushane ayisekelwe njengendawo okuyiwa kuyo |
| 2101 | I-Alpha ayisekelwe njengendawo okuyiwa kuyo |
| 2102 | I-MSISDN ayisekelwe njengendawo okuyiwa kuyo |
| 2103 | Umsebenzi uvinjiwe |
| 2104 | Obhalisile ongaziwa |
| 2105 | Indawo okuyiwa kuyo ivinjiwe |
| 2106 | Iphutha lenombolo |
| 2107 | Indawo okuyiwa kuyo ivinjiwe okwesikhashana |
| 2108 | Invalid destination |
| 2200 | Iphutha lokushaja |
| 2201 | Obhalisile unebhalansi ephansi |
|
2202 |
Subscriber barred for overcharged (premium)
imiyalezo |
|
2203 |
Subscriber too young (for this particular
okuqukethwe) |
| 2204 | Obhalisile okhokhelwa kusengaphambili akavunyelwe |
| 2205 | Isevisi inqatshwe obhalisile |
| 2206 | Obhalisile akabhalisiwe ohlelweni lokukhokha |
| 2207 | Obhalisile usefinyelele ibhalansi enkulu |
| 2208 | Kudingeka ukuqinisekiswa komsebenzisi wokugcina |
| 2300 | Kubuyiselwe imali |
|
2301 |
Could not refund due to illegal or missing
I-MSISDN |
| 2302 | Ayikwazanga ukubuyisela imali ngenxa ye-ID yomlayezo engekho |
| 2303 | Kufakwe kulayini wokubuyiselwa imali |
| 2304 | Ukuphelelwa yisikhathi kokubuyiselwa kwemali |
| 2305 | Ukuhluleka ukubuyisela imali |
| 3000 | Umbhalo wekhodi we-GSM awusekelwe |
| 3001 | Umbhalo wekhodi we-UCS2 awusekelwe |
| 3002 | Umbhalo wekhodi kanambambili awusekelwe |
| 4000 | Umbiko wokulethwa awusekelwe |
| 4001 | Okuqukethwe komlayezo okungavumelekile |
| 4002 | Izindleko ezingavumelekile |
| 4003 | Idatha yomsebenzisi engavumelekile |
| 4004 | Isihloko sedatha yomsebenzisi esingavumelekile |
| 4005 | Ukubhala ngekhodi idatha okungavumelekile |
| 4006 | I-VAT engavumelekile |
| 4007 | Okuqukethwe okungasekelwe kwendawo okuyiwa kuyo |
Amadokhumenti / Izinsiza
 |
link mobility SMS API,SMPP API MS Scheduler API [pdf] Umhlahlandlela Womsebenzisi I-SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |