SMS API,SMPP API MS Scheduler API
Wogwiritsa Ntchito
SMS API,SMPP API MS Scheduler API
| Zosinthidwa: | 6/24/2025 |
| Mtundu: | 1.7 |
| Wolemba: | Kenny Colander Norden, KCN |
Chikalatachi ndi cha womulandira yekhayo ndipo chikhoza kukhala ndi zina mwamwayi, zaumwini, kapena zachinsinsi. Ngati mwachilandira molakwika, chonde dziwitsani wotumizayo nthawi yomweyo ndikuchotsa choyambirira. Kugwiritsa ntchito kwina kulikonse kwa chikalata ndi inu ndikoletsedwa.
Sinthani mbiri
| Rev | Tsiku | By | Zosintha kuchokera ku zomwe zidatulutsidwa m'mbuyomu |
| 1.0 | 2010-03-16 | Mtengo wa KCN | Adapangidwa |
| 1. | 2019-06-11 | TPE | Ma logo asinthidwa |
| 1. | 2019-09-27 | PNI | Kufotokozera kowonjezera kwa SMPP 3.4 |
| 1. | 2019-10-31 | EP | Kuwona za nthawi yovomerezeka tag |
| 1. | 2020-08-28 | Mtengo wa KCN | Zowonjezera zokhudzana ndi mitundu yothandizidwa ya TLS |
| 2. | 2022-01-10 | Mtengo wa KCN | Anawonjezera zina zokhuza malipoti otumizira Zambiri zosinthidwa zokhudzana ndi TLS 1.3 |
| 2. | 2025-06-03 | GM | Chotsatira chowonjezera nambala 2108 |
| 2. | 2025-06-24 | AK | Magawo owonjezera |
Mawu Oyamba
LINK Mobility wakhala akufalitsa ma SMS kuyambira 2001 ndipo ali ndi chidziwitso chogwira ntchito ndi onse ogwira ntchito ndi ophatikiza ma intaneti. Pulatifomuyi idapangidwa kuti izitha kuthana ndi kuchuluka kwa magalimoto ambiri, kusunga kupezeka kwakukulu ndikupangitsa kuti ikhale yosavuta kuyendetsa magalimoto kudzera pamalumikizidwe angapo.
Ichi ndi chikalata chofotokoza mawonekedwe a SMPP ku nsanja ya SMSC ndi magawo ndi malamulo omwe amafunikira komanso magawo omwe amathandizidwa.
Chikalatachi sichigwira ntchito zinazake ngati mauthenga olumikizana, WAPpush, Flash SMS, ndi zina zambiri. Zambiri zokhudzana ndi milanduyi zitha kuperekedwa polumikizana ndi chithandizo.
Malamulo ochirikizidwa
Seva ya LINK Mobility iyenera kutengedwa ngati SMPP 3.4. Mafotokozedwe ovomerezeka angapezeke pa https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Njira zonse sizimathandizidwa, ndipo zosiyana zonse zafotokozedwa pansipa.
4.1 Kumanga
Malamulo otsatirawa amangiriridwa amathandizidwa.
- Wotumiza
- Transciever
- Wolandira
Zofunikira:
- system_id - yotengedwa kuchokera ku chithandizo
- password - yotengedwa kuchokera ku chithandizo
Zosankha zosafunikira:
- addr_ton - mtengo wokhazikika ngati TON yakhazikitsidwa ku Unknown pakutumiza.
- addr_npi - mtengo wokhazikika ngati NPI yakhazikitsidwa ku Unknown pakutumiza.
Zosagwirizana ndi magawo:
- adilesi_mtundu
4.2 Chotsani
Lamulo la unbind limathandizidwa.
4.3 Funsani ulalo
Lamulo lofunsira limathandizidwa ndipo liyenera kuyitanidwa masekondi 60 aliwonse.
4.4 Perekani
Njira yotumizira iyenera kugwiritsidwa ntchito popereka mauthenga.
Zofunikira:
- gwero_addr_ton
- gwero_addr_npi
- gwero_owonjezera
- dest_addr_ton
- dest_addr_npi
- onse_addr
- esm_kalasi
- data_coding
- sm_utali
- mwachidule_uthenga
Zosagwirizana ndi magawo:
- service_mtundu
- protocol_id
- priority_flag
- schedule_delivery_time
- replace_if_present_flag
- sm_default_msg_id
Zindikirani kuti malipiro tag sichirikizidwa ndipo SMS imodzi yokha ingatumizidwe pa foni iliyonse ndipo tikulimbikitsidwa kuti validity_period tag ali ndi mtengo wa mphindi 15 kutalika osachepera.
4.4.1 TON yovomerezeka ndi NPI
TON ndi NPI zotsatirazi ziyenera kugwiritsidwa ntchito potumiza mauthenga pogwiritsa ntchito kutumiza.
4.4.1.1 Gwero
Zophatikiza zotsatirazi za TON ndi NPI zimathandizidwa ndi adilesi yoyambira. Zosakaniza zina zonse zidzatengedwa ngati zosavomerezeka. TON yosasinthika kuchokera ku bind command idzagwiritsidwa ntchito ngati TON yakhazikitsidwa ku Unknown (0). NPI yosasinthika kuchokera ku bind command idzagwiritsidwa ntchito ngati NPI yakhazikitsidwa ku Unknown (0).
| TON | NPI | Kufotokozera |
| Zilembo ndi nambala (5) | Zosadziwika (0) ISDN (1) |
Adzatengedwa ngati mawu otumiza a Alphanumeric |
| Mayiko (1) | Zosadziwika (0) ISDN (1) |
Adzatengedwa ngati MSISDN |
| Dziko (2) Netiweki yeniyeni (3) Nambala yolembetsa (4) Mwachidule (6) |
Zosadziwika (0) ISDN (1) Dziko (8) |
Idzatengedwa ngati nambala yachidule ya dziko. |
4.4.1.2 Kopita
Zophatikiza zotsatirazi za TON ndi NPI zimathandizidwa ndi ma adilesi omwe mukupita. Zosakaniza zina zonse zidzatengedwa ngati zosavomerezeka. TON yosasinthika kuchokera ku bind command idzagwiritsidwa ntchito ngati TON yakhazikitsidwa ku Unknown (0). NPI yosasinthika kuchokera ku bind command idzagwiritsidwa ntchito ngati NPI yakhazikitsidwa ku Unknown (0).
| TON | NPI | Kufotokozera |
| Mayiko (1) | Zosadziwika (0) ISDN (1) |
Adzatengedwa ngati MSISDN |
4.4.2 Ma encodings othandizira
Ma encodings otsatirawa amathandizidwa. X ikhoza kukhala ndi mtengo uliwonse.
| DCS | Encoding |
| 0xx0 pa | Zilembo zofikira za GSM zokhala ndi zowonjezera |
| 0xx2 pa | 8-bit binary |
| 0xx8 pa | UCS2 (ISO-10646-UCS-2) |
Gawo
5.1 Quota Yathaview
Chiwerengero chimatanthawuza kuchuluka kwa mauthenga a SMS omwe angatumizidwe mkati mwa nthawi yodziwika (monga tsiku, sabata, mwezi, kapena kosatha). Gawo lililonse limazindikiridwa mwapadera ndi quotaId (UUID) ndipo imasinthidwanso malinga ndi nthawi ya kasitomala. Magawo atha kuperekedwa mdziko, dera, kapena mulingo wokhazikika kudzera mu Quota Profile. Gawo litha kuperekedwanso mwachangu pogwiritsa ntchito Quota Mapping. Izi zimayika QuotaId (UUID) ya kholo ndi Kiyi yagawo yapadera (monga wotumiza kapena wogwiritsa) ku quotaId inayake.
Chigawo chimayikidwa molingana ndi thandizo lanu lapafupi, woyang'anira akaunti yomwe mwapatsidwa kapena mwachisawawa ngati palibe chomwe chafotokozedwa.
5.2 Mkhalidwe 106 - Gawo Lapitilira
Mauthenga a SMS akhoza kutsekedwa ndi nambala 106 ("quota yadutsa") pamene:
- Uthengawu umadutsa malire omwe afotokozedwa a quotaId yogwirizana ndi nthawi yomwe ilipo.
- Dziko kapena dera lomwe mukupita lilibe magawo omwe apatsidwa (ie, atsekeredwa mwatsatanetsatane ndi mapu opanda kanthu mu pro.file).
- Palibe gawo lofananira ndipo palibe gawo losasinthika lomwe limafotokozeredwa, zomwe zimapangitsa kukanidwa.
Zikatere, dongosololi limalepheretsa kusinthidwa kwa mauthenga kuti akhazikitse makasitomala kapena malire otengera komwe akupita ndikupewa kugwiritsa ntchito molakwika.
Lipoti la kutumiza
Palibe kapena kubweretsa komaliza kokhala ndi zotsatira zopambana/zolephera zomwe zimathandizidwa.
Fomu ya lipoti lotumizira: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx deti lomaliza: yyMMddHHmm stat:
Makhalidwe omwe alipo:
- DELIVRD
- YATHA
- AKANA
- UNDELIV
- ZAFUTWA
6.1 Mtundu wowonjezera wa lipoti loperekera
Zowonjezera mu malipoti obweretsera zitha kufunsidwa polumikizana ndi woyimira malonda.
Mtundu wa lipoti lotumiza: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 tsiku lotumiza:
yyMMddHHmm tsiku lomaliza: yyMMddHHmm ziwerengero: cholakwika: mawu:
Makhalidwe omwe alipo:
- DELIVRD
- YATHA
- AKANA
- UNDELIV
- ZAFUTWA
"sub" ndi "dlvrd" minda idzakhazikitsidwa nthawi zonse ku 000, ndipo gawo la "text" lidzakhala lopanda kanthu.
Onani mutu Makhodi olakwika azinthu za "zolakwika".
Zothandizira za TLS
TLS 1.2 kapena TLS 1.3 ndiyofunika pamalumikizidwe onse a TLS pa SMPP.
Thandizo la TLS 1.0 ndi 1.1 lathetsedwa kuyambira 2020-11-15. Mitundu 1.0 ndi 1.1 ya TLS ndi ma protocol akale omwe adasiyidwa ndipo amawonedwa ngati zoopsa zachitetezo pagulu la intaneti.
LINK imalimbikitsa kwambiri kugwiritsa ntchito TLS ngati ma SMPP olumikizidwa akugwiritsidwa ntchito masiku ano. Maulaliki osabisidwa a SMPP adatsitsidwa kuyambira 2020-09-01 ndi LINK, ndipo adzachotsedwa mtsogolo. Tsiku lochotsa maulumikizidwe osabisika silinaganizidwe.
Malumikizidwe opita ku seva ya SMPP ya TLS ali padoko 3601 m'malo mosungidwa padoko 3600.
Mutha kugwiritsabe ntchito TLS ngakhale kukhazikitsa kwanu kwa SMPP sikugwirizana ndi TLS pogwiritsa ntchito stunnel, onani https://www.stunnel.org/
Zizindikiro zolakwika
Zizindikiro zotsatirazi zitha kuyankhidwa m'gawo lolakwika ngati gawolo litayatsidwa.
| Khodi yolakwika | Kufotokozera |
| 0 | Cholakwika chosadziwika |
| 1 | Vuto lakanthawi kochepa |
| 2 | Vuto losatha |
| 3 | Kuthamanga kwambiri kwadutsa |
| 4 | Lekeza panjira |
| 5 | Cholakwika chosadziwika kwa opareta |
| 6 | Vuto la opareta |
| 100 | Ntchito sizinapezeke |
| 101 | Wogwiritsa sanapezeke |
| 102 | Akaunti sinapezeke |
| 103 | Mawu achinsinsi osalondola |
| 104 | Vuto la kasinthidwe |
| 105 | Cholakwika chamkati |
| 106 | Gawo ladutsa |
| 200 | OK |
| 1000 | Watumizidwa |
| 1001 | Zaperekedwa |
| 1002 | Zatha ntchito |
| 1003 | Zachotsedwa |
| 1004 | Mobile zonse |
| 1005 | Ali pamzere |
| 1006 | Osaperekedwa |
| 1007 | Zaperekedwa, ndalama zachedwetsedwa |
| 1008 | Ndilipitsidwa, uthenga sunatumizidwe |
| 1009 | Ndilipitsidwa, uthenga sunaperekedwe |
| 1010 | Yatha, palibe lipoti la operekera |
| 1011 | Kulipitsidwa, uthenga watumizidwa (kwa wogwiritsa ntchito) |
| 1012 | Yakhala pamzere patali |
| 1013 | Uthenga watumizidwa kwa wogwiritsa ntchito, kulipiritsa kwachedwetsedwa |
| 2000 | Nambala yochokera yolakwika |
| 2001 | Nambala yaifupi siyikuthandizidwa ngati gwero |
| 2002 | Alpha sagwirizana ngati gwero |
| 2003 | MSISDN sichirikizidwa ngati nambala yoyambira |
| 2100 | Nambala yaifupi siyikupezeka ngati kopita |
| 2101 | Alpha sagwirizana ngati kopita |
| 2102 | MSISDN siyothandiza ngati kopita |
| 2103 | Ntchito yaletsedwa |
| 2104 | Wolembetsa wosadziwika |
| 2105 | Kopita kwaletsedwa |
| 2106 | Nambala yalakwika |
| 2107 | Kopita aletsedwa kwakanthawi |
| 2108 | Komwe kopita ndikosalondola |
| 2200 | Vuto pakuthawira |
| 2201 | Olembetsa ali ndi malire ochepa |
|
2202 |
Olembetsa amaletsedwa chifukwa cholipitsidwa (premium)
mauthenga |
|
2203 |
Olembetsa ali wamng'ono kwambiri (pa izi
za) |
| 2204 | Olembetsa omwe amalipira kale saloledwa |
| 2205 | Ntchito ikanidwa ndi olembetsa |
| 2206 | Olembetsa sanalembetsedwe munjira yolipira |
| 2207 | Olembetsa afika pachimake |
| 2208 | Chitsimikizo cha womaliza chikufunika |
| 2300 | Zabwezeredwa |
|
2301 |
Sitinathe kubweza ndalama chifukwa chosaloledwa kapena kusowa
MSISDN |
| 2302 | Sitinathe kubweza ndalama chifukwa chosowa messageId |
| 2303 | Zaimiridwa kuti zibwezedwe |
| 2304 | Kubweza nthawi kutha |
| 2305 | Kulephera kubweza ndalama |
| 3000 | Kusindikiza kwa GSM sikutheka |
| 3001 | Kusindikiza kwa UCS2 sikutheka |
| 3002 | Kusindikiza kwa binary sikutheka |
| 4000 | Lipoti la kutumiza silikuthandizidwa |
| 4001 | Mauthenga olakwika |
| 4002 | Mtengo wolakwika |
| 4003 | Zolakwika za ogwiritsa ntchito |
| 4004 | Mutu wa data wolakwika |
| 4005 | Kuyika kwa data ndi kolakwika |
| 4006 | VAT yolakwika |
| 4007 | Zosagwirizana ndi komwe mukupita |
Zolemba / Zothandizira
 |
link mobility SMS API,SMPP API MS Scheduler API [pdf] Buku Logwiritsa Ntchito SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |