SMS API, SMPP API MS Scheduler API
Cov neeg siv phau ntawv qhia
SMS API, SMPP API MS Scheduler API
| Hloov kho: | 6/24/2025 |
| Version: | 1.7 |
| Tus sau: | Kenny Colander Norden, KCN |
Cov ntaub ntawv no yog rau tus neeg tau txais kev tso cai nkaus xwb thiab tej zaum yuav muaj cov ntaub ntawv muaj cai, muaj tswv, lossis lwm yam ntaub ntawv ntiag tug. Yog tias koj tau txais qhov yuam kev, thov ceeb toom rau tus neeg xa khoom tam sim ntawd thiab tshem tawm qhov qub. Lwm yam kev siv cov ntaub ntawv los ntawm koj yog txwv tsis pub.
Hloov keeb kwm
| Rev | Hnub tim | By | Hloov ntawm qhov kev tso tawm dhau los |
| 1.0 | 2010-03-16 Ib | KCN | Tsim |
| 1. | 2019-06-11 Ib | TPE | Hloov kho LINK logos |
| 1. | 2019-09-27 Ib | PNI | Ntxiv siv rau SMPP 3.4 specification |
| 1. | 2019-10-31 Ib | EP | Kev soj ntsuam txog lub sijhawm siv tau tag |
| 1. | 2020-08-28 Ib | KCN | Ntxiv cov ntaub ntawv hais txog kev txhawb TLS versions |
| 2. | 2022-01-10 Ib | KCN | Ntxiv cov ntaub ntawv ntxiv txog kev xa khoom xa tuaj Hloov tshiab cov ntaub ntawv hais txog TLS 1.3 |
| 2. | 2025-06-03 Ib | GM | Ntxiv cov txiaj ntsig code 2108 |
| 2. | 2025-06-24 Ib | AK | Ntxiv quota |
Taw qhia
LINK Mobility tau ua tus xa xov SMS txij li xyoo 2001 thiab muaj kev paub ntau hauv kev ua haujlwm nrog ob tus neeg ua haujlwm thiab cov neeg sib txuas sib txuas. Lub platform no yog tsim los tswj cov tsheb loj, tswj kom muaj ntau yam thiab ua kom yooj yim rau kev khiav tsheb los ntawm ntau qhov kev sib txuas.
Qhov no yog cov ntaub ntawv piav qhia txog SMPP interface rau SMSC-platform thiab cov kev txwv thiab cov lus txib uas yuav tsum tau ua thiab cov kev txwv twg tau txais kev txhawb nqa.
Cov ntaub ntawv no yuav tsis daws cov teeb meem siv tshwj xeeb xws li cov lus sib txuas, WAPPush, Flash SMS, thiab lwm yam. Cov ntaub ntawv ntxiv txog cov xwm txheej no tuaj yeem muab los ntawm kev hu rau kev txhawb nqa.
Txhawb cov lus txib
LINK Mobility tus neeg rau zaub mov yuav tsum raug kho raws li SMPP 3.4. Lub official specification tuaj yeem pom ntawm https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Txhua txoj hauv kev tsis tau txais kev txhawb nqa, thiab txhua qhov sib txawv tau teev tseg hauv qab no.
4.1 Sib
Cov lus txib hauv qab no tau txais kev txhawb nqa.
- Transmitter
- Transceiver
- Tus txais
Yuav tsum tau parameter:
- system_id – tau los ntawm kev txhawb nqa
- password – tau los ntawm kev txhawb nqa
Optional parameters:
- addr_ton – default value yog TON yog teem rau Unknown thaum xa.
- addr_npi – default value is NPI is set to Unknown when send.
Unsupported parameters:
- chaw nyob_range
4.2 Unbind
Cov lus txib unbind tau txais kev txhawb nqa.
4.3 Nug link
Cov lus nug txuas txuas tau txais kev txhawb nqa thiab yuav tsum raug hu txhua 60 vib nas this.
4.4 Xa
Txoj kev xa yuav tsum tau siv los xa cov lus.
Yuav tsum tau parameter:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_ntev
- luv_message
Unsupported parameters:
- service_type
- protocol_id
- priority_flag
- teem_delivery_time
- hloov_if_present_flag
- sm_default_msg_id
Nco tseg uas payload tag tsis tau txais kev txhawb nqa thiab tsuas yog ib qho SMS tuaj yeem xa tuaj rau ib qho kev hu thiab nws raug pom zoo tias lub sijhawm siv tau tag muaj tus nqi ntawm 15 feeb ntev yam tsawg kawg nkaus.
4.4.1 Pom zoo TON thiab NPI
Cov nram qab no TON thiab NPI yuav tsum tau siv thaum xa cov lus siv xa cov lus txib.
4.4.1.1 Tau qhov twg los
Cov nram qab no TON thiab NPI kev sib txuas tau txais kev txhawb nqa rau qhov chaw nyob. Tag nrho lwm cov kev sib xyaw ua ke yuav raug kho raws li qhov tsis raug. Lub neej ntawd TON los ntawm khi lus txib yuav raug siv yog TON raug teeb tsa rau Unknown (0). Lub neej ntawd NPI los ntawm khi lus txib yuav raug siv yog tias NPI raug teeb tsa rau Unknown (0).
| TON | NPI | Kev piav qhia |
| Alphanumeric (5) | Tsis paub (0) ISDN (1) |
Yuav raug kho raws li Alphanumeric sender text |
| International (1) | Tsis paub (0) ISDN (1) |
Yuav raug kho raws li MSISDN |
| National (2) Network tshwj xeeb (3) Tus neeg siv npe (4) Abbreviated (6) |
Tsis paub (0) ISDN (1) National (8) |
Yuav raug kho raws li lub teb chaws tus lej luv luv. |
4.4.1.2 Destination
Cov nram qab no TON thiab NPI kev sib txuas tau txais kev txhawb nqa rau qhov chaw nyob. Tag nrho lwm cov kev sib xyaw ua ke yuav raug kho raws li qhov tsis raug. Lub neej ntawd TON los ntawm khi lus txib yuav raug siv yog TON raug teeb tsa rau Unknown (0). Lub neej ntawd NPI los ntawm khi lus txib yuav raug siv yog tias NPI raug teeb tsa rau Unknown (0).
| TON | NPI | Kev piav qhia |
| International (1) | Tsis paub (0) ISDN (1) |
Yuav raug kho raws li MSISDN |
4.4.2 Txhawb encodings
Cov encoding hauv qab no tau txais kev txhawb nqa. X tej zaum yuav muaj cov nqi.
| DCS | Encoding |
| 0x0 ib | Default GSM Cov tsiaj ntawv nrog txuas ntxiv |
| 0x2 ib | 8-ntsis binary |
| 0x8 ib | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Quota Tshajview
Ib qho quota txhais cov xov tooj ntawm SMS ntau tshaj plaws uas tuaj yeem xa tuaj tsis pub dhau lub sijhawm ib ntus (xws li ib hnub, lub lis piam, hli, lossis tsis tas li). Txhua qhov quota yog cim tshwj xeeb los ntawm quotaId (UUID) thiab rov pib dua raws li tus neeg siv khoom lub sijhawm. Quotas tuaj yeem raug muab rau hauv lub tebchaws, cheeb tsam, lossis theem pib los ntawm Quota Profile. Quota kuj tseem tuaj yeem raug xa mus siv Quota Mapping. Qhov no qhia txog tus niam txiv QuotaId (UUID) thiab tus lej cim tshwj xeeb (xws li, tus xa lossis tus neeg siv) rau ib qho tshwj xeeb quotaId.
Ib qho quota tau teeb tsa raws li koj qhov kev txhawb nqa hauv zos, koj tus thawj tswj hwm tus account los yog lub neej ntawd yog tias tsis muaj dab tsi teev tseg.
5.2 Txoj Cai 106 – Quota Tshaj
Cov lus SMS yuav raug thaiv nrog cov xwm txheej 106 ("quota tshaj") thaum:
- Cov lus tshaj li qhov txwv tsis pub dhau rau nws cov quotaId sib thooj nyob rau lub sijhawm tam sim no.
- Lub teb chaws lo lus uas peb los yog cheeb tsam tsis muaj quota muab (piv txwv li, yog qhia meej thaiv nrog ib tug null quota daim ntawv qhia nyob rau hauv lub profile).
- Tsis muaj qhov sib piv quota thiab tsis muaj quota default yog txhais, ua rau tsis lees paub.
Hauv cov xwm txheej no, lub kaw lus tiv thaiv kev xa xov txuas ntxiv los tswj cov neeg siv khoom lossis cov kev txwv raws li qhov chaw thiab zam kev siv tsis raug.
Kev xa khoom xa tuaj
Tsuas yog tsis muaj lossis qhov kawg xa nrog qhov ua tiav / tsis ua tiav tau txais kev txhawb nqa.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx done date: yyMMddHHmm stat:
Muaj nuj nqis nyob rau hauv cov xwm txheej:
- DELIVRD
- EXPIRED
- REJECTD
- UNDELIV
- DELEETED
6.1 Extended delivery format report
Cov ntaub ntawv txuas ntxiv hauv cov ntawv tshaj tawm xa tuaj yuav raug thov kom tiv tauj nrog koj tus neeg muag khoom.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub: 000 dlvrd: 000 xa hnub:
yyMMddHHmm ua tiav hnub: yyMMddHHmm stat: yuam kev: ntawv:
Muaj nuj nqis nyob rau hauv cov xwm txheej:
- DELIVRD
- EXPIRED
- REJECTD
- UNDELIV
- DELEETED
"sub" thiab "dlvrd" teb yuav ib txwm raug teeb tsa rau 000, thiab "ntawv" teb yuav ib txwm tsis muaj.
Saib tshooj Error codes rau qhov tseem ceeb rau qhov "yuam kev" teb.
Txhawb TLS versions
TLS 1.2 lossis TLS 1.3 yuav tsum muaj rau txhua qhov kev sib txuas ntawm TLS hla SMPP.
Kev them nyiaj yug rau TLS 1.0 thiab 1.1 raug txiav tawm txij li xyoo 2020-11-15. Versions 1.0 thiab 1.1 ntawm TLS yog cov txheej txheem qub uas tau raug tshem tawm thiab raug suav tias yog kev pheej hmoo kev nyab xeeb hauv zej zog Is Taws Nem.
LINK xav kom siv TLS yog tias tsis muaj kev sib txuas SMPP tsis tau siv niaj hnub no. Unencrypted SMPP kev sib txuas yog deprecated li ntawm 2020-09-01 los ntawm LINK, thiab yuav raug tshem tawm yav tom ntej. Hnub rau unencrypted kev sib txuas tshem tawm tseem tsis tau txiav txim siab.
Kev sib txuas ntawm SMPP server rau TLS yog ntawm chaw nres nkoj 3601 es tsis txhob muab zais ntawm chaw nres nkoj 3600.
Koj tseem tuaj yeem siv TLS txawm tias koj qhov kev siv SMPP tsis txhawb TLS siv stunnel, saib https://www.stunnel.org/
Cov lej yuam kev
Cov lej yuam kev hauv qab no tuaj yeem teb rau hauv qhov yuam kev yog tias lub teb tau qhib.
| yuam kev code | Kev piav qhia |
| 0 | Unknown yuam kev |
| 1 | Ib ntus routing yuam kev |
| 2 | Permanent routing yuam kev |
| 3 | Qhov siab tshaj plaws throttling tshaj |
| 4 | Sijhawm |
| 5 | Tus neeg teb xov tooj tsis paub qhov yuam kev |
| 6 | Tus neeg ua haujlwm yuam kev |
| 100 | Kev pabcuam tsis pom |
| 101 | Tus neeg siv tsis pom |
| 102 | Tsis pom tus account |
| 103 | Tus password tsis raug |
| 104 | Configuration yuam kev |
| 105 | Internal yuam kev |
| 106 | Quota tshaj |
| 200 | OK |
| 1000 | Xa |
| 1001 | Muab xa tuaj |
| 1002 | tas sij hawm |
| 1003 | Rho tawm |
| 1004 | Txawb tag nrho |
| 1005 | Nquag |
| 1006 | Tsis xa |
| 1007 | Xa, them qeeb |
| 1008 | Them nqi, lus tsis xa |
| 1009 | Them nqi, lus tsis xa |
| 1010 | Ncua sij hawm, tsis muaj tus neeg teb xov tooj ceeb toom xa khoom |
| 1011 | Them, lus xa (rau tus neeg teb xov tooj) |
| 1012 | Tej thaj chaw deb queued |
| 1013 | Cov lus xa mus rau tus neeg teb xov tooj, them nqi qeeb |
| 2000 | Invalid qhov chaw naj npawb |
| 2001 | Tus lej luv tsis raug txhawb raws li qhov chaw |
| 2002 | Alpha tsis txhawb los ua qhov chaw |
| 2003 | MSISDN tsis tau txais kev txhawb nqa raws li tus lej |
| 2100 | Tus lej luv tsis raug txhawb raws li qhov chaw |
| 2101 | Alpha tsis txhawb raws li qhov chaw |
| 2102 | MSISDN tsis raug txhawb raws li qhov chaw |
| 2103 | Kev ua haujlwm thaiv |
| 2104 | Unknown subscriber |
| 2105 | Qhov chaw thaiv |
| 2106 | Tus lej yuam kev |
| 2107 | Lub hom phiaj tau thaiv ib ntus |
| 2108 | Qhov chaw tsis raug |
| 2200 | Kev them nyiaj yuam kev |
| 2201 | Cov neeg siv khoom muaj nyiaj tshuav tsawg |
|
2202 |
Cov neeg siv khoom txwv tsis pub them nyiaj tshaj (hwm)
lus |
|
2203 |
Subscriber hluas dhau (rau qhov tshwj xeeb no
cov ntsiab lus) |
| 2204 | Prepaid subscriber tsis tso cai |
| 2205 | Kev pabcuam tsis lees paub los ntawm tus neeg siv khoom |
| 2206 | Tus neeg siv khoom tsis tau sau npe hauv kev them nyiaj |
| 2207 | Cov neeg siv khoom tau mus txog qhov nyiaj tshuav max |
| 2208 | Xaus neeg siv kev pom zoo xav tau |
| 2300 | Rov qab |
|
2301 |
Tsis tuaj yeem thim rov qab vim tsis raug cai lossis ploj lawm
MSISDN |
| 2302 | Tsis tuaj yeem thim rov qab vim tsis muaj messageId |
| 2303 | Queued rau refund |
| 2304 | Rov qab sijhawm |
| 2305 | Rov qab ua tsis tiav |
| 3000 | GSM encoding tsis txaus siab |
| 3001 | UCS2 encoding tsis txaus siab |
| 3002 | Binary encoding tsis txaus siab |
| 4000 | Kev xa ntawv tsis txaus siab |
| 4001 | Cov ntsiab lus tsis raug |
| 4002 | Cov nqi se tsis raug |
| 4003 | Cov ntaub ntawv siv tsis raug |
| 4004 | Invalid user data header |
| 4005 | Invalid data coding |
| 4006 | Invalid VAT |
| 4007 | Cov ntsiab lus tsis txhawb nqa rau qhov chaw |
Cov ntaub ntawv / Cov ntaub ntawv
 |
txuas mus rau SMS API, SMPP API MS Scheduler API [ua pdf] Cov neeg siv phau ntawv qhia SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |