SMS API,SMPP API MS Scheduler API
User Guide
SMS API,SMPP API MS Scheduler API
| Zvakagadziridzwa | 6/24/2025 |
| Shanduro: | 1.7 |
| Munyori: | Kenny Colander Norden, KCN |
Gwaro iri nderemugamuchiri akasarudzwa chete uye rinogona kunge riine ruzivo rwakasiyana, rwemuridzi, kana rumwe ruzivo rwepachivande. Kana wakaigamuchira nekukanganisa, ndapota zivisa mutumiri nekukurumidza uye bvisa yekutanga. Chero kumwe kushandiswa kwegwaro newe kunorambidzwa.
Chinja nhoroondo
| Rev | Date | By | Shanduko kubva pakuburitswa kwekare |
| 1.0 | 2010-03-16 | KCN | Created |
| 1. | 2019-06-11 | TPE | Yakagadziridzwa LINK malogo |
| 1. | 2019-09-27 | PNI | Yakawedzerwa chirevo kune SMPP 3.4 yakatarwa |
| 1. | 2019-10-31 | EP | Kuona nezve nguva yechokwadi tag |
| 1. | 2020-08-28 | KCN | Yakawedzera ruzivo nezve inotsigirwa TLS shanduro |
| 2. | 2022-01-10 | 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 |
Nhanganyaya
LINK Kufamba kwave kuri mushambadzi weSMS kubva 2001 uye ane ruzivo rwakanyanya mukushanda nevashandisi vese uye vanobatanidza aggregator. Iyi puratifomu yakagadzirirwa kubata hombe traffic mavhoriyamu, kuchengetedza kuwanikwa kwepamusoro uye kuita kuti zvive nyore kufambisa traffic kuburikidza nekubatanidza akawanda.
This is document describes the SMPP interface to the SMSC-platform and which parameters and commands that are required and which parameters are supported.
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.
Mirairo inotsigirwa
LINK Mobility's server inofanirwa kubatwa seSMPP 3.4. Iyo yepamutemo yakatarwa inogona kuwanikwa pa https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Nzira dzese hadzitsigirwe, uye misiyano yese inotsanangurwa pazasi.
4.1 Band
Iyo inotevera bind mirairo inotsigirwa.
- Transmitter
- transciever
- Receiver
Zvinodiwa parameters:
- system_id - yakawanikwa kubva kune rutsigiro
- password - yakawanikwa kubva kune rutsigiro
Optional parameters:
- addr_ton - default value kana TON yakaiswa kuUsingazivikanwe panguva yekutumira.
- addr_npi - default kukosha kana NPI yakaiswa kune Unknown panguva yekutumira.
Maparamita asina kutsigirwa:
- address_range
4.2 Bvisa
Iyo unbind command inotsigirwa.
4.3 Bvunza link
Iyo yekubvunza yekubatanidza yekuraira inotsigirwa uye inofanirwa kudaidzwa ese makumi matanhatu masekonzi.
4.4 Tumira
Nzira yekutumira inofanira kushandiswa pakutumira mameseji.
Zvinodiwa parameters:
- source_addr_ton
- source_addr_npi
- source_add
- dest_addr_ton
- des_addr_npi
- des_addr
- esm_class
- data_coding
- sm_length
- pfupi_message
Maparamita asina kutsigirwa:
- service_type
- protocol_id
- priority_flag
- schedule_delivery_time
- replace_if_present_flag
- sm_default_msg_id
Cherechedza kuti payload tag haitsigirwe uye SMS imwe chete inogona kuunzwa parunhare uye zvinokurudzirwa kuti iyo validity_period tag ine kukosha kwemaminetsi gumi nemashanu kureba kanenge.
4.4.1 Inokurudzirwa TON neNPI
Inotevera TON neNPI inofanira kushandiswa pakutumira mameseji uchishandisa tuma command.
4.4.1.1 Kwakabva
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).
| TON | NPI | Tsanangudzo |
| Alphanumeric (5) | Hazvizivikanwe (0) ISDN (1) |
Ichabatwa seAlphanumeric sender text |
| Zvenyika Dzese (1) | Hazvizivikanwe (0) ISDN (1) |
Ichabatwa seMSISDN |
| Nyika (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
Hazvizivikanwe (0) ISDN (1) Nyika (8) |
Ichabatwa senyika chaiyo nhamba pfupi. |
4.4.1.2 Kwaunoenda
Masanganiswa eTON neNPI anotevera anotsigirwa kero yekuenda. Mamwe masanganiswa ese achabatwa seasina basa. Iyo yakasarudzika TON kubva mubhaind command ichashandiswa kana TON yakaiswa kuUsingazivikanwe (0). Iyo yakasarudzika NPI kubva kubhaind command ichashandiswa kana NPI yakaiswa kuUsingazivikanwe (0).
| TON | NPI | Tsanangudzo |
| Zvenyika Dzese (1) | Hazvizivikanwe (0) ISDN (1) |
Ichabatwa seMSISDN |
4.4.2 Encodings inotsigirwa
Maencodings anotevera anotsigirwa. X inogona kunge iine chero kukosha.
| DCS | Encoding |
| 0xX0 | Default GSM Alphabet ine kuwedzera |
| 0xX2 | 8-bit bhaari |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Quota 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.
A quota is set in accordance with your local support, your assigned account manager or by default if nothing is specified.
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.
In these cases, the system prevents further message processing to enforce customer or destination-based limits and avoid misuse.
Delivery report
Hapana chete kana kuendesa kwekupedzisira nekubudirira / kutadza mhedzisiro inotsigirwa.
Format pamushumo wekutumira: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx zuva raitwa: yyMMddHHmm stat:
Huripo huripo muchimiro:
- DELIVRD
- EXPIRED
- KURAMBA
- UNDELIV
- DELETED
6.1 Yakawedzerwa kuburitsa mushumo fomati
Ruzivo rwakawedzerwa mumishumo yekutumira inogona kukumbirwa kuonana nemumiriri wako wekutengesa.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
Huripo huripo muchimiro:
- DELIVRD
- EXPIRED
- KURAMBA
- UNDELIV
- DELETED
"sub" uye "dlvrd" ndima dzinogara dzakaiswa ku000, uye "text" ndima inogara isina chinhu.
Ona chitsauko Error codes yemhando dze "err" ndima.
Inotsigira TLS shanduro
TLS 1.2 kana TLS 1.3 inodiwa kune ese TLS yekubatanidza pamusoro peSMPP.
Tsigiro yeTLS 1.0 uye 1.1 yakamiswa kubva 2020-11-15. Mavhezheni 1.0 uye 1.1 eTLS mapuroteni akare akaregwa uye anoonekwa senjodzi yekuchengetedza munharaunda yeInternet.
LINK inokurudzira zvakasimba kushandisa TLS kana isina kuvharirwa SMPP yekubatanidza iri kushandiswa nhasi. Maunganidzo asina kuvharidzirwa eSMPP akaregwa kubva muna 2020-09-01 neLINK, uye achabviswa mune ramangwana. Zuva rekubviswa kwekubatanidza kusina kunyorwa harisati rasarudzwa.
Manongedzo akananga kuSMPP server yeTLS iri pachiteshi 3601 pane isina kunyorwa pachiteshi 3600.
Unogona kushandisa TLS kunyangwe kuita kwako kweSMPP kusingatsigire TLS uchishandisa stunnel, ona https://www.stunnel.org/
Makodhi ezvikanganiso
Makodhi ekukanganisa anotevera anogona kupindurwa mundima yekukanganisa kana munda ukagoneswa.
| Kodhi yezvikanganiso | Tsanangudzo |
| 0 | Kukanganisa kusingazivikanwe |
| 1 | Kutadza kwekufamba kwenguva |
| 2 | Kukanganisa kwechigarire |
| 3 | Maximum throttling yadarika |
| 4 | Nguva yapera |
| 5 | Operator haazivikanwi kukanganisa |
| 6 | Kukanganisa kwemushandisi |
| 100 | Sevhisi haina kuwanikwa |
| 101 | Mushandisi haana kuwanikwa |
| 102 | Akaunti haina kuwanikwa |
| 103 | password isiriyo |
| 104 | Configuration kukanganisa |
| 105 | Kukanganisa kwemukati |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | Sent |
| 1001 | Delivered |
| 1002 | Yapera |
| 1003 | Dzadzimwa |
| 1004 | Mobile full |
| 1005 | Queued |
| 1006 | Haina kuendeswa |
| 1007 | Kuendeswa, kuchaja kwanonoka |
| 1008 | Yakachajwa, meseji haina kutumirwa |
| 1009 | Yakachajwa, meseji haina kusvitswa |
| 1010 | Yapera, kusavapo kwemushumo wekutumira opareta |
| 1011 | Yakachajwa, meseji inotumirwa (kune opareta) |
| 1012 | Iri kure kure |
| 1013 | Meseji inotumirwa kumushandisi, kuchaja kwanonoka |
| 2000 | Nhamba yekwakabva haisiriyo |
| 2001 | Nhamba pfupi haitsigirwe sekwabva |
| 2002 | Alpha haitsigirwe senzvimbo |
| 2003 | MSISDN haitsigirwe senhamba yekwakabva |
| 2100 | Nhamba pfupi haitsigirwe sekwainoenda |
| 2101 | Alpha haitsigirwe sekwainoenda |
| 2102 | MSISDN haitsigirwe sekwainoenda |
| 2103 | Operation yakavharwa |
| 2104 | Munyoreri asingazivikanwe |
| 2105 | Kwavharwa |
| 2106 | Kukanganisa kwenhamba |
| 2107 | Kwavharwa kwenguva pfupi |
| 2108 | Invalid destination |
| 2200 | Pachaja kukanganisa |
| 2201 | Munyoreri ane mwero wakaderera |
|
2202 |
Subscriber barred for overcharged (premium)
mameseji |
|
2203 |
Subscriber too young (for this particular
zvemukati) |
| 2204 | Munhu anobhadhara kare haabvumirwi |
| 2205 | Sevhisi yarambwa neanonyoresa |
| 2206 | Munyoreri asina kunyoreswa mubhadharo system |
| 2207 | Munyoreri asvika pachiyero chepamusoro |
| 2208 | Kupedzisa mushandisi simbiso inodiwa |
| 2300 | Kudzoserwa mari |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | Hatina kukwanisa kudzosera mari nekuda kwemesejiId isipo |
| 2303 | Yakaiswa mumutsara kuti idzoserwe mari |
| 2304 | Nguva yekudzosera mari |
| 2305 | Kutadza kwekudzorera mari |
| 3000 | GSM encoding haitsigirwe |
| 3001 | UCS2 encoding haitsigirwe |
| 3002 | Binary encoding haitsigirwe |
| 4000 | Mushumo wekutumira hautsigirwe |
| 4001 | Zvemukati memeseji isiriyo |
| 4002 | Mutero haushandi |
| 4003 | Data yevashandisi isiriyo |
| 4004 | Musoro wedata haushandi |
| 4005 | Kukodha data hakusiko |
| 4006 | VAT haisiriyo |
| 4007 | Zvisiri kutsigirwa zvekwauri kuenda |
Zvinyorwa / Zvishandiso
 |
link mobility SMS API,SMPP API MS Scheduler API [pdf] Bhuku reMushandisi SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |