SMS API,SMPP API MS Scheduler API
Mwongozo wa Mtumiaji
SMS API,SMPP API MS Scheduler API
| Iliyorekebishwa: | 6/24/2025 |
| Toleo: | 1.7 |
| Mwandishi: | Kenny Colander Norden, KCN |
Hati hii ni ya mpokeaji aliyeteuliwa pekee na inaweza kuwa na maelezo maalum, ya umiliki au vinginevyo ya faragha. Ikiwa umeipokea kimakosa, tafadhali mjulishe mtumaji mara moja na ufute ya asili. Utumiaji mwingine wowote wa hati ni marufuku.
Badilisha historia
| Mch | Tarehe | By | Mabadiliko kutoka kwa toleo la awali |
| 1.0 | 2010-03-16 | KCN | Imeundwa |
| 1. | 2019-06-11 | TPE | Nembo za LINK zimesasishwa |
| 1. | 2019-09-27 | PNI | Marejeleo yaliyoongezwa kwa vipimo vya SMPP 3.4 |
| 1. | 2019-10-31 | EP | Uchunguzi kuhusu kipindi cha uhalali tag |
| 1. | 2020-08-28 | KCN | Maelezo kuhusu matoleo ya TLS yanayotumika |
| 2. | 2022-01-10 | KCN | Imeongeza maelezo ya ziada kuhusu ripoti za uwasilishaji Taarifa iliyosasishwa kuhusu TLS 1.3 |
| 2. | 2025-06-03 | GM | Nambari ya matokeo iliyoongezwa 2108 |
| 2. | 2025-06-24 | AK | Nafasi iliyoongezwa |
Utangulizi
LINK Mobility imekuwa kisambazaji SMS tangu 2001 na ina uzoefu mkubwa katika kufanya kazi na waendeshaji na viunganishi vya kuunganisha. Jukwaa hili limeundwa kushughulikia idadi kubwa ya trafiki, kudumisha upatikanaji wa juu na kurahisisha kuelekeza trafiki kupitia miunganisho mingi.
Hii ni hati inayoelezea kiolesura cha SMPP kwa jukwaa la SMSC na ni vigezo na amri zipi zinazohitajika na ni vigezo vipi vinavyotumika.
Hati hii haitashughulikia kesi maalum za utumizi kama jumbe zilizounganishwa, WAPpush, Flash SMS, n.k. Maelezo zaidi kuhusu visa hivyo yanaweza kutolewa kwa kuwasiliana na usaidizi.
Amri zinazoungwa mkono
Seva ya LINK Mobility inapaswa kuchukuliwa kama SMPP 3.4. Vipimo rasmi vinaweza kupatikana kwa https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Mbinu zote hazitumiki, na tofauti zote zimeelezwa hapa chini.
4.1 Funga
Amri zifuatazo za kuunganisha zinatumika.
- Kisambazaji
- transciever
- Mpokeaji
Vigezo vinavyohitajika:
- system_id - iliyopatikana kutoka kwa usaidizi
- nenosiri - lililopatikana kutoka kwa usaidizi
Vigezo vya hiari:
- addr_ton - thamani chaguo-msingi ikiwa TON imewekwa kuwa Haijulikani wakati wa kuwasilisha.
- addr_npi - thamani chaguo-msingi ikiwa NPI imewekwa kuwa Haijulikani wakati wa kuwasilisha.
Vigezo visivyotumika:
- masafa_ya_anuani
4.2 Tendua
Amri ya kufuta inatumika.
4.3 Uliza kiungo
Amri ya kiunga cha kuuliza inatumika na inapaswa kuitwa kila sekunde 60.
4.4 Wasilisha
Mbinu ya kuwasilisha inapaswa kutumika kuwasilisha ujumbe.
Vigezo vinavyohitajika:
- chanzo_addr_ton
- chanzo_addr_npi
- chanzo_chanzo
- dest_addr_ton
- dest_addr_npi
- mwisho_addr
- darasa_elimu
- data_coding
- sm_urefu
- ujumbe_mfupi
Vigezo visivyotumika:
- aina_ya_huduma
- itifaki_id
- bendera_ya_kipaumbele
- panga_muda_wa_utoaji
- badilisha_ikiwa_bendera_ipo
- sm_default_msg_id
Kumbuka huo mzigo tag haitumiki na SMS moja pekee ndiyo inaweza kutumwa kwa kila simu na inashauriwa kuwa kipindi cha uhalali tag ina thamani ya dakika 15 angalau.
4.4.1 TON na NPI zilizopendekezwa
TON na NPI zifuatazo zinapaswa kutumika wakati wa kutuma ujumbe kwa kutumia amri ya kutuma.
4.4.1.1 Chanzo
Michanganyiko ifuatayo ya TON na NPI inatumika kwa anwani ya chanzo. Michanganyiko mingine yote itachukuliwa kuwa batili. TON chaguomsingi kutoka kwa amri ya kumfunga itatumika ikiwa TON imewekwa kuwa Haijulikani (0). NPI chaguo-msingi kutoka kwa amri ya kumfunga itatumika ikiwa NPI imewekwa kuwa Haijulikani (0).
| TON | NPI | Maelezo |
| Alphanumeric (5) | Haijulikani (0) ISDN (1) |
Itachukuliwa kama maandishi ya mtumaji wa Alphanumeric |
| Kimataifa (1) | Haijulikani (0) ISDN (1) |
Itachukuliwa kama MSISDN |
| Kitaifa (2) Nambari maalum ya mtandao (3) ya mteja (4) Kifupi (6) |
Haijulikani (0) ISDN (1) Kitaifa (8) |
Itachukuliwa kama nambari fupi mahususi ya nchi. |
4.4.1.2 Marudio
Michanganyiko ifuatayo ya TON na NPI inatumika kwa anwani lengwa. Michanganyiko mingine yote itachukuliwa kuwa batili. TON chaguomsingi kutoka kwa amri ya kumfunga itatumika ikiwa TON imewekwa kuwa Haijulikani (0). NPI chaguo-msingi kutoka kwa amri ya kumfunga itatumika ikiwa NPI imewekwa kuwa Haijulikani (0).
| TON | NPI | Maelezo |
| Kimataifa (1) | Haijulikani (0) ISDN (1) |
Itachukuliwa kama MSISDN |
4.4.2 Usimbaji unaotumika
Usimbaji ufuatao unatumika. X inaweza kuwa na thamani yoyote.
| DCS | Usimbaji |
| 0xX0 | Alfabeti chaguomsingi ya GSM yenye kiendelezi |
| 0xX2 | 8-bit binary |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kiasi
5.1 Kiwango Kimeishaview
Kiasi kinafafanua idadi ya juu zaidi ya ujumbe wa SMS unaoweza kutumwa ndani ya muda maalum (kama vile kwa siku, wiki, mwezi, au kwa muda usiojulikana). Kila kiasi kinatambulishwa kwa njia ya kipekee kwa kitambulisho cha mgawo (UUID) na huwekwa upya kulingana na saa za eneo la mteja. Nafasi zinaweza kutolewa katika nchi, eneo, au kiwango chaguo-msingi kupitia Quota Profile. Nafasi pia inaweza kugawiwa kwa nguvu kwa kutumia Ramani ya Upendeleo. Hii inaonyesha QuotaId ya mzazi (UUID) na Ufunguo wa kipekee wa mgawo (km, mtumaji au mtumiaji) kwa kitambulisho mahususi.
Kiasi kimewekwa kwa mujibu wa usaidizi wa karibu nawe, msimamizi wa akaunti uliyokabidhiwa au kwa chaguo-msingi ikiwa hakuna chochote kilichobainishwa.
5.2 Hali 106 – Kiasi Kimezidi
Ujumbe wa SMS unaweza kuzuiwa kwa msimbo wa hali 106 (“mgao umezidishwa”) wakati:
- Ujumbe unazidi kikomo kilichobainishwa cha kigao chake kinacholingana ndani ya muda wa sasa.
- Nchi au eneo lengwa halina mgao uliokabidhiwa (yaani, limezuiwa kwa uwazi na ramani ya mgawo batili katika pro.file).
- Hakuna mgao unaolingana na hakuna mgao chaguo-msingi umebainishwa, na kusababisha kukataliwa.
Katika hali hizi, mfumo huzuia uchakataji zaidi wa ujumbe ili kutekeleza vikomo vinavyotegemea mteja au lengwa na kuepuka matumizi mabaya.
Ripoti ya utoaji
Hakuna uwasilishaji au uwasilishaji wa mwisho wenye matokeo ya kufaulu/kufeli pekee ndio unaoauniwa.
Umbizo la ripoti ya uwasilishaji: kitambulisho: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx tarehe iliyokamilika: yyMMddHHmm takwimu:
Thamani zinazopatikana katika hali:
- DELIVRD
- IMEMALIZIKA
- IMEKATAA
- UNELIV
- IMEFUTWA
6.1 Muundo wa ripoti ya uwasilishaji uliopanuliwa
Taarifa zilizopanuliwa katika ripoti za uwasilishaji zinaweza kuombwa kuwasiliana na mwakilishi wako wa mauzo.
Umbizo la ripoti ya uwasilishaji: kitambulisho: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ndogo:000 dlvrd:000 tarehe ya kuwasilisha:
yyMMddHHmm tarehe ya kukamilika: yyMMddHHmm takwimu: kosa: maandishi:
Thamani zinazopatikana katika hali:
- DELIVRD
- IMEMALIZIKA
- IMEKATAA
- UNELIV
- IMEFUTWA
Sehemu za "sub" na "dlvrd" zitawekwa kila wakati kuwa 000, na sehemu ya "maandishi" itakuwa tupu kila wakati.
Tazama sura Misimbo ya Hitilafu kwa thamani za sehemu ya "kosa".
Matoleo ya TLS yanayotumika
TLS 1.2 au TLS 1.3 inahitajika kwa miunganisho yote ya TLS kupitia SMPP.
Usaidizi kwa TLS 1.0 na 1.1 umekatishwa tangu 2020-11-15. Matoleo ya 1.0 na 1.1 ya TLS ni itifaki za zamani ambazo zimeacha kutumika na zinachukuliwa kuwa hatari za usalama katika jumuiya ya Mtandao.
LINK inapendekeza sana kutumia TLS ikiwa miunganisho ya SMPP ambayo haijasimbwa inatumika leo. Miunganisho ya SMPP ambayo haijasimbwa imeacha kutumika kuanzia 2020-09-01 na LINK, na itaondolewa katika siku zijazo. Tarehe ya kuondolewa kwa miunganisho ambayo haijasimbwa bado haijaamuliwa.
Miunganisho kuelekea seva ya SMPP kwa TLS iko kwenye lango 3601 badala ya ambayo haijasimbwa kwa njia fiche kwenye bandari 3600.
Bado unaweza kutumia TLS hata kama utekelezaji wako wa SMPP hauauni TLS kwa kutumia stunnel, ona https://www.stunnel.org/
Misimbo ya hitilafu
Misimbo ya hitilafu ifuatayo inaweza kujibiwa katika sehemu ya hitilafu ikiwa uga umewashwa.
| Msimbo wa hitilafu | Maelezo |
| 0 | Hitilafu isiyojulikana |
| 1 | Hitilafu ya muda ya uelekezaji |
| 2 | Hitilafu ya kudumu ya uelekezaji |
| 3 | Upeo wa kusukuma umepitwa |
| 4 | Muda umekwisha |
| 5 | Hitilafu isiyojulikana ya kiendeshaji |
| 6 | Hitilafu ya mwendeshaji |
| 100 | Huduma haijapatikana |
| 101 | Mtumiaji hakupatikana |
| 102 | Akaunti haijapatikana |
| 103 | Nenosiri batili |
| 104 | Hitilafu ya usanidi |
| 105 | Hitilafu ya ndani |
| 106 | Kiasi kimepitwa |
| 200 | OK |
| 1000 | Imetumwa |
| 1001 | Imewasilishwa |
| 1002 | Muda wake umeisha |
| 1003 | Imefutwa |
| 1004 | Simu imejaa |
| 1005 | Imewekwa kwenye foleni |
| 1006 | Haijawasilishwa |
| 1007 | Imewasilishwa, malipo yamechelewa |
| 1008 | Imechajiwa, ujumbe haujatumwa |
| 1009 | Imetozwa, ujumbe haujawasilishwa |
| 1010 | Muda wake umeisha, kutokuwepo kwa ripoti ya uwasilishaji wa waendeshaji |
| 1011 | Imechajiwa, ujumbe umetumwa (kwa opereta) |
| 1012 | Imewekwa kwenye foleni kwa mbali |
| 1013 | Ujumbe umetumwa kwa opereta, malipo yamechelewa |
| 2000 | Nambari ya chanzo si sahihi |
| 2001 | Nambari fupi haitumiki kama chanzo |
| 2002 | Alpha haitumiki kama chanzo |
| 2003 | MSISDN haitumiki kama nambari ya chanzo |
| 2100 | Nambari fupi haitumiki kama lengwa |
| 2101 | Alpha haitumiki kama lengwa |
| 2102 | MSISDN haitumiki kama lengwa |
| 2103 | Uendeshaji umezuiwa |
| 2104 | Msajili asiyejulikana |
| 2105 | Lengwa limezuiwa |
| 2106 | Hitilafu ya nambari |
| 2107 | Lengwa limezuiwa kwa muda |
| 2108 | Lengwa batili |
| 2200 | Hitilafu ya kuchaji |
| 2201 | Msajili ana salio la chini |
|
2202 |
Msajili amezuiwa kwa kutozwa zaidi (ya malipo)
ujumbe |
|
2203 |
Msajili mchanga sana (kwa hii
yaliyomo) |
| 2204 | Msajili wa kulipia kabla haruhusiwi |
| 2205 | Huduma imekataliwa na mteja |
| 2206 | Msajili ambaye hajasajiliwa katika mfumo wa malipo |
| 2207 | Msajili amefikia kiwango cha juu cha salio |
| 2208 | Uthibitishaji wa mtumiaji wa mwisho unahitajika |
| 2300 | Imerejeshwa |
|
2301 |
Haikuweza kurejesha pesa kwa sababu haramu au kukosa
MSISDN |
| 2302 | Haikuweza kurejesha pesa kwa sababu ya kukosa messageId |
| 2303 | Imewekwa kwenye foleni ili kurejeshewa pesa |
| 2304 | Muda wa kurejesha pesa umekwisha |
| 2305 | Imeshindwa kurejesha pesa |
| 3000 | Usimbaji wa GSM hautumiki |
| 3001 | Usimbaji wa UCS2 hautumiki |
| 3002 | Usimbaji binary hautumiki |
| 4000 | Ripoti ya uwasilishaji haitumiki |
| 4001 | Maudhui batili ya ujumbe |
| 4002 | Ushuru usio sahihi |
| 4003 | Data batili ya mtumiaji |
| 4004 | Kijajuu batili cha data ya mtumiaji |
| 4005 | Usimbaji batili wa data |
| 4006 | VAT batili |
| 4007 | Maudhui yasiyotumika kwa lengwa |
Nyaraka / Rasilimali
 |
API ya SMS ya uhamaji, API ya SMPP ya Mratibu wa MS [pdf] Mwongozo wa Mtumiaji SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |