SMS API, SMPP API MS Whakahōtaka API
Aratohu Kaiwhakamahi
SMS API, SMPP API MS Whakahōtaka API
| Whakakē: | 6/24/2025 |
| Putanga: | 1.7 |
| Kaituhi: | Kenny Colander Norden, KCN |
Ko tenei tuhinga mo te kaiwhiwhi anake, a tera pea kei roto nga korero whaimana, rangatira, me etahi atu korero motuhake. Mena kua he i a koe, tena koa whakamohio atu ki te kaituku ka mukua te mea taketake. Ko etahi atu whakamahinga o te tuhinga e rahuitia ana.
Hurihia te hitori
| Rev | Rā | By | Nga huringa mai i te tukunga o mua |
| 1.0 | 2010-03-16 | KCN | Hangaia |
| 1. | 2019-06-11 | TPE | Kua whakahoutia nga waitohu LINK |
| 1. | 2019-09-27 | PNI | Kua taapirihia te tohutoro ki te SMPP 3.4 te korero |
| 1. | 2019-10-31 | EP | Te tirohanga mo te wa whaimana tag |
| 1. | 2020-08-28 | KCN | He korero taapiri mo nga putanga TLS tautoko |
| 2. | 2022-01-10 | KCN | Kua taapirihia etahi atu korero mo nga purongo tuku Nga korero kua whakahoutia mo TLS 1.3 |
| 2. | 2025-06-03 | GM | Kua taapirihia te waehere hua 2108 |
| 2. | 2025-06-24 | AK | Kua taapirihia te motunga |
Kupu Whakataki
Ko LINK Mobility he kaiwhakarato SMS mai i te tau 2001, he nui tona wheako ki te mahi tahi me nga kaiwhakahaere me nga whakahiato hononga. I hangaia tenei papaahi ki te hapai i nga pukapuka waka nui, ki te pupuri i te waatea me te ngawari ki te ara waka ma nga hononga maha.
He tuhinga tenei e whakaatu ana i te atanga SMPP ki te SMSC-platform me nga tawhā me nga whakahau e hiahiatia ana me nga tawhā e tautokohia ana.
Karekau tenei tuhinga e whakahaere i nga keehi whakamahi motuhake hei karere hono, WAPpush, Flash SMS, aha atu. Ka taea etahi atu korero mo aua keehi ma te whakapiri atu ki te tautoko.
Nga whakahau tautoko
Ko te tūmau o LINK Mobility me tohuhia hei SMPP 3.4. Ka kitea te korero whaimana i https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Ko nga tikanga katoa kaore i te tautokohia, ka tohua nga rereketanga katoa i raro nei.
4.1 Herea
Ka tautokohia nga whakahau here e whai ake nei.
- Kaituku
- Whakawhitiwhiti
- Kaiwhiwhi
Tawhā e hiahiatia ana:
- system_id – i whiwhi mai i te tautoko
- kupuhipa – i whiwhi mai i te tautoko
Nga waahanga waahanga:
- addr_ton – uara taunoa mena kua tautuhia te TON ki te Unknown i te wa e tuku ana.
- addr_npi – uara taunoa mena ka tautuhia te NPI ki te Unknown i te wa e tuku ana.
Tawhā kore tautoko:
- wāhitau_awhe
4.2 Wewetehia
Ka tautokohia te tono wetewete.
4.3 Uiui hono
Kei te tautokohia te tono hono patai, me waea ia 60 hēkona.
4.4 Tukuna
Me whakamahi te tikanga tuku mo te tuku karere.
Tawhā e hiahiatia ana:
- puna_addr_ton
- puna_addr_npi
- puna_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- raraunga_whakawaehere
- sm_roa
- poto_karere
Tawhā kore tautoko:
- momo_mahi
- kawa_id
- haki_mua
- wā_tuku_wā
- replace_if_present_flag
- sm_default_msg_id
Tuhipoka ko te utunga tag kaore i te tautokona, ka tukuna kia kotahi noa te SMS mo ia waea, ka tūtohutia kia whaimana te wa_mana tag he uara o te 15 meneti te roa i te iti rawa.
4.4.1 Te TON me te NPI e taunaki ana
Ko te TON me te NPI e whai ake nei me whakamahi ina tuku karere ma te tono tuku.
4.4.1.1 Puna
Ko nga huinga TON me te NPI e whai ake nei e tautokohia ana mo te wahitau puna. Ko era atu huinga katoa ka kiia he muhu. Ko te TON taunoa mai i te tono here ka whakamahia mena ka tautuhia te TON ki te Unknown (0). Ka whakamahia te NPI taunoa mai i te tono here mena ka tautuhia te NPI ki te Unknown (0).
| TONA | NPI | Whakaahuatanga |
| Arepa (5) | Tē Mōhiotia (0) ISDN (1) |
Ka waiho hei kuputuhi Kaituku Alphanumeric |
| Ao (1) | Tē Mōhiotia (0) ISDN (1) |
Ka kiia ko MSISDN |
| Motu (2) Whatunga motuhake (3) Tau Kaiohauru (4) Whakapoto (6) |
Tē Mōhiotia (0) ISDN (1) Motu (8) |
Ka kiia he nama poto motuhake mo te whenua. |
4.4.1.2 Te tauranga
Ko nga huinga TON me te NPI e whai ake nei ka tautokohia mo te waahi waahi. Ko era atu huinga katoa ka kiia he muhu. Ko te TON taunoa mai i te tono here ka whakamahia mena ka tautuhia te TON ki te Unknown (0). Ka whakamahia te NPI taunoa mai i te tono here mena ka tautuhia te NPI ki te Unknown (0).
| TONA | NPI | Whakaahuatanga |
| Ao (1) | Tē Mōhiotia (0) ISDN (1) |
Ka kiia ko MSISDN |
4.4.2 Tautokohia nga whakawaehere
Kei te tautokohia nga whakawaehere e whai ake nei. Kei roto pea i te X tetahi uara.
| DCS | Whakawaehere |
| 0xX0 | Tohua GSM taunoa me te toronga |
| 0xX2 | 8-bit ā-rua |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Kua Neke Atu i te Roheview
Ka tautuhia e te motunga te maha rawa o nga karere SMS ka taea te tuku i roto i te waa kua tohua (pēnei i ia ra, wiki, marama, mo ake tonu atu). Ko ia motunga kua tohua motuhake e te quotaId (UUID) ka tautuhi ano i runga i te rohe wa o te kaihoko. Ka taea te tautapa ki te whenua, rohe, taumata taunoa ranei ma te Quota Profile. Ka taea hoki te tohatoha i te waahanga ma te whakamahi i te Mahere Mahere. Ka mapi tenei i tetahi Id Motunga matua (UUID) me tetahi Kī motunga motuhake (hei tauira, te kaituku, te kaiwhakamahi ranei) ki tetahi quotaId.
Ka whakatauhia he motunga i runga i to tautoko o to rohe, to kaiwhakahaere kaute kua tohua, ma te taunoa ranei mena kaore he mea i tohua.
5.2 Te Tūnga 106 – Kua Hiahia te Moiti
Ka taea te aukati i tetahi karere SMS me te waehere mana 106 ("kua hipa te motunga") ina:
- Ka nui ake te karere i te tepe kua tautuhia mo tana motungaId i roto i te waahi o naianei.
- Ko te whenua haerenga, rohe ranei kaore he motunga kua tautapahia (arā, kua tino aukatihia ki te mahere motunga kore i roto i te profile).
- Karekau he motunga taurite, karekau he motunga taunoa e tautuhia ana, ka mutu ka whakakorehia.
I enei keehi, ka aukatihia e te punaha etahi atu tukatuka karere ki te whakamana i nga rohe o te kaihoko, i te waahi-a-haerenga ranei me te karo i te whakamahi kino.
Ripoata tuku
Karekau noa he tukunga whakamutunga me te hua angitu/rahua ka tautokona.
Whakahōputu i runga i te purongo tuku: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ra oti: yyMMddHHmm tatauranga:
Nga uara e waatea ana i te mana:
- WHAKATOKANGA
- Kua mohu
- WHAKAARO
- UNELIV
- MURU
6.1 Te whakatakotoranga purongo tuku roa
Ko nga korero taapiri i roto i nga purongo tuku ka taea te tono ma te whakapiri atu ki to kaihoko kaihoko.
Whakahōputu i runga i te purongo tuku: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 ra tuku:
yyMMddHHmm kua oti te ra: yyMMddHHmm tatauranga: hē: kupu:
Nga uara e waatea ana i te mana:
- WHAKATOKANGA
- Kua mohu
- WHAKAARO
- UNELIV
- MURU
Ko nga mara "sub" me "dlvrd" ka tautuhia ki te 000, ka noho putua te mara "kuputuhi".
Tirohia te upoko Nga waehere Hapa mo nga uara mo te mara "he".
Putanga TLS tautokona
TLS 1.2, TLS 1.3 ranei e hiahiatia ana mo nga hononga TLS katoa mo SMPP.
Ka mutu te tautoko mo te TLS 1.0 me te 1.1 mai i te 2020-11-15. Ko nga Putanga 1.0 me te 1.1 o TLS he kawa tawhito kua whakakorehia, kua kiia he raruraru haumarutanga i roto i te hapori Ipurangi.
Kei te tino taunaki a LINK ki te whakamahi i te TLS mena kei te whakamahia nga hononga SMPP kore whakamuna i enei ra. Ko nga hononga SMPP kaore i whakamunatia kua whakakorehia mai i te 2020-09-01 e LINK, ka tangohia a muri ake nei. Ko te ra mo te tango hononga kore whakamuna kaore ano kia whakatauhia.
Ko nga hononga ki te tūmau SMPP mo TLS kei te tauranga 3601 hei utu mo te kore whakamuna i te tauranga 3600.
Ka whakamahi tonu koe i te TLS ahakoa kaore to whakatinana SMPP e tautoko i te TLS ma te whakamahi i te stunnel, tirohia https://www.stunnel.org/
Waehere hapa
Ko nga waehere hapa e whai ake nei ka taea te whakautu i te mara hapa mena ka whakahohehia te mara.
| Waehere hapa | Whakaahuatanga |
| 0 | Hapa kore mohio |
| 1 | Hapa ararere rangitahi |
| 2 | Hapa ararere tuturu |
| 3 | Kua hipa ake te katereti morahi |
| 4 | Wā wā |
| 5 | Hapa kore mohiotia e te kaiwhakahaere |
| 6 | Hapa kaiwhakahaere |
| 100 | Kaore i kitea te ratonga |
| 101 | Kaore i kitea te kaiwhakamahi |
| 102 | Kaore i kitea he kaute |
| 103 | Kupuhipa muhu |
| 104 | Hapa whirihoranga |
| 105 | Hapa o roto |
| 106 | Kua hipa ake te roherohenga |
| 200 | OK |
| 1000 | Tukuna |
| 1001 | Kua tukuna |
| 1002 | Kua pau |
| 1003 | Kua mukua |
| 1004 | Ki tonu te pūkoro |
| 1005 | Tūtira |
| 1006 | Kaore i tukuna |
| 1007 | Kua tukuna, kua roa te utu |
| 1008 | Ka utua, karekau te karere i tukuna |
| 1009 | Ka utua, karekau te karere i tukuna |
| 1010 | Kua pau, kua kore he purongo tuku a nga kaiwhakahaere |
| 1011 | Ka utua, ka tukuna he karere (ki te kaiwhakahaere) |
| 1012 | Tūtira mamao |
| 1013 | I tukuna te karere ki te kaiwhakahaere, kua roa te utu |
| 2000 | Tau pūtake muhu |
| 2001 | Ko te nama poto kaore i te tautokohia hei puna |
| 2002 | Kaore i te tautokona a Alpha hei puna |
| 2003 | Kaore i te tautokona a MSISDN hei tau puna |
| 2100 | Ko te nama poto kaore i te tautokohia hei taunga |
| 2101 | Kāore a Alpha i te tautokohia hei ūnga |
| 2102 | Kaore i te tautokona a MSISDN hei haerenga |
| 2103 | Kua aukatihia te mahi |
| 2104 | Kaiohauru kore mohiotia |
| 2105 | Kua aukatihia te tauranga |
| 2106 | Hapa tau |
| 2107 | I aukatia te tauranga |
| 2108 | ūnga muhu |
| 2200 | Hapa te utu |
| 2201 | He iti te toenga o te kaiohauru |
|
2202 |
Kua aukatihia te kaiohauru mo te utu nui (moni)
karere |
|
2203 |
He tamariki rawa te kaiohauru (mo tenei waahanga
ihirangi) |
| 2204 | Kaore e whakaaetia te kaiohauru utu-mua |
| 2205 | Ka paopao te ratonga e te kaiohauru |
| 2206 | Karekau te kaiohauru i rehita ki te punaha utu |
| 2207 | Kua eke te kaiohauru ki te toenga teitei |
| 2208 | Ko te whakaūnga kaiwhakamahi mutunga e hiahiatia ana |
| 2300 | Kua whakahokia |
|
2301 |
Kaore i taea te whakahoki mai na te kore ture, kua ngaro ranei
MSISDN |
| 2302 | Kāore i taea te whakahoki nā te ngaro o te messageId |
| 2303 | Tutira mo te whakahoki |
| 2304 | Whakahokia te wa mutunga |
| 2305 | Rahunga moni whakahoki |
| 3000 | Kaore i te tautokohia te whakawaehere GSM |
| 3001 | Ko te whakawaehere UCS2 kaore i te tautokohia |
| 3002 | Kaore i te tautokona te whakawaehere-rua |
| 4000 | Kaore i te tautokohia te ripoata tuku |
| 4001 | Ihirangi karere muhu |
| 4002 | utu muhu |
| 4003 | Raraunga kaiwhakamahi muhu |
| 4004 | Pane raraunga kaiwhakamahi muhu |
| 4005 | Waehere raraunga muhu |
| 4006 | Taake muhu |
| 4007 | He ihirangi kore tautoko mo te ūnga |
Tuhinga / Rauemi
 |
hono nekeneke SMS API, SMPP API MS Hōtaka API [pdf] Aratohu Kaiwhakamahi SMS API SMPP API MS Pūhōtaka API, SMS API SMPP API, MS Whakahōtaka API, API Kaihōtaka, API |