SMS API, SMPP API MS Scheduler API
Fa'aoga Taiala
SMS API, SMPP API MS Scheduler API
| Suia: | 6/24/2025 |
| Fa'aliliuga: | 1.7 |
| Tusitala: | Kenny Colander Norden, KCN |
O lenei pepa e mo na'o le tagata e mauaina ma e mafai ona i ai fa'amatalaga fa'apitoa, fa'apitoa, po'o isi fa'amatalaga patino. Afai na e maua ise mea sese, fa'amolemole logo le tagata na lafo vave ma tape le ulua'i tusi. So'o se isi lava fa'aogaina o le pepa e oe e fa'asaina.
Suia talafaasolopito
| Fai mai Rev | Aso | By | Suiga mai le tatalaina muamua |
| 1.0 | 2010-03-16 | KCN | Faia |
| 1. | 2019-06-11 | TPE | Fa'afou LINK logos |
| 1. | 2019-09-27 | PNI | Faʻaopoopo faʻamatalaga ile SMPP 3.4 faʻamatalaga |
| 1. | 2019-10-31 | EP | Mata'ituina e uiga i le vaitaimi aoga tag |
| 1. | 2020-08-28 | KCN | Fa'aopoopoina fa'amatalaga e uiga i lomiga TLS lagolagoina |
| 2. | 2022-01-10 | KCN | Fa'aopoopoina fa'amatalaga fa'aopoopo e uiga i lipoti fa'aolaina Fa'afouina fa'amatalaga e uiga i le TLS 1.3 |
| 2. | 2025-06-03 | GM | Fa'aopoopo le fa'ailoga 2108 |
| 2. | 2025-06-24 | AK | Fa'aopoopo le quota |
Folasaga
LINK Mobility ua avea ma tufatufaina SMS talu mai le 2001 ma e tele lona poto masani i le galulue faatasi ma le au faʻatautaia ma fesoʻotaʻiga aggregators. O lenei faʻavae ua mamanuina e faʻatautaia le tele o feoaiga, faʻatumauina le maualuga o avanoa ma faʻafaigofie ona faʻaogaina auala e ala i le tele o fesoʻotaʻiga.
O le pepa lea o loʻo faʻamatalaina ai le SMPP interface i le SMSC-platform ma poʻo fea taʻiala ma faʻatonuga e manaʻomia ma poʻo fea faʻamau e lagolagoina.
O lenei pepa o le a le taulimaina mataupu faʻaoga faʻapitoa e pei o feʻau tuʻufaʻatasia, WAPpush, Flash SMS, ma isi. E mafai ona tuʻuina atu nisi faʻamatalaga e uiga i na mataupu e ala i le faʻafesoʻotaʻi le lagolago.
Poloaiga lagolago
LINK Mobility's server e tatau ona faʻaogaina o le SMPP 3.4. E mafai ona maua le faʻamatalaga aloaia ile https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
E le lagolagoina uma metotia, ma o eseesega uma o loʻo faʻamaonia i lalo.
4.1 Nonoa
O lo'o lagolagoina tulafono o fusifusia nei.
- Transmisi
- Transceiver
- Talia
Fa'ailoga mana'omia:
- system_id – maua mai le lagolago
- password – maua mai le lagolago
Fa'asagaga e filifili ai:
- addr_ton – fa'aletonu le tau pe a seti le TON i le Le iloa a'o tu'uina atu.
- addr_npi - fa'aletonu le tau pe a fa'atulaga le NPI i le Le iloa a'o tu'uina atu.
Fa'amauina e le'i lagolagoina:
- tuatusi_ava
4.2 Tatala
E lagolagoina le poloaiga tatala.
4.3 Fesili feso'ota'iga
Ole fa'atonuga ole feso'ota'iga e lagolagoina ma e tatau ona vala'au ile 60 sekone.
4.4 Tuuina atu
E tatau ona fa'aoga le auala e lafo mo le momoliina o fe'au.
Fa'ailoga mana'omia:
- puna_addr_ton
- puna_addr_npi
- puna_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_umi
- short_message
Fa'amauina e le'i lagolagoina:
- service_type
- protocol_id
- priority_flag
- schedule_delivery_time
- sui_if_present_flag
- sm_default_msg_id
Manatua o le uta tag e le lagolagoina ma e na o le tasi le SMS e mafai ona tuʻuina atu i le telefoni ma e fautuaina le validity_period tag o lo'o i ai se tau e 15 minute le umi a itiiti ifo.
4.4.1 Fautuaina TON ma NPI
O le TON ma le NPI o loʻo mulimuli mai e tatau ona faʻaoga pe a lafoina feʻau e faʻaaoga ai le tuʻuina atu o le poloaiga.
4.4.1.1 Punavai
O tu'ufa'atasiga TON ma le NPI o lo'o mulimuli mai e lagolagoina mo tuatusi fa'apogai. O isi tu'ufa'atasiga uma o le a fa'apea e le aoga. Ole TON fa'aletonu mai le fa'atonuga o le a fa'aogaina pe a seti le TON ile Le iloa (0). Ole NPI fa'aletonu mai le fa'atonuga o le a fa'aogaina pe a fa'atulaga le NPI i le Le iloa (0).
| TONA | NPI | Fa'amatalaga |
| Alanumera (5) | Le iloa (0) ISDN (1) |
O le a fa'aogaina e pei o le Alphanumeric sender text |
| Fa'ava-o-malo (1) | Le iloa (0) ISDN (1) |
O le a faia o MSISDN |
| National (2) Feso'ota'iga fa'apitoa (3) Numera o le au fai saofaga (4) Faapuupuu (6) |
Le iloa (0) ISDN (1) National (8) |
O le a fa'atatauina o se numera pu'upu'u patino a le atunu'u. |
4.4.1.2 Taulaga
O tu'ufa'atasiga o le TON ma le NPI o lo'o mulimuli mai o lo'o lagolagoina mo le tuatusi o lo'o i ai. O isi tu'ufa'atasiga uma o le a fa'apea e le aoga. Ole TON fa'aletonu mai le fa'atonuga o le a fa'aogaina pe a seti le TON ile Le iloa (0). Ole NPI fa'aletonu mai le fa'atonuga o le a fa'aogaina pe a fa'atulaga le NPI i le Le iloa (0).
| TONA | NPI | Fa'amatalaga |
| Fa'ava-o-malo (1) | Le iloa (0) ISDN (1) |
O le a faia o MSISDN |
4.4.2 Fa'ailoga e lagolagoina
O fa'ailoga nei e lagolagoina. X e ono iai so'o se tau.
| DCS | Fa'ailoga |
| 0xX0 | Ole GSM Alphabet ma le fa'aopoopoga |
| 0xX2 | 8-bit binary |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Ova le Quotaview
O le quota e fa'amatala ai le numera aupito maualuga o fe'au SMS e mafai ona lafo i totonu o se taimi fa'apitoa (pei o le aso, vaiaso, masina, po'o le fa'avavau). O quota ta'itasi e fa'ailoa fa'apitoa e se quotaId (UUID) ma toe fa'atulaga e tusa ai ma le sone taimi a le tagata fa'atau. E mafai ona tu'uina atu tupe i le atunu'u, itulagi, po'o le tulaga fa'aletonu e ala ile Quota Profile. Ole Quota e mafai fo'i ona fa'atonuina ma le malosi ile fa'aogaina ole Quota Mapping. Ole fa'afanua lea ole matua QuotaId (UUID) ma se quotaID tulaga ese (fa'ata'ita'iga, sender po'o le tagata fa'aoga) ile quotaId patino.
E fa'atulaga se quota e tusa ai ma lau lagolago fa'apitonu'u, lau pule fa'atupe tofia pe fa'aletonu pe a leai se mea e fa'ailoa mai.
5.2 Tulaga 106 – Ova le Quota
E mafai ona poloka se fe'au SMS ile fa'ailoga tulaga 106 (“ua sili atu le aofa'i”) pe a:
- O le fe'au e sili atu i le tapula'a fa'amatalaina mo lona quotaId talafeagai i totonu o le va o le taimi nei.
- O le atunu'u po'o le itulagi o lo'o alu i ai e leai se aofa'iga na tu'uina atu (fa'atusa, o lo'o poloka manino i se fa'afanua fa'aleaogaina i le pro.file).
- E leai se quota e fetaui ma e leai se fa'aupuga fa'aletonu e fa'amalamalamaina, e i'u ai i le te'ena.
I nei tulaga, o le faiga e taofia ai le faʻagasolo atili o feʻau e faʻamalosia ai le tagata faʻatau poʻo le faʻaogaina o tapulaʻa ma aloese mai le faʻaaoga sese.
Lipoti tilivaina
E na'o le leai po'o le fa'ai'uga fa'ai'uga ma taunu'uga manuia/to'ilalo e lagolagoina.
Fa'asologa ile lipoti o le tilivaina: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx aso faia: yyMMddHHmm stat:
Tulaga avanoa ile tulaga:
- TU'UINA
- FA'AVAE
- TETEE
- UNELIV
- AVE
6.1 Fa'aopoopoina le tu'uina atu o lipoti
E mafai ona talosagaina fa'amatalaga fa'alautele i lipoti fa'atauina e fa'afeso'ota'i ma lou sui fa'atau.
Fa'asologa ile lipoti o le tilivaina: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx i lalo:000 dlvrd:000 aso tu'uina atu:
yyMMddHHmm mae'a aso: yyMMddHHmm fuainumera: sese: tusitusiga:
Tulaga avanoa ile tulaga:
- TU'UINA
- FA'AVAE
- TETEE
- UNELIV
- AVE
"sub" ma "dlvrd" fanua o le a seti i taimi uma i le 000, ma "tusitusi" fanua o le a gaogao i taimi uma.
Va'ai mataupu Fa'ailoga sese mo tau mo le "sese" fanua.
Lagolago TLS versions
TLS 1.2 poʻo TLS 1.3 e manaʻomia mo fesoʻotaʻiga TLS uma i luga ole SMPP.
Lagolago mo TLS 1.0 ma le 1.1 ua fa'agata talu mai le 2020-11-15. Fa'aliliuga 1.0 ma le 1.1 o le TLS o tulafono tuai ia ua fa'ate'aina ma ua manatu o ni lamatiaga saogalemu i totonu o le Initaneti.
E fautuaina malosi e LINK le fa'aogaina o le TLS pe a fa'aogaina feso'ota'iga SMPP e le'i fa'ailogaina i aso nei. O feso'ota'iga SMPP e le'i fa'ailogaina ua fa'ate'aina mai le 2020-09-01 e le LINK, ma o le a aveesea i le lumana'i. E le'i filifilia le aso mo le aveeseina o feso'ota'iga e le'i fa'ailogaina.
O feso'ota'iga i le SMPP server mo TLS o lo'o i le taulaga 3601 nai lo le le fa'ailogaina i le taulaga 3600.
E mafai lava ona e fa'aogaina le TLS e tusa lava pe le lagolagoina e lau fa'atinoga SMPP le TLS fa'aaoga le stunnel, va'ai https://www.stunnel.org/
Fa'ailoga sese
O fa'ailoga sese o lo'o mulimuli mai e mafai ona tali i le err field pe afai e mafai le fanua.
| Fa'ailoga sese | Fa'amatalaga |
| 0 | Sese le iloa |
| 1 | Sese auala le tumau |
| 2 | Fa'aletonu le auala tumau |
| 3 | Ua sili atu le la'ititi pito maualuga |
| 4 | Uma le taimi |
| 5 | Fa'atonu sese le iloa |
| 6 | Fa'atonu sese |
| 100 | Le maua auaunaga |
| 101 | Le maua le tagata fa'aoga |
| 102 | E le o maua le tala |
| 103 | Le sa'o upu faataga |
| 104 | Fa'atonu sese |
| 105 | Sese i totonu |
| 106 | Ua sili atu le kuota |
| 200 | OK |
| 1000 | Auina atu |
| 1001 | Tuuina atu |
| 1002 | Ua mae'a |
| 1003 | Ave'esea |
| 1004 | Mobile tumu |
| 1005 | Tuli |
| 1006 | E le'i tu'uina atu |
| 1007 | Tuuina atu, tuai totogi |
| 1008 | Ua molia, e le'i auina atu le fe'au |
| 1009 | Totogi, e le'i avatua le fe'au |
| 1010 | Fa'agata, leai se lipoti e tu'uina atu e le fa'afoe |
| 1011 | Totogi, lafo le fe'au (i le fa'afoe) |
| 1012 | Tulaga mamao |
| 1013 | Na lafo le fe'au i le fa'afoe, tuai le totogi |
| 2000 | Le aoga numera puna |
| 2001 | E le lagolagoina le numera pupuu e fai ma puna |
| 2002 | E le lagolagoina le Alefa e fai ma puna |
| 2003 | E le lagolagoina le MSISDN e avea ma numera puna |
| 2100 | Ole numera pupuu e le lagolagoina e avea ma nofoaga |
| 2101 | E le o lagolagoina le Alefa e fai ma nofoaga |
| 2102 | E le lagolagoina le MSISDN e avea ma taunuuga |
| 2103 | Ua poloka le gaioiga |
| 2104 | Le iloa le tagata fai saofaga |
| 2105 | Ua poloka le nofoaga |
| 2106 | Numera sese |
| 2107 | Ua poloka le nofoaga mo se taimi le tumau |
| 2108 | Le sa'o le taunu'uga |
| 2200 | Fa'atonu sese |
| 2201 | E maualalo le paleni a le tagata fai saofaga |
|
2202 |
Fa'asa le tagata fai saofaga mo le ova le totogi (fa'atauga)
savali |
|
2203 |
Laiti tele le tagata fai saofaga (mo lenei faapitoa
anotusi) |
| 2204 | E le fa'atagaina le tagata fai saofaga muamua |
| 2205 | Ua teena e le tagata fai saofaga |
| 2206 | Le lesitalaina e le'i resitalaina ile faiga o totogi |
| 2207 | Ua ausia e le tagata fai saofaga le paleni maualuga |
| 2208 | E mana'omia le fa'amaoniga a tagata fa'ai'u |
| 2300 | Toe fa'afo'i |
|
2301 |
Le mafai ona toe fa'afo'i ona o le tulafono pe misi
MSISDN |
| 2302 | Le mafai ona toe fa'afo'i ona o le misi messageId |
| 2303 | Tuli mo le toe faafoi |
| 2304 | Taimi toe fa'afo'i |
| 2305 | Toe fa'afo'i fa'aletonu |
| 3000 | E le lagolagoina le GSM encoding |
| 3001 | UCS2 encoding e le lagolagoina |
| 3002 | E le lagolagoina le encoding binary |
| 4000 | E le lagolagoina le lipoti o tiliva |
| 4001 | Fa'amatalaga fe'au le sa'o |
| 4002 | Le aoga o tau |
| 4003 | Fa'amatalaga le aoga |
| 4004 | Ulutala fa'amatalaga fa'aoga le aoga |
| 4005 | Fa'ailoga fa'amatalaga le aoga |
| 4006 | Le aoga VAT |
| 4007 | Mea e le lagolagoina mo le taunu'uga |
Pepa / Punaoa
 |
feso'ota'iga fe'avea'i SMS API, SMPP API MS Scheduler API [pdf] Taiala mo Tagata Fa'aoga SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |