SMS API, SMPP API MS Scheduler API
Rehbera bikaranînê
SMS API, SMPP API MS Scheduler API
| Guhertin: | 6 |
| Awa: | 1.7 |
| Nivîskar: | Kenny Colander Norden, KCN |
Ev belge tenê ji bo wergirê destnîşankirî ye û dibe ku agahdariya îmtiyaz, xwedan, an wekî din agahdariya taybet hebe. Ger we ew bi xeletî wergirtiye, ji kerema xwe tavilê şanderê agahdar bike û orîjînal jêbirin. Tiştek din a karanîna belgeyê ji hêla we ve qedexe ye.
Dîrok biguherînin
| Rev | Rojek | By | Guhertinên ji serbestberdana berê |
| 1.0 | 2010-03-16 | KCN | Afirandin |
| 1. | 2019-06-11 | TPE | Logoyên LINK-ê nûve kirin |
| 1. | 2019-09-27 | PNI | Li ser taybetmendiya SMPP 3.4 referansa zêde kirin |
| 1. | 2019-10-31 | EP | Çavdêriya li ser dema derbasbûnê tag |
| 1. | 2020-08-28 | KCN | Di derbarê guhertoyên TLS yên piştgirîkirî de agahdariya zêde kirin |
| 2. | 2022-01-10 | KCN | Agahiyên zêdetir derbarê raporên radestkirinê de hatine zêdekirin Agahiyên nûvekirî derbarê TLS 1.3 de |
| 2. | 2025-06-03 | GM | Koda encama 2108 lê zêde kir |
| 2. | 2025-06-24 | AK | Kotaya zêdekirî |
Pêşkêş
LINK Mobility ji sala 2001-an vir ve belavkerek SMS e û di xebata hem operator û hem jî bi berhevkarên pêwendiyê re xwedan ezmûnek pir e. Ev platform ji bo birêvebirina jimareyên mezin ên seyrûseferê hatî sêwirandin, hebûna zêde peyda dike û rêvekirina seyrûseferê bi gelek girêdan re hêsan dike.
Ev belge navrûya SMPP-ê bi platforma SMSC-ê re û kîjan parametre û fermanên pêwîst û kîjan parametre têne piştgirîkirin rave dike.
Ev belge rewşên karanîna taybetî yên wekî peyamên hevgirtî, WAPpush, Flash SMS, û hwd. nagire nav xwe. Hûn dikarin ji bo bêtir agahdarî li ser wan rewşan bi têkiliyê bi piştgiriyê re têkilî daynin.
Emrên piştgirî kirin
Divê servera LINK Mobility wekî SMPP 3.4 were hesibandin. Taybetmendiya fermî dikare li vir were dîtin https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Hemî rêbaz nayên piştgirî kirin, û hemî cûdahî li jêr têne destnîşan kirin.
4.1 Girêdan
Fermanên girêdana jêrîn têne piştgirî kirin.
- Transmitter
- Transciever
- Receiver
Parametreyên pêwîst:
- system_id - ji piştgirîyê hatî wergirtin
- şîfre - ji piştevaniyê hatî wergirtin
Parametreyên Bijarî:
- addr_ton - nirxa xwerû heke di dema şandinê de TON wekî Nenas were danîn.
- addr_npi - nirxa xwerû heke di dema şandinê de NPI wekî Nenas were danîn.
Parametreyên ne piştgirî:
- navnîşana_range
4.2 Veqetandin
Fermana unbind piştgirî ye.
4.3 Girêdana lêpirsînê
Fermana girêdana lêpirsînê piştgirî ye û divê her 60 çirkeyan carekê were bang kirin.
4.4 Bişînin
Divê rêbaza şandinê ji bo şandina peyaman were bikar anîn.
Parametreyên pêwîst:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- kurt_message
Parametreyên ne piştgirî:
- service_type
- protokol_id
- priority_flag
- schedule_delivery_time
- replace_if_present_flag
- sm_default_msg_id
Not ku payload tag nayê destek kirin û her bangek tenê SMSek dikare were radest kirin û tê pêşniyar kirin ku validity_period tag nirxa wê herî kêm 15 hûrdem e.
4.4.1 TON û NPI Pêşniyar kirin
Pêdivî ye ku TON û NPI-ya jêrîn dema şandina peyaman bi karanîna fermana şandinê were bikar anîn.
4.4.1.1 Çavkanî
Têkelên TON û NPI yên jêrîn ji bo navnîşana çavkaniyê têne piştgirî kirin. Hemû têkelên din dê wekî nederbasdar werin hesibandin. Ger TON li ser Nenas (0) were danîn, TON-a xwerû ji fermana girêdanê dê were bikar anîn. Ger NPI li ser Nenas (0) were danîn, NPI-ya xwerû ji fermana girêdanê dê were bikar anîn.
| TON | NPI | Terîf |
| Alphanumeric (5) | Nenas (0) ISDN (1) |
Dê wekî metna şandina Alphanumeric were hesibandin |
| Navneteweyî (1) | Nenas (0) ISDN (1) |
Dê wekî MSISDN were derman kirin |
| Neteweyî (2) Taybetmendiya torê (3) Hejmara aboneyê (4) Kurtekirî (6) |
Nenas (0) ISDN (1) Neteweyî (8) |
Dê wekî hejmarek kurt a taybetî ya welat were hesibandin. |
4.4.1.2 Mebest
Kombînasyona TON û NPI ya jêrîn ji bo navnîşana armancê têne piştgirî kirin. Hemî berhevokên din dê wekî nederbasdar bêne hesibandin. Ger TON li ser Nenas (0) were danîn dê TON-ya xwerû ya ji fermana bind were bikar anîn. Ger NPI-ya nenas (0) were danîn dê NPI-ya xwerû ya ji fermana bind were bikar anîn.
| TON | NPI | Terîf |
| Navneteweyî (1) | Nenas (0) ISDN (1) |
Dê wekî MSISDN were derman kirin |
4.4.2 Encodings piştgirî
Şîfreyên jêrîn têne piştgirî kirin. X dibe ku her nirxek hebe.
| DCS | Encoding |
| 0xX0 | Alfabeya GSM-ya xwerû ya bi dirêjkirinê |
| 0xX2 | 8-bit binary |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Par
5.1 Kota Zêde Bûview
Kota herî zêde hejmara peyamên SMS-ê yên ku dikarin di nav demek diyarkirî de werin şandin (wek mînak ji bo her roj, hefte, meh, an bêdawî) diyar dike. Her kota bi awayekî bêhempa ji hêla ID-ya kota (UUID) ve tê destnîşankirin û li gorî herêma demjimêrê ya xerîdar ji nû ve tê sazkirin. Kota dikarin li gorî asta welat, herêm, an asta xwerû bi rêya Quota Pro werin destnîşankirin.fileKota dikare bi awayekî dînamîk bi karanîna Nexşeya Kotayê were destnîşankirin. Ev yek QuotaId-a dêûbav (UUID) û Kilîtek kotaya bêhempa (mînak, şander an bikarhêner) bi kotaId-ek taybetî ve girêdide.
Kotayek li gorî piştgiriya we ya herêmî, rêveberê hesabê we yê destnîşankirî, an jî bi xwerû heke tiştek neyê destnîşankirin, tê danîn.
5.2 Rewşa 106 - Kota Derbas Bûye
Peyamek SMS dikare bi koda rewşê 106 ("kotayê derbas bûye") were asteng kirin dema ku:
- Peyam di navbera niha de ji sînorê diyarkirî yê ji bo kotaId-ya xwe ya têkildar derbas dibe.
- Ji bo welat an herêma armanc kotayek nehatiye destnîşankirin (ango, bi eşkereyî bi nexşeya kotayek vala di pro de hatiye astengkirin)file).
- Ne kotayeke hevber heye û ne jî kotayeke xwerû hatiye destnîşankirin, ku di encamê de redkirin çêdibe.
Di van rewşan de, pergal pêşî li pêveçûna peyamên bêtir digire da ku sînorên li ser bingeha xerîdar an jî cihê gihîştinê bicîh bîne û ji karanîna xelet dûr bisekine.
Rapora radestkirinê
Tenê yek an radestkirina dawî ya bi encamên serketî / têkçûyî têne piştgirî kirin.
Format on Report: ID: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx by Date: yymmddhhmm
Di statûyê de nirxên berdest:
- DELIVRD
- DAWÎ
- REJECTD
- UNDELIV
- DELETED
6.1 Forma raporê ya dirêjkirî
Agahdariya berfireh a di raporên radestkirinê de dibe ku di têkiliyê de bi nûnerê weya firotanê re were xwestin.
Formata li ser rapora radestkirinê: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 dîroka şandinê:
yyMMddHHmm dîroka qedandinê: yyMMddHHmm stat: çewtî: nivîstok:
Di statûyê de nirxên berdest:
- DELIVRD
- DAWÎ
- REJECTD
- UNDELIV
- DELETED
Zeviyên "sub" û "dlvrd" dê her dem wekî 000 bêne danîn, û qada "text" dê her dem vala be.
Ji bo nirxên qada "err" li beşa Kodên çewtiyê binêre.
Guhertoyên TLS piştgirî kirin
TLS 1.2 an TLS 1.3 ji bo hemî girêdanên TLS yên li ser SMPP hewce ye.
Piştgiriya ji bo TLS 1.0 û 1.1 ji sala 2020-11-15 ve tê sekinandin. Guhertoyên 1.0 û 1.1 yên TLS protokolên kevntir in ku hatine betal kirin û di civata Înternetê de wekî xetereyên ewlehiyê têne hesibandin.
LINK bi tundî pêşniyar dike ku hûn TLS bikar bînin ger îro pêwendiyên SMPP yên neşîfrekirî têne bikar anîn. Têkiliyên SMPP-ê yên neşîfrekirî ji 2020-09-01-ê ve ji hêla LINK ve têne hilweşandin, û dê di pêşerojê de werin rakirin. Dîroka rakirina girêdanên neşîfrekirî hîn ne biryar e.
Girêdanên berbi servera SMPP-ê ji bo TLS li porta 3601-ê li şûna ku li porta 3600-ê neşîfrekirî ne.
Hûn dikarin hîn jî TLS bikar bînin heke pêkanîna SMPP-ya we bi karanîna stunnelê piştgirî nede TLS, binêre https://www.stunnel.org/
Kodên çewtiyê
Dibe ku kodên çewtiyê yên jêrîn di qada xeletiyê de werin bersivandin heke ew zevî çalak be.
| Koda çewtiyê | Terîf |
| 0 | Çewtiya nenas |
| 1 | Çewtiya rêveçûna demkî |
| 2 | Çewtiya rêveçûna daîmî |
| 3 | Teqandina herî zêde derbas bû |
| 4 | Başim |
| 5 | Çewtiya nenas a operator |
| 6 | Çewtiya operator |
| 100 | Xizmet nehat dîtin |
| 101 | Bikarhêner nehat dîtin |
| 102 | Hesab nehat dîtin |
| 103 | Şîfreya nederbasdar |
| 104 | Çewtiya veavakirinê |
| 105 | Çewtiya navxweyî |
| 106 | Kota derbas bû |
| 200 | OK |
| 1000 | şandin |
| 1001 | Radest kirin |
| 1002 | Dema derbas bû |
| 1003 | Jêbirin |
| 1004 | Mobile tije |
| 1005 | Li dorê |
| 1006 | Ne teslîm kirin |
| 1007 | Teslîm kirin, lêçûn bi derengî ket |
| 1008 | Barkirin, peyam nehat şandin |
| 1009 | Barkirin, peyam nehat şandin |
| 1010 | Qediya, nebûna rapora radestkirina operator |
| 1011 | Barkirin, peyam şandin (ji operatorê re) |
| 1012 | Ji dûr ve li dorê |
| 1013 | Peyama ku ji operatorê re hat şandin, barkirin dereng maye |
| 2000 | Hejmara çavkaniyê nederbasdar |
| 2001 | Hejmara kurt wekî çavkanî nayê piştgirî kirin |
| 2002 | Alpha wekî çavkanî nayê piştgirî kirin |
| 2003 | MSISDN wekî hejmara çavkaniyê nayê piştgirî kirin |
| 2100 | Hejmara kurt wekî mebest nayê piştgirî kirin |
| 2101 | Alpha wekî mebest nayê piştgirî kirin |
| 2102 | MSISDN wekî mebest nayê piştgirî kirin |
| 2103 | Operasyon hat astengkirin |
| 2104 | Abonê nenas |
| 2105 | Mebest asteng kirin |
| 2106 | Xeletiya hejmarê |
| 2107 | Mebest bi demkî hate asteng kirin |
| 2108 | Cihê gihîştinê nederbasdar e |
| 2200 | Çewtiya barkirinê |
| 2201 | Abonet xwedî balansek kêm e |
|
2202 |
Abone ji ber zêdeperedanê (premium) hate astengkirin
messages |
|
2203 |
Abone pir ciwan e (ji bo vê taybetî)
dilşad) |
| 2204 | Aboneya pêşdibistanê destûr nayê dayîn |
| 2205 | Xizmet ji hêla abonetiyê ve hate red kirin |
| 2206 | Abonet di pergala dravdanê de ne qeydkirî ye |
| 2207 | Abonet gihîştiye balansa herî zêde |
| 2208 | Piştrastkirina bikarhênerê dawî hewce ye |
| 2300 | Vegerandin |
|
2301 |
Ji ber neqanûnî an windabûnê vegerandin ne mimkun bû
MSISDN |
| 2302 | Ji ber wendabûna peyamId nekare pere vegerîne |
| 2303 | Ji bo vegerandinê li dorê |
| 2304 | Dema vegerandinê |
| 2305 | têkçûna vegerandinê |
| 3000 | Şîfrekirina GSM nayê piştgirî kirin |
| 3001 | Şîfrekirina UCS2 nayê piştgirî kirin |
| 3002 | Şîfrekirina binary nayê piştgirî kirin |
| 4000 | Rapora radestkirinê nayê piştgirî kirin |
| 4001 | Naveroka peyama nederbasdar |
| 4002 | Tarîfa nederbasdar |
| 4003 | Daneyên bikarhêner nederbasdar |
| 4004 | Sernavê daneyên bikarhênerê nederbasdar |
| 4005 | Kodkirina daneya nederbasdar |
| 4006 | VAT nederbasdar |
| 4007 | Naveroka ne piştgirî ji bo mebestê |
Belge / Çavkanî
 |
girêdana mobîl a SMS API, SMPP API MS Scheduler API [pdf] Rehbera bikaranînê SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |