SMS API,SMPP API MS Scheduler API
Erabiltzailearen Gida
SMS API,SMPP API MS Scheduler API
| Aldatua: | 6/24/2025 |
| Bertsioa: | 1.7 |
| Egilea: | Kenny Colander Norden, KCN |
Dokumentu hau izendatutako hartzailearentzat soilik da eta informazio pribilegiatua, jabeduna edo pribatua izan dezake. Akatsez jaso baduzu, mesedez jakinarazi berehala bidaltzaileari eta ezabatu jatorrizkoa. Debekatuta dago zuk dokumentuaren beste edozein erabilera.
Aldatu historia
| Errev | Data | By | Aurreko bertsioarekiko aldaketak |
| 1.0 | 2010-03-16 | KCN | Sortu |
| 1. | 2019-06-11 | TPE | LINK logotipoak eguneratuak |
| 1. | 2019-09-27 | PNI | SMPP 3.4 zehaztapenari erreferentzia gehitu zaio |
| 1. | 2019-10-31 | EP | Baliozkotasun-aldiari buruzko behaketa tag |
| 1. | 2020-08-28 | KCN | Onartutako TLS bertsioei buruzko informazioa gehitu da |
| 2. | 2022-01-10 | KCN | Bidalketa-txostenei buruzko informazio gehigarria gehitu da TLS 1.3ri buruzko informazio eguneratua |
| 2. | 2025-06-03 | GM | 2108 emaitza kodea gehitu da |
| 2. | 2025-06-24 | AK | Gehitutako kuota |
Sarrera
LINK Mobility 2001az geroztik SMS banatzailea da eta esperientzia handia du operadoreekin zein konexio agregatzaileekin lan egiten. Plataforma hau trafiko bolumen handiak kudeatzeko, erabilgarritasun handia mantentzeko eta trafikoa hainbat konexioren bidez bideratzea errazteko diseinatuta dago.
Dokumentu honek SMPP interfazea SMSC plataformarako deskribatzen du, baita zein parametro eta komando behar diren eta zein parametro onartzen diren ere.
Dokumentu honek ez ditu erabilera kasu espezifikoak jorratuko, hala nola mezu kateatu, WAPpush, Flash SMS, etab. Kasu horiei buruzko informazio gehiago lor daiteke laguntzarekin harremanetan jarriz.
Onartutako komandoak
LINK Mobility-ren zerbitzariak SMPP 3.4 gisa tratatu behar du. Zehaztapen ofiziala helbidean aurki daiteke https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Metodo guztiak ez dira onartzen, eta desberdintasun guztiak behean zehazten dira.
4.1 Lotu
Lotura-komando hauek onartzen dira.
- Igorlea
- Transziver
- Hartzailea
Beharrezko parametroak:
- system_id - euskarritik lortutakoa
- pasahitza - laguntzatik lortutakoa
Aukerako parametroak:
- addr_ton - balio lehenetsia bidaltzean TON Ezezaguna gisa ezartzen bada.
- addr_npi - balio lehenetsia bidaltzean NPI Ezezaguna gisa ezartzen bada.
Onartu gabeko parametroak:
- helbidea_barrutia
4.2 Askatu
Unbind komandoa onartzen da.
4.3 Esteka kontsultatu
Galdetu esteka komandoa onartzen da eta 60 segundoz behin deitu behar da.
4.4 Bidali
Mezuak bidaltzeko bidalketa metodoa erabili behar da.
Beharrezko parametroak:
- iturburu_gehikina
- source_addr_npi
- iturburu_helbidea
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_klasea
- datu_kodeketa
- sm_length
- mezu_laburra
Onartu gabeko parametroak:
- zerbitzu_mota
- protokolo_id
- lehentasun_bandera
- ordutegia_entrega_ordua
- ordezkatu_baldin_present_bandera
- sm_default_msg_id
Oharra karga hori tag ez da onartzen eta dei bakoitzeko SMS bakarra bidal daiteke eta validity_period izatea gomendatzen da tag 15 minutuko balioa du gutxienez.
4.4.1 Gomendatutako TON eta NPI
Honako TON eta NPI hauek erabili behar dira mezuak bidaltzeko bidalketa komandoa erabiliz.
4.4.1.1 Iturria
Hurrengo TON eta NPI konbinazioak onartzen dira iturburu-helbiderako. Beste konbinazio guztiak baliogabetzat hartuko dira. TON lotu komandotik lehenetsitako TON erabiliko da TON Ezezaguna (0) bada. NPI lotu komandotik lehenetsitako NPI erabiliko da NPI Ezezaguna (0) bada.
| TON | NPI | Deskribapena |
| Alfazenbakizkoak (5) | Ezezaguna (0) ISDN (1) |
Igorle alfanumerikoko testu gisa tratatuko da |
| Nazioarteko (1) | Ezezaguna (0) ISDN (1) |
MSISDN gisa tratatuko da |
| Nazionala (2) Sare espezifikoa (3) Harpidedun zenbakia (4) Laburtua (6) |
Ezezaguna (0) ISDN (1) Nazionala (8) |
Herrialde zehatzeko zenbaki labur gisa tratatuko da. |
4.4.1.2 Helmuga
Helmuga helbiderako TON eta NPI konbinazio hauek onartzen dira. Beste konbinazio guztiak baliogabetzat hartuko dira. Lotura-komandoaren TON lehenetsia erabiliko da TON Ezezaguna (0) ezarrita badago. Bind komandoaren NPI lehenetsia erabiliko da NPI Ezezaguna (0) ezarrita badago.
| TON | NPI | Deskribapena |
| Nazioarteko (1) | Ezezaguna (0) ISDN (1) |
MSISDN gisa tratatuko da |
4.4.2 Onartutako kodeketak
Honako kodeketa hauek onartzen dira. X edozein balio izan dezake.
| DCS | Kodeketa |
| 0xX0 | GSM alfabeto lehenetsia luzapenarekin |
| 0xX2 | 8 biteko bitarra |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kupoa
5.1 Kuota gainditutaview
Kuotak denbora-tarte jakin batean (eguneko, asteko, hilabeteko edo mugagabeko egun bakoitzeko) bidal daitezkeen SMS mezu kopuru maximoa definitzen du. Kuota bakoitza modu bakarrean identifikatzen da quotaId (UUID) batekin eta bezeroaren ordu-zonaren arabera berrezartzen da. Kuotak herrialdean, eskualdean edo lehenetsitako mailan eslei daitezke Quota Pro baten bidez.fileKuota dinamikoki ere esleitu daiteke Kuota Mapeatuz. Honek guraso-kuota-ID bat (UUID) eta kuota-giltza bakar bat (adibidez, bidaltzailea edo erabiltzailea) kuota-ID espezifiko bati mapatzen dizkio.
Kuota zure tokiko laguntzaren, esleitutako kontu-kudeatzailearen edo, ezer zehaztu ezean, lehenespenez ezartzen da.
5.2 106 egoera – Kuota gaindituta
SMS mezu bat 106 egoera-kodearekin blokeatu daiteke (“kuota gaindituta”) honako kasu hauetan:
- Mezuak dagokion quotaId-aren muga gainditzen du uneko tartean.
- Helmugako herrialdeak edo eskualdeak ez du kuotarik esleituta (hau da, esplizituki blokeatuta dago pro-n kuota-mapeatze nulu batekin).file).
- Ez dago pareko kuotarik eta ez dago lehenetsitako kuotarik definituta, eta ondorioz, ukatua izango da.
Kasu hauetan, sistemak mezuen prozesamendu gehiago eragozten du bezeroaren edo helmugaren araberako mugak betearazteko eta erabilera okerra saihesteko.
Entrega-txostena
Emaitza arrakastatsu/hutsarekin bat edo azken entrega bat bakarrik onartzen da.
Entregako txostenaren formatua: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx egindako data: yyMMddHHmm stat:
Egoeran dauden balioak:
- ELIKADURA
- IRAUNGITUA
- EZETSI D
- EZGABEA
- EZABATUTA
6.1 Bidalketa txostenaren formatua hedatua
Entrega-txostenetan informazio hedatua eska daiteke zure salmenta-ordezkaritzarekin harremanetan jartzeko.
Bidalketa-txostenaren formatua: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 bidalketa-data:
yyMMddHHmm amaiera data: yyMMddHHmm stat: oker: testua:
Egoeran dauden balioak:
- ELIKADURA
- IRAUNGITUA
- EZETSI D
- EZGABEA
- EZABATUTA
"sub" eta "dlvrd" eremuak 000 gisa ezarriko dira beti, eta "testua" eremua beti hutsik egongo da.
Ikusi kapitulua Errore-kodeak "err" eremuko balioak ikusteko.
Onartutako TLS bertsioak
TLS 1.2 edo TLS 1.3 behar da SMPP bidezko TLS konexio guztietarako.
TLS 1.0 eta 1.1rako laguntza eten da 2020-11-15etik. TLSren 1.0 eta 1.1 bertsioak zaharkituta geratu diren protokolo zaharragoak dira eta Interneteko komunitatean segurtasun-arriskutzat hartzen direnak.
LINK-ek biziki gomendatzen du TLS erabiltzea gaur zifratu gabeko SMPP konexioak erabiltzen ari badira. Zifratu gabeko SMPP konexioak zaharkituta daude LINK-ek 2020-09-01etik, eta etorkizunean kenduko ditu. Zifratu gabeko konexioak kentzeko data ez dago oraindik erabakita.
TLSrako SMPP zerbitzarirako konexioak 3601 atakan daude zifratu gabe 3600 atakan.
TLS ere erabil dezakezu zure SMPP inplementazioak stunnel erabiliz TLS onartzen ez badu ere, ikus https://www.stunnel.org/
Errore-kodeak
Baliteke errore-kode hauek akatsen eremuan erantzutea eremua gaituta badago.
| Errore kodea | Deskribapena |
| 0 | Errore ezezaguna |
| 1 | Aldi baterako bideratze-errorea |
| 2 | Bideratze-errore iraunkorra |
| 3 | Gehienezko murrizketa gainditu da |
| 4 | Denbora-muga |
| 5 | Eragilearen errore ezezaguna |
| 6 | Eragilearen errorea |
| 100 | Ez da zerbitzua aurkitu |
| 101 | Ez da erabiltzailea aurkitu |
| 102 | Ez da kontua aurkitu |
| 103 | Pasahitz okerra |
| 104 | Konfigurazio-errorea |
| 105 | Barne akatsa |
| 106 | Kuota gainditu da |
| 200 | OK |
| 1000 | Bidali |
| 1001 | Entregatua |
| 1002 | Iraungi egin da |
| 1003 | Ezabatu da |
| 1004 | Mugikorra beteta |
| 1005 | Ilaran jarrita |
| 1006 | Ez da entregatu |
| 1007 | Entregatua, karga atzeratua |
| 1008 | Kobratuta, mezua ez da bidali |
| 1009 | Kobratuta, mezua ez da entregatu |
| 1010 | Iraungita, operadorearen entrega-txostenik eza |
| 1011 | Kobratuta, bidalitako mezua (operadoreari) |
| 1012 | Urrunetik ilaran jarrita |
| 1013 | Mezua operadoreari bidali zaio, atzeratu egin da kargatzen |
| 2000 | Iturburu-zenbaki baliogabea |
| 2001 | Zenbaki laburrak ez dira iturburu gisa onartzen |
| 2002 | Alpha ez da iturburu gisa onartzen |
| 2003 | MSISDN ez da iturburu-zenbaki gisa onartzen |
| 2100 | Zenbaki laburrak ez dira helmuga gisa onartzen |
| 2101 | Alpha ez da helmuga gisa onartzen |
| 2102 | MSISDN ez da helmuga gisa onartzen |
| 2103 | Eragiketa blokeatuta dago |
| 2104 | Harpidedun ezezaguna |
| 2105 | Helmuga blokeatu da |
| 2106 | Zenbaki-errorea |
| 2107 | Helmuga aldi baterako blokeatuta dago |
| 2108 | Helmuga baliogabea |
| 2200 | Errore bat kargatzean |
| 2201 | Harpidedunak saldo txikia du |
|
2202 |
Harpideduna debekatuta dago gehiegi kobratzeagatik (premium)
mezuak |
|
2203 |
Harpidedun gazteegia (horretarako bereziki)
edukia) |
| 2204 | Aurrez ordaindutako harpideduna ez da onartzen |
| 2205 | Harpidedunak baztertu du zerbitzua |
| 2206 | Ordainketa sisteman erregistratuta ez dagoen harpideduna |
| 2207 | Harpidedunak gehienezko saldoa lortu du |
| 2208 | Azken erabiltzailearen berrespena behar da |
| 2300 | Itzulitakoa |
|
2301 |
Ezin izan da itzuli legez kanpokoa edo falta zelako
MSISDN |
| 2302 | Ezin izan da itzuli mezuaren ID falta delako |
| 2303 | Dirua itzultzeko ilaran jarri da |
| 2304 | Itzultzeko denbora-muga |
| 2305 | Itzulketa huts egin du |
| 3000 | GSM kodeketa ez da onartzen |
| 3001 | UCS2 kodeketa ez da onartzen |
| 3002 | Kodetze bitarra ez da onartzen |
| 4000 | Bidalketa-txostena ez da onartzen |
| 4001 | Mezuaren edukia baliogabea |
| 4002 | Tarifa baliogabea |
| 4003 | Erabiltzailearen datu baliogabeak |
| 4004 | Erabiltzaile-datuen goiburua baliogabea |
| 4005 | Datuen kodeketa baliogabea |
| 4006 | BEZ baliogabea |
| 4007 | Helmugarako onartzen ez den edukia |
Dokumentuak / Baliabideak
 |
esteka mugikortasun SMS API,SMPP API MS Scheduler API [pdfErabiltzailearen gida SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |