SMS API, SMPP API MS Scheduler API
Stiùireadh Cleachdaiche
SMS API, SMPP API MS Scheduler API
| Atharraichte: | 6/24/2025 |
| Tionndadh: | 1.7 |
| Ùghdar: | Kenny Colander Norden, KCN |
Tha an sgrìobhainn seo airson an neach-faighinn ainmichte a-mhàin agus faodaidh gum bi fiosrachadh sochair, seilbhe no prìobhaideach ann. Ma fhuair thu e le mearachd, feuch an cuir thu fios chun neach a chuir e sa bhad agus sguab às am fear tùsail. Tha e toirmisgte cleachdadh sam bith eile den sgrìobhainn leat.
Atharraich eachdraidh
| An t-Urr | Ceann-latha | By | Atharraichean bhon fhoillseachadh roimhe |
| 1.0 | 2010-03-16 | KCN | Chruthaich |
| 1. | 2019-06-11 | TPE | Suaicheantasan LINK air an ùrachadh |
| 1. | 2019-09-27 | PNI | Iomradh a bharrachd air sònrachadh SMPP 3.4 |
| 1. | 2019-10-31 | EP | Sùil air an ùine dligheachd tag |
| 1. | 2020-08-28 | KCN | Fiosrachadh air a chur ris a thaobh dreachan TLS le taic |
| 2. | 2022-01-10 | KCN | Chaidh fiosrachadh a bharrachd a chur ris a thaobh aithisgean lìbhrigidh Fiosrachadh ùraichte a thaobh TLS 1.3 |
| 2. | 2025-06-03 | GM | Còd toraidh 2108 air a chur ris |
| 2. | 2025-06-24 | AK | Cuòta air a chur ris |
Ro-ràdh
Tha LINK Mobility air a bhith na neach-cuairteachaidh SMS bho 2001 agus tha mòran eòlas aige air a bhith ag obair le gnìomhaichean agus luchd-cruinneachaidh ceangail. Tha an àrd-ùrlar seo air a dhealbhadh gus meudan trafaic mòr a làimhseachadh, ruigsinneachd àrd a chumail suas agus a dhèanamh furasta trafaic a stiùireadh tro ioma-cheangal.
Tha an sgrìobhainn seo a’ toirt cunntas air eadar-aghaidh SMPP ris an àrd-ùrlar SMSC agus dè na paramadairean agus na h-òrdughan a tha a dhìth agus dè na paramadairean a tha air an taiceadh.
Cha làimhsich an sgrìobhainn seo cùisean cleachdaidh sònraichte leithid teachdaireachdan ceangailte, WAPpush, Flash SMS, msaa. Gheibhear barrachd fiosrachaidh mu na cùisean sin le bhith a’ cur fios chun taic.
Òrdughan le taic
Bu chòir dèiligeadh ri frithealaiche LINK Mobility mar SMPP 3.4. Gheibhear an sònrachadh oifigeil aig https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Chan eil taic aig a h-uile modh, agus tha na h-eadar-dhealachaidhean uile air an comharrachadh gu h-ìosal.
4.1 Ceangal
Tha na h-òrdughan ceangail a leanas a’ faighinn taic.
- Transmitter
- Transceiver
- Glacadair
Paramadairean riatanach:
- system_id - air fhaighinn bho thaic
- facal-faire - air fhaighinn bho thaic
Paramadairean roghainneil:
- addr_ton - luach bunaiteach ma tha TON air a shuidheachadh gu Neo-aithnichte rè cuir a-steach.
- addr_npi - luach bunaiteach ma tha NPI air a shuidheachadh gu Neo-aithnichte rè cuir a-steach.
Paramadairean gun taic:
- seòladh_raon
4.2 Neo-cheangail
Tha taic ris an àithne dì-cheangail.
4.3 Faighnich ceangal
Tha an àithne ceangail rannsachaidh a’ faighinn taic agus bu chòir a bhith air a ghairm gach 60 diog.
4.4 Cuir a-steach
Bu chòir an dòigh cur a-steach a chleachdadh airson teachdaireachdan a lìbhrigeadh.
Paramadairean riatanach:
- stòr_addr_ton
- stòr_addr_npi
- stòr_addr
- dest_addr_ton
- dest_addr_npi
- deist_addr
- esm_clas
- dàta_còdadh
- sm_fhad
- teachdaireachd_goirid
Paramadairean gun taic:
- seirbheis_seòrsa
- protocol_id
- prìomhachas_bratach
- clàr-ama_delivery_time
- cuir an àite_if_present_flag
- sm_default_msg_id
Thoir an aire gu bheil an t-uallach pàighidh tag chan eil taic ann agus chan fhaod ach aon SMS a bhith air a lìbhrigeadh gach gairm agus thathas a’ moladh an validity_period tag tha luach co-dhiù 15 mionaidean aige.
4.4.1 TON agus NPI air a mholadh
Bu chòir na TON agus an NPI a leanas a chleachdadh nuair a thathar a’ cur teachdaireachdan a’ cleachdadh òrdugh cuir a-steach.
4.4.1.1 Stòr
Tha na measgachaidhean TON agus NPI a leanas air an taiceadh airson seòladh tùsail. Thèid dèiligeadh ri gach measgachadh eile mar neo-dhligheach. Thèid an àithne bunaiteach TON bho cheangal a chleachdadh ma thèid TON a shuidheachadh gu Neo-aithnichte (0). Thèid an àithne bunaiteach NPI bho cheangal a chleachdadh ma thèid NPI a shuidheachadh gu Neo-aithnichte (0).
| TON | NPI | Tuairisgeul |
| Àireamhach (5) | Neo-aithnichte (0) ISDN (1) |
Thèid a làimhseachadh mar theacsa neach-cuiridh Alphanumeric |
| Eadar-nàiseanta (1) | Neo-aithnichte (0) ISDN (1) |
Thèid a làimhseachadh mar MSISDN |
| Nàiseanta (2) Àireamh fo-sgrìobhaiche sònraichte don lìonra (3) (4) Giorraichte (6) |
Neo-aithnichte (0) ISDN (1) Nàiseanta (8) |
Thèid a làimhseachadh mar àireamh ghoirid a tha sònraichte don dùthaich. |
4.4.1.2 Ceann-uidhe
Tha na measgachaidhean TON agus NPI a leanas a’ faighinn taic airson seòladh ceann-uidhe. Thèid a h-uile measgachadh eile a làimhseachadh mar neo-dhligheach. Thèid an TON bunaiteach bhon àithne ceangail a chleachdadh ma tha TON air a shuidheachadh gu Unknown (0). Thèid an NPI bunaiteach bhon àithne ceangail a chleachdadh ma tha NPI air a shuidheachadh gu Unknown (0).
| TON | NPI | Tuairisgeul |
| Eadar-nàiseanta (1) | Neo-aithnichte (0) ISDN (1) |
Thèid a làimhseachadh mar MSISDN |
4.4.2 Còdan le taic
Tha na còdachaidhean a leanas a' faighinn taic. Faodaidh luach sam bith a bhith ann an X.
| DCS | Còdachadh |
| 0xX0 | Aibidil GSM bunaiteach le leudachadh |
| 0xX2 | Binary 8-bit |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Cuota
5.1 Cuòta Tharview
Tha cuota a’ mìneachadh an àireamh as motha de theachdaireachdan SMS a ghabhas cur taobh a-staigh ùine shònraichte (leithid gach latha, seachdain, mìos, no gu bràth). Tha gach cuota air a chomharrachadh gu sònraichte le quotaId (UUID) agus thèid ath-shuidheachadh a rèir crios-ama an neach-ceannach. Faodar cuotan a shònrachadh aig ìre na dùthcha, na roinne, no an ìre bunaiteach tro Quota Pro.fileFaodar cuota a shònrachadh gu fiùghantach cuideachd le bhith a’ cleachdadh Mapadh Cuota. Bidh seo a’ mapadh CuotaId pàrant (UUID) agus Iuchair cuota sònraichte (me, neach-cuiridh no neach-cleachdaidh) gu cuotaId sònraichte.
Tha cuota air a shuidheachadh a rèir an taic ionadail agad, am manaidsear cunntais a chaidh a shònrachadh dhut no gu bunaiteach mura h-eil dad air a shònrachadh.
5.2 Inbhe 106 – Cuòta air a dhol thairis air
Dh’fhaodadh teachdaireachd SMS a bhith air a bacadh le còd inbhe 106 (“cuota air a dhol thairis”) nuair:
- Tha an teachdaireachd a’ dol thairis air a’ chrìoch mhìnichte airson a quotaId co-fhreagarrach taobh a-staigh na h-ùine làithreach.
- Chan eil cuota air a shònrachadh don dùthaich no roinn ceann-uidhe (i.e., tha e air a bhacadh gu soilleir le mapadh cuota neoni anns a’ phrofile).
- Chan eil cuota co-ionnan ann agus chan eil cuota bunaiteach air a mhìneachadh, agus mar thoradh air sin thèid a dhiùltadh.
Anns na cùisean sin, cuiridh an siostam casg air tuilleadh giollachd teachdaireachdan gus crìochan stèidhichte air luchd-ceannach no ceann-uidhe a chuir an gnìomh agus gus casg a chuir air mì-chleachdadh.
Aithisg lìbhrigidh
Chan eil ach gin no lìbhrigeadh deireannach le toradh soirbheachail / fàilligeadh a’ faighinn taic.
Cruth air an aithisg lìbhrigidh: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ceann-latha deiseil: yyMMddHHmm stat:
Luachan rim faighinn ann an staid:
- DEARBHACHADH
- A MHAIGHDEAN
- ATHAIR
- UNDELIV
- DEARBHACHADH
6.1 Cruth aithisg lìbhrigidh leudaichte
Faodar fiosrachadh leudaichte ann an aithisgean lìbhrigidh iarraidh ann an conaltradh ris an riochdaire reic agad.
Cruth air aithisg lìbhrigidh: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx fo-sgrìobhadh: 000 dlvrd: 000 ceann-latha cur a-steach:
yyMMddHHmm ceann-latha crìochnachaidh: yyMMddHHmm staitistig: mearachd: teacsa:
Luachan rim faighinn ann an staid:
- DEARBHACHADH
- A MHAIGHDEAN
- ATHAIR
- UNDELIV
- DEARBHACHADH
Bidh raointean “fo” agus “dlvrd” an-còmhnaidh air an suidheachadh gu 000, agus bidh raon “teacsa” an-còmhnaidh falamh.
Faic caibideil Còdan mearachd airson luachan airson an raon “mearachd”.
Tionndaidhean TLS le taic
Tha feum air TLS 1.2 no TLS 1.3 airson a h-uile ceangal TLS thairis air SMPP.
Tha taic airson TLS 1.0 agus 1.1 air a stad bho 2020-11-15. Tha dreachan 1.0 agus 1.1 de TLS nan seann phròtacalan nach deach a mholadh agus a tha air am meas mar chunnartan tèarainteachd sa choimhearsnachd eadar-lìn.
Tha LINK a’ moladh gu làidir TLS a chleachdadh ma thathas a’ cleachdadh ceanglaichean SMPP gun chrioptachadh an-diugh. Tha ceanglaichean SMPP neo-chrioptaichte air an ìsleachadh mar 2020-09-01 le LINK, agus thèid an toirt air falbh san àm ri teachd. Chan eil ceann-latha airson ceanglaichean gun chrioptachadh a thoirt air falbh air a cho-dhùnadh fhathast.
Tha ceanglaichean ris an t-seirbheisiche SMPP airson TLS aig port 3601 an àite gun chrioptachadh aig port 3600.
Faodaidh tu fhathast TLS a chleachdadh eadhon ged nach eil do bhuileachadh SMPP a’ toirt taic do TLS le bhith a’ cleachdadh stunnel, faic https://www.stunnel.org/
Còdan mearachd
Faodar na còdan mearachd a leanas a fhreagairt anns an raon mearachd ma tha an raon air a chomasachadh.
| Còd na mearachd | Tuairisgeul |
| 0 | Mearachd neo-aithnichte |
| 1 | Mearachd slighe sealach |
| 2 | Mearachd seòlaidh maireannach |
| 3 | Chaidh an smeòrach as àirde thairis air |
| 4 | A’ gabhail fois |
| 5 | Mearachd neo-aithnichte an gnìomhaiche |
| 6 | Mearachd gnìomhaiche |
| 100 | Cha deach seirbheis a lorg |
| 101 | Cha deach cleachdaiche a lorg |
| 102 | Cha deach cunntas a lorg |
| 103 | Facal-faire mì-dhligheach |
| 104 | Mearachd rèiteachaidh |
| 105 | Mearachd a-staigh |
| 106 | Cuota air a dhol thairis |
| 200 | OK |
| 1000 | Chuireadh |
| 1001 | Air a lìbhrigeadh |
| 1002 | Dh'fhalbh |
| 1003 | Air a sguabadh às |
| 1004 | Mobile làn |
| 1005 | ciudha |
| 1006 | Gun lìbhrigeadh |
| 1007 | Air a lìbhrigeadh, dàil air a’ chosgais |
| 1008 | Fo chosgais, cha deach teachdaireachd a chuir |
| 1009 | Air a phàigheadh, cha deach an teachdaireachd a lìbhrigeadh |
| 1010 | Air tighinn gu crìch, dìth aithisg lìbhrigidh gnìomhaiche |
| 1011 | Fo chosgais, teachdaireachd air a chuir (chun ghnìomhaiche) |
| 1012 | Air ciudha air falbh |
| 1013 | Teachdaireachd air a chuir chun ghnìomhaiche, dàil air cosgais |
| 2000 | Àireamh stòr mì-dhligheach |
| 2001 | Chan eil taic ri àireamh ghoirid mar stòr |
| 2002 | Chan eil taic ri Alpha mar thùs |
| 2003 | Chan eil taic ri MSISDN mar an àireamh thùsail |
| 2100 | Chan eil taic ri àireamh ghoirid mar cheann-uidhe |
| 2101 | Chan eil taic ri Alpha mar cheann-uidhe |
| 2102 | Chan eil taic ri MSISDN mar cheann-uidhe |
| 2103 | Gnìomh air a bhacadh |
| 2104 | Neach-clàraidh neo-aithnichte |
| 2105 | Ceann-uidhe air a bhacadh |
| 2106 | Mearachd àireamh |
| 2107 | Ceann-uidhe air a bhacadh airson ùine |
| 2108 | Ceann-uidhe neo-dhligheach |
| 2200 | Mearachd cosgais |
| 2201 | Tha cothromachadh ìosal aig an neach-clàraidh |
|
2202 |
Fo-sgrìobhaiche air a thoirmeasg airson cus cosgais (prìseil)
brathan |
|
2203 |
Fo-sgrìobhaiche ro òg (airson seo gu sònraichte
susbaint) |
| 2204 | Chan eil fo-sgrìobhaiche ro-phàighte ceadaichte |
| 2205 | Seirbheis air a dhiùltadh leis an neach-aontachaidh |
| 2206 | Neach-clàraidh nach eil clàraichte san t-siostam pàighidh |
| 2207 | Tha an neach-clàraidh air an cothromachadh as àirde a ruighinn |
| 2208 | Tha feum air dearbhadh cleachdaiche deireannach |
| 2300 | Air ais air ais |
|
2301 |
Cha b’ urrainnear airgead a phàigheadh air ais air sgàth mì-laghail no a dhìth
MSISDN |
| 2302 | Cha b' urrainn dhuinn aisig air ais air sgàth messageId a tha a dhìth |
| 2303 | Ciudha airson ath-dhìoladh |
| 2304 | Ùine ath-dhìoladh |
| 2305 | Fàilligeadh ath-dhìoladh |
| 3000 | Chan eil taic ri còdachadh GSM |
| 3001 | Chan eil taic ri còdachadh UCS2 |
| 3002 | Chan eil taic ri còdachadh binary |
| 4000 | Chan eil taic ri aithisg lìbhrigidh |
| 4001 | Susbaint teachdaireachd mì-dhligheach |
| 4002 | Cìs mì-dhligheach |
| 4003 | Dàta cleachdaiche mì-dhligheach |
| 4004 | Ceann-cinn dàta cleachdaiche mì-dhligheach |
| 4005 | Còdadh dàta mì-dhligheach |
| 4006 | VAT neo-dhligheach |
| 4007 | Susbaint gun taic airson ceann-uidhe |
Sgrìobhainnean/Goireasan
 |
ceangail gluasad SMS API, SMPP API MS Scheduler API [pdfStiùireadh Cleachdaiche SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |