SMS API, SMPP API MS Sceidealóir API
Treoir Úsáideora
SMS API, SMPP API MS Sceidealóir API
| Athraithe: | 6/24/2025 |
| Leagan: | 1.7 |
| Údar: | Kenny Colander Norden, KCN |
Is don fhaighteoir ainmnithe amháin an doiciméad seo agus d’fhéadfadh faisnéis phribhléideach, dhílseánaigh nó faisnéis phríobháideach eile a bheith ann. Má fuair tú é trí dhearmad, cuir é sin in iúl don seoltóir láithreach le do thoil agus scrios an bunchóip. Tá cosc ar aon úsáid eile a bhaineann tú as an doiciméad.
Athraigh stair
| Athr | Dáta | By | Athruithe ón eisiúint roimhe seo |
| 1.0 | 2010-03-16 | KCN | Cruthaithe |
| 1. | 2019-06-11 | TPE | Lógónna LINK nuashonraithe |
| 1. | 2019-09-27 | PNI | Tagairt breise do shonraíocht SMPP 3.4 |
| 1. | 2019-10-31 | EP | Breathnú ar an tréimhse bailíochta tag |
| 1. | 2020-08-28 | KCN | Cuireadh faisnéis leis maidir le leaganacha TLS tacaithe |
| 2. | 2022-01-10 | KCN | Cuireadh faisnéis bhreise leis maidir le tuairiscí seachadta Faisnéis nuashonraithe maidir le TLS 1.3 |
| 2. | 2025-06-03 | GM | Cód toraidh 2108 curtha leis |
| 2. | 2025-06-24 | AK | Cuóta curtha leis |
Réamhrá
Tá LINK Mobility ina dháileoir SMS ó 2001 agus tá an-taithí aige ar oibriú le hoibreoirí agus le comhbhailitheoirí nasc araon. Tá an t-ardán seo deartha chun líon mór tráchta a láimhseáil, le hinfhaighteacht ard a choinneáil agus é a dhéanamh éasca trácht a stiúradh trí naisc iolracha.
Déantar cur síos sa cháipéis seo ar chomhéadan SMPP leis an ardán SMSC agus ar na paraiméadair agus na horduithe atá riachtanach agus na paraiméadair a dtacaítear leo.
Ní láimhseálfaidh an doiciméad seo cásanna úsáide sonracha amhail teachtaireachtaí nasctha, WAPpush, Flash SMS, srl. Is féidir tuilleadh eolais faoi na cásanna sin a fháil trí theagmháil a dhéanamh leis an bhfoireann tacaíochta.
Orduithe tacaithe
Ba cheart caitheamh le freastalaí LINK Mobility mar SMPP 3.4. Is féidir an tsonraíocht oifigiúil a fháil ag https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Ní thacaítear le gach modh, agus sonraítear na difríochtaí go léir thíos.
4.1 Ceangail
Tacaítear leis na horduithe ceangail seo a leanas.
- Tarchuradóir
- Aistritheoir
- Glacadóir
Paraiméadair riachtanacha:
- system_id – faighte ón tacaíocht
- pasfhocal – faighte ón tacaíocht
Paraiméadair roghnacha:
- addr_ton – luach réamhshocraithe má tá TON socraithe go Anaithnid le linn an taiscthe.
- addr_npi – luach réamhshocraithe má shocraítear NPI go Anaithnid le linn an taiscthe.
Paraiméadair nach dtacaítear leo:
- raon_seoladh
4.2 Dícheangail
Tacaítear leis an ordú dícheangail.
4.3 Fiosraigh nasc
Tacaítear leis an ordú naisc fiosrúcháin agus ba cheart é a ghlaoch gach 60 soicind.
4.4 Cuir isteach
Ba cheart an modh seolta a úsáid chun teachtaireachtaí a sheachadadh.
Paraiméadair riachtanacha:
- foinse_addr_ton
- foinse_addr_npi
- foinse_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_rang
- sonraí_códú
- sm_fhad
- teachtaireacht_ghairid
Paraiméadair nach dtacaítear leo:
- cineál_seirbhíse
- prótacal_id
- tosaíocht_bratach
- sceideal_seachadta_am
- ionad_if_present_flag
- sm_default_msg_id
Nóta go bhfuil an t-ualach pá tag Ní thacaítear leis agus ní féidir ach SMS amháin a sheachadadh in aghaidh an ghlao agus moltar an validity_period tag tá luach 15 nóiméad ar a laghad aige.
4.4.1 TON agus NPI molta
Ba cheart an TON agus an NPI seo a leanas a úsáid agus teachtaireachtaí á seoladh ag baint úsáide as ordú cuir isteach.
4.4.1.1 Foinse
Tacaítear leis na teaglamaí TON agus NPI seo a leanas le haghaidh seoladh foinse. Déileálfar le gach teaglaim eile mar neamhbhailí. Úsáidfear an t-ordú réamhshocraithe TON ó cheangal má shocraítear TON go Anaithnid (0). Úsáidfear an t-ordú réamhshocraithe NPI ó cheangal má shocraítear NPI go Anaithnid (0).
| TON | NPI | Cur síos |
| Alfa-uimhriúil (5) | Anaithnid (0) ISDN (1) |
Déileálfar leis mar théacs seoltóir alfa-uimhriúil |
| Idirnáisiúnta (1) | Anaithnid (0) ISDN (1) |
Déileálfar leis mar MSISDN |
| Náisiúnta (2) Uimhir síntiúsóra (3) atá sainiúil don líonra (4) Giorraithe (6) |
Anaithnid (0) ISDN (1) Náisiúnta (8) |
Déileálfar leis mar uimhir ghearr a bhaineann go sonrach le tír. |
4.4.1.2 Ceann Scríbe
Tacaítear leis na teaglamaí TON agus NPI seo a leanas le haghaidh seoladh ceann scríbe. Déileálfar le gach teaglaim eile mar neamhbhailí. Úsáidfear an TON réamhshocraithe ón ordú ceangail má tá TON socraithe go Anaithnid (0). Úsáidfear an NPI réamhshocraithe ón ordú ceangailteach má tá NPI socraithe go Anaithnid (0).
| TON | NPI | Cur síos |
| Idirnáisiúnta (1) | Anaithnid (0) ISDN (1) |
Déileálfar leis mar MSISDN |
4.4.2 Ionchóduithe tacaithe
Tacaítear leis na hionchóduithe seo a leanas. Féadfaidh luach ar bith a bheith i X.
| DCS | Ionchódú |
| 0xX0 | Aibítir GSM réamhshocraithe le síneadh |
| 0xX2 | dénártha 8-giotán |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Cuóta
5.1 Cuóta Tharview
Sainmhíníonn cuóta an líon uasta teachtaireachtaí SMS is féidir a sheoladh laistigh de thréimhse ama shonraithe (amhail in aghaidh an lae, na seachtaine, na míosa, nó go ceann tréimhse éiginnte). Aithnítear gach cuóta go huathúil le quotaId (UUID) agus athshocraítear é de réir chrios ama an chustaiméara. Is féidir cuótaí a shannadh ag leibhéal na tíre, an réigiúin, nó an réamshocraithe trí Quota Pro.fileIs féidir cuóta a shannadh go dinimiciúil freisin trí úsáid a bhaint as Mapáil Cuóta. Mapálann sé seo CuótaId tuismitheora (UUID) agus Eochair chuóta uathúil (m.sh., seoltóir nó úsáideoir) chuig cuótaId ar leith.
Socraítear cuóta de réir do thacaíochta áitiúla, do bhainisteoir cuntais sannta nó de réir réamhshocraithe mura sonraítear aon rud.
5.2 Stádas 106 – Cuóta Sáraithe
Féadfar teachtaireacht SMS a bhac le cód stádais 106 (“cuóta sáraithe”) nuair:
- Sáraíonn an teachtaireacht an teorainn shainithe dá quotaId comhfhreagrach laistigh den eatramh reatha.
- Níl aon chuóta sannta don tír nó don réigiún ceann scríbe (i.e., tá sé blocáilte go sainráite le mapáil cuóta nialasach sa phrofile).
- Níl aon chuóta meaitseála ann agus níl aon chuóta réamhshocraithe sainmhínithe, rud a fhágann go ndiúltaítear dó.
Sna cásanna seo, cuireann an córas cosc ar phróiseáil bhreise teachtaireachtaí chun teorainneacha atá bunaithe ar chustaiméirí nó ar cheann scríbe a fhorfheidhmiú agus mí-úsáid a sheachaint.
Tuarascáil seachadta
Ní thacaítear ach le seachadadh ar bith nó le seachadadh deiridh le toradh rathúil/teip.
Formáid ar an tuairisc seachadta: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx déanta dáta: yyMMddHHmm stat:
Luachanna atá ar fáil i stádas:
- DELIVRD
- D’ éag
- Diúltaíodh
- UNDELIV
- Scriosta
6.1 Formáid tuairiscithe seachadta leathnaithe
D’fhéadfadh go n-iarrfaí faisnéis leathnaithe i dtuarascálacha seachadta i dteagmháil le d’ionadaí díolacháin.
Formáid ar thuairisc sheachadadh: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx fo-alt:000 dlvrd:000 dáta seolta:
yyMMddHHmm dáta críochnaithe: yyMMddHHmm stat: earráid: téacs:
Luachanna atá ar fáil i stádas:
- DELIVRD
- D’ éag
- Diúltaíodh
- UNDELIV
- Scriosta
Socrófar réimsí “fo” agus “dlvrd” go 000 i gcónaí, agus beidh an réimse “téacs” folamh i gcónaí.
Féach an chaibidil Cóid earráide le haghaidh luachanna don réimse “earráid”.
Leaganacha TLS tacaithe
Tá TLS 1.2 nó TLS 1.3 ag teastáil le haghaidh gach nasc TLS thar SMPP.
Tá deireadh le tacaíocht do TLS 1.0 agus 1.1 ó 2020-11-15. Is prótacail níos sine iad leaganacha 1.0 agus 1.1 de TLS nach bhfuil réamhmheasta agus meastar gur rioscaí slándála iad sa phobal Idirlín.
Moltar go láidir do NASC TLS a úsáid má tá naisc SMPP neamhchriptithe á n-úsáid inniu. Tá naisc SMPP neamhchriptithe i léig ó 2020-09-01 ag NASC, agus bainfear iad amach anseo. Níl dáta bainte amach nasc neamhchriptithe socraithe fós.
Tá naisc i dtreo an fhreastalaí SMPP le haghaidh TLS ag port 3601 seachas neamhchriptithe ag calafort 3600.
Féadfaidh tú TLS a úsáid fós fiú mura dtacaíonn do chur i bhfeidhm SMPP le TLS le stunnel, féach https://www.stunnel.org/
Cóid earráide
Is féidir na cóid earráide seo a leanas a fhreagairt sa réimse earráide má tá an réimse cumasaithe.
| Cód earráide | Cur síos |
| 0 | Earráid anaithnid |
| 1 | Earráid ródaithe shealadach |
| 2 | Earráid ródaithe bhuan |
| 3 | Sáraíodh an scóig uasta |
| 4 | Teorainn Ama |
| 5 | Earráid anaithnid oibreora |
| 6 | Earráid oibreora |
| 100 | Seirbhís gan aimsiú |
| 101 | Úsáideoir gan aimsiú |
| 102 | Cuntas gan aimsiú |
| 103 | Pasfhocal neamhbhailí |
| 104 | Earráid chumraíochta |
| 105 | Earráid inmheánach |
| 106 | Cuóta sáraithe |
| 200 | OK |
| 1000 | Seolta |
| 1001 | Seachadadh |
| 1002 | imithe in éag |
| 1003 | Scriosta |
| 1004 | Soghluaiste iomlán |
| 1005 | Ciúáilte |
| 1006 | Gan seachadadh |
| 1007 | Seachadadh, moill ar an muirear |
| 1008 | Gearradh, níor seoladh an teachtaireacht |
| 1009 | Gearrtha, níor seachadadh an teachtaireacht |
| 1010 | In éag, easpa tuairisce seachadta oibreora |
| 1011 | Gearrtha, teachtaireacht seolta (chuig oibreoir) |
| 1012 | Cianda scuaine |
| 1013 | Teachtaireacht seolta chuig an oibreoir, moill ar mhuirearú |
| 2000 | Uimhir foinse neamhbhailí |
| 2001 | Ní thacaítear le huimhir ghearr mar fhoinse |
| 2002 | Ní thacaítear le hAlfa mar fhoinse |
| 2003 | Ní thacaítear le MSISDN mar uimhir fhoinseach |
| 2100 | Ní thacaítear le huimhir ghearr mar cheann scríbe |
| 2101 | Ní thacaítear le hAlfa mar cheann scríbe |
| 2102 | Ní thacaítear le MSISDN mar cheann scríbe |
| 2103 | Oibríocht bactha |
| 2104 | Sínitheoir anaithnid |
| 2105 | Ceann scríbe bactha |
| 2106 | Earráid uimhreach |
| 2107 | Ceann scríbe bacáilte go sealadach |
| 2108 | Ceann scríbe neamhbhailí |
| 2200 | Earráid luchtaithe |
| 2201 | Tá cothromaíocht íseal ag an síntiúsóir |
|
2202 |
Toirmiscthe ar shíntiúsóir mar gheall ar ró-mhuirearú (préimh)
teachtaireachtaí |
|
2203 |
Síntiúsóir ró-óg (don seo go háirithe)
ábhar) |
| 2204 | Ní cheadaítear suibscríobhaí réamhíoctha |
| 2205 | Seirbhís diúltaithe ag suibscríobhaí |
| 2206 | Níl an síntiúsóir cláraithe sa chóras íocaíochta |
| 2207 | Tá an t-uasiarmhéid bainte amach ag an síntiúsóir |
| 2208 | Deimhniú úsáideora deiridh ag teastáil |
| 2300 | Aisíocadh |
|
2301 |
Níorbh fhéidir aisíocaíocht a thabhairt mar gheall ar mhídhleathach nó ar iarraidh
MSISDN |
| 2302 | Níorbh fhéidir aisíocaíocht a dhéanamh de bharr teachtaireachta id in easnamh |
| 2303 | Ciúáilte le haghaidh aisíocaíocht |
| 2304 | Teorainn ama aisíocaíochta |
| 2305 | Teip aisíocaíochta |
| 3000 | Ní thacaítear le hionchódú GSM |
| 3001 | Ní thacaítear le hionchódú UCS2 |
| 3002 | Ní thacaítear le hionchódú dénártha |
| 4000 | Ní thacaítear le tuairisc seachadta |
| 4001 | Ábhar teachtaireachta neamhbhailí |
| 4002 | Taraif neamhbhailí |
| 4003 | Sonraí neamhbhailí úsáideora |
| 4004 | Ceanntásc sonraí úsáideora neamhbhailí |
| 4005 | Códú sonraí neamhbhailí |
| 4006 | CBL neamhbhailí |
| 4007 | Ábhar nach dtacaítear leis don cheann scríbe |
Doiciméid / Acmhainní
 |
nasc soghluaisteacht SMS API, SMPP API MS Sceidealóir API [pdfTreoir Úsáideora SMS API SMPP API MS Sceidealóir API, SMS API SMPP API, MS Sceidealóir API, Sceidealóir API, API |