SMS API، SMPP API MS مهالویش API
د کارن لارښود
SMS API، SMPP API MS مهالویش API
| تعدیل شوی: | 6/24/2025 |
| نسخه: | 1.7 |
| لیکوال: | Kenny Colander Norden, KCN |
دا سند یوازې د ټاکل شوي ترلاسه کونکي لپاره دی او ممکن امتیاز لرونکي ، ملکیت یا بل ډول شخصي معلومات ولري. که تاسو دا په غلطۍ ترلاسه کړی وي، مهرباني وکړئ سمدستي لیږونکي ته خبر ورکړئ او اصلي حذف کړئ. ستاسو لخوا د سند هر ډول بل کارول منع دي.
تاریخ بدل کړئ
| Rev | نیټه | By | د پخوانیو خپرونو څخه بدلونونه |
| 1.0 | 2010-03-16 | KCN | جوړ کړی |
| 1. | 2019-06-11 | TPE | د LINK لوګو تازه شوي |
| 1. | 2019-09-27 | PNI | د SMPP 3.4 مشخصاتو ته حواله اضافه شوې |
| 1. | 2019-10-31 | EP | د اعتبار موده په اړه څارنه tag |
| 1. | 2020-08-28 | KCN | د ملاتړ شوي TLS نسخو په اړه معلومات اضافه شوي |
| 2. | 2022-01-10 | KCN | Added additional information regarding delivery reports Updated information regarding TLS 1.3 |
| 2. | 2025-06-03 | GM | Added result code 2108 |
| 2. | 2025-06-24 | AK | Added quota |
پیژندنه
LINK موبیلیټ له 2001 راهیسې د SMS توزیع کونکی دی او د دواړو آپریټرانو او د ارتباط راټولونکو سره کار کولو کې خورا تجربه لري. دا پلیټ فارم د لوی ترافیک حجمونو اداره کولو لپاره ډیزاین شوی ، لوړ شتون ساتي او د ډیری ارتباطاتو له لارې ترافیک اسانه کوي.
دا سند د SMSC پلیټ فارم ته د SMPP انٹرفیس تشریح کوي او کوم پیرامیټرونه او امرونه اړین دي او کوم پیرامیټرونه ملاتړ کیږي.
This document will not handle specific use cases as concatenated messages, WAPpush, Flash SMS, etc. More information about those cases can be provided by contacting support.
ملاتړ شوي امرونه
د LINK متحرک سرور باید د SMPP 3.4 په توګه چلند وشي. رسمي توضیحات په کې موندل کیدی شي https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
ټول میتودونه ملاتړ نه کوي، او ټول توپیرونه لاندې مشخص شوي.
4.1 تړل
لاندې بانډ کمانډونه ملاتړ کیږي.
- لیږدونکی
- لیږدونکی
- رسیدونکی
اړین پیرامیټونه:
- system_id - د ملاتړ څخه ترلاسه شوی
- پټنوم - د ملاتړ څخه ترلاسه شوی
اختیاري پیرامیټونه:
- addr_ton - ډیفالټ ارزښت که TON د سپارلو پرمهال نامعلوم ته ټاکل شوی وي.
- addr_npi - ډیفالټ ارزښت که چیرې NPI د سپارلو پرمهال نامعلوم ته ټاکل شوی وي.
نه ملاتړ شوي پیرامیټونه:
- پته_رینج
4.2 تړل
د غیر پابند کمانډ ملاتړ کیږي.
4.3 د پوښتنې لینک
د پوښتنې لینک کمانډ ملاتړ شوی او باید په هر 60 ثانیو کې زنګ ووهل شي.
4.4 سپارل
د سپارلو طریقه باید د پیغام رسولو لپاره وکارول شي.
اړین پیرامیټونه:
- سرچینه_addr_ton
- سرچینه_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- ډاټا_کوډینګ
- sm_length
- لنډ_پیغام
نه ملاتړ شوي پیرامیټونه:
- د خدمت_ډول
- protocol_id
- لومړیتوب_بیرغ
- مهالویش_پیدایښت_وخت
- بدله_که_پریزنټ_بیرغ
- sm_default_msg_id
نوټ چې د پیسو بار tag ملاتړ نه کوي او په هر کال کې یوازې یو ایس ایم ایس استول کیدی شي او دا وړاندیز کیږي چې د اعتبار_دوره tag لږترلږه د 15 دقیقو اوږد ارزښت لري.
4.4.1 وړاندیز شوی TON او NPI
لاندې TON او NPI باید وکارول شي کله چې د سپارلو کمانډ په کارولو سره پیغامونه لیږل کیږي.
4.4.1.1 سرچینه
The following TON and NPI combinations are supported for source address. All other combinations will be treated as invalid. The default TON from bind command will be used if TON is set to Unknown (0). The default NPI from bind command will be used if NPI is set to Unknown (0).
| ټون | NPI | تفصیل |
| الفانومیریک (5) | نامعلوم (۵۰) ISDN (1) |
د الفانومریک لیږونکي متن په توګه به چلند وشي |
| نړیوال (1) | نامعلوم (۵۰) ISDN (1) |
د MSISDN په توګه به درملنه وشي |
| ملي (2) Network specific (3) Subscriber number (4) Abbreviated (6) |
نامعلوم (۵۰) ISDN (1) ملي (8) |
د هیواد مشخص لنډ شمیر په توګه به چلند وشي. |
4.4.1.2 منزل
لاندې TON او NPI ترکیبونه د منزل پتې لپاره ملاتړ کیږي. نور ټول ترکیبونه به د باطل په توګه وګڼل شي. د بانډ کمانډ څخه ډیفالټ TON به وکارول شي که TON نامعلوم (0) ته ټاکل شوی وي. د بانډ کمانډ څخه ډیفالټ NPI به وکارول شي که چیرې NPI نامعلوم (0) ته ټاکل شوی وي.
| ټون | NPI | تفصیل |
| نړیوال (1) | نامعلوم (۵۰) ISDN (1) |
د MSISDN په توګه به درملنه وشي |
4.4.2 ملاتړ شوي کوډونه
لاندې کوډونه ملاتړ کیږي. ایکس ممکن هر ارزښت ولري.
| DCS | کوډ کول |
| 0xX0 | ډیفالټ GSM الفبا د توسیع سره |
| 0xX2 | 8-bit بائنری |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
کوټه
۵.۱ کوټه ختمه شوهview
A quota defines the maximum number of SMS messages that can be sent within a specified time interval (such as per day, week, month, or indefinitely). Each quota is uniquely identified by a quotaId (UUID) and is reset according to the customer’s time zone. Quotas can be assigned at the country, region, or default level through a Quota Profile. Quota can also be dynamically assigned using Quota Mapping. This maps a parent QuotaId (UUID) and a unique quota Key (e.g., sender or user) to a specific quotaId.
یوه ونډه ستاسو د محلي ملاتړ، ستاسو د ټاکل شوي حساب مدیر یا په ډیفالټ ډول ټاکل کیږي که چیرې هیڅ شی مشخص نه وي.
5.2 Status 106 – Quota Exceeded
An SMS message may be blocked with status code 106 (“quota exceeded”) when:
- The message exceeds the defined limit for its corresponding quotaId within the current interval.
- The destination country or region has no quota assigned (i.e., is explicitly blocked with a null quota mapping in the profile).
- There is no matching quota and no default quota is defined, resulting in rejection.
په دې قضیو کې، سیسټم د پیغامونو د نورو پروسس کولو مخه نیسي ترڅو د پیرودونکي یا منزل پر بنسټ محدودیتونه پلي کړي او د ناوړه ګټې اخیستنې مخه ونیسي.
د سپارلو راپور
یوازې هیڅ یا نهایی تحویل د بریالي / ناکامۍ پایلې سره ملاتړ کیږي.
د سپارلو راپور بڼه: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx د ترسره شوي نیټه: yyMMddHHmm stat:
په حالت کې موجود ارزښتونه:
- ډیلیورډ
- ختم شوی
- رد کړه
- UNDELIV
- ړنګ شوی
6.1 د تحویلي راپور پراخه بڼه
د تحویلي راپورونو کې پراخه شوي معلومات ممکن ستاسو د پلور نماینده سره په تماس کې غوښتنه وشي.
Format on delivery report: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 submit date:
yyMMddHHmm done date: yyMMddHHmm stat: <status> err: <error code> text:
په حالت کې موجود ارزښتونه:
- ډیلیورډ
- ختم شوی
- رد کړه
- UNDELIV
- ړنګ شوی
"sub" او "dlvrd" ساحې به تل 000 ته ټاکل کیږي، او د "متن" ساحه به تل خالي وي.
د "غلطۍ" ساحې لپاره د ارزښتونو لپاره د څپرکي تېروتنې کوډونه وګورئ.
د TLS ملاتړ شوي نسخې
TLS 1.2 یا TLS 1.3 د SMPP په اړه د ټولو TLS اتصالاتو لپاره اړین دی.
د TLS 1.0 او 1.1 ملاتړ د 2020-11-15 راهیسې بند دی. د TLS 1.0 او 1.1 نسخه زاړه پروتوکولونه دي چې له مینځه وړل شوي او په انټرنیټ ټولنه کې د امنیتي خطرونو په توګه ګڼل کیږي.
LINK په کلکه د TLS کارولو وړاندیز کوي که چیرې نن ورځ نه کوډ شوي SMPP اړیکې کارول کیږي. نه کوډ شوي SMPP اتصالونه د LINK لخوا د 2020-09-01 پورې له مینځه وړل شوي، او په راتلونکي کې به لیرې شي. د نه کوډ شوي پیوستون لرې کولو نیټه لاهم نده ټاکل شوې.
د TLS لپاره د SMPP سرور سره اړیکې په 3601 پورټ کې د نه کوډ شوي پرځای په 3600 بندر کې دي.
تاسو ممکن لاهم TLS وکاروئ حتی که ستاسو د SMPP پلي کول د سټینیل په کارولو سره د TLS ملاتړ نه کوي ، وګورئ https://www.stunnel.org/
د تېروتنې کوډونه
د تېروتنې لاندې کوډونه د تېروتنې په ساحه کې ځواب ورکول کیدی شي که چیرې ساحه فعاله وي.
| د تېروتنې کوډ | تفصیل |
| 0 | نامعلومه تېروتنه |
| 1 | لنډمهاله روټینګ تېروتنه |
| 2 | د دايمي لارې تېروتنه |
| 3 | د تروټل کولو اعظمي حد څخه تیر شو |
| 4 | وخت ختم شو |
| 5 | آپریټر نامعلومه تېروتنه |
| 6 | د آپریټر تېروتنه |
| 100 | خدمت ونه موندل شو |
| 101 | کارن ونه موندل شو |
| 102 | حساب ونه موندل شو |
| 103 | بې اعتباره پټنوم |
| 104 | د تشکیلاتو تېروتنه |
| 105 | داخلي تېروتنه |
| 106 | Quota exceeded |
| 200 | OK |
| 1000 | لیږل شوی |
| 1001 | سپارل شوی |
| 1002 | تېر شو |
| 1003 | ړنګ شوی |
| 1004 | موبایل ډک |
| 1005 | کتار |
| 1006 | سپارل شوی نه دی |
| 1007 | سپارل شوی، چارج ځنډول شوی |
| 1008 | چارج شوی، پیغام ندی لیږل شوی |
| 1009 | چارج شوی، پیغام ندی سپارل شوی |
| 1010 | ختم شوی، د آپریټر تحویلي راپور نشتوالی |
| 1011 | چارج شوی، پیغام لیږل شوی (آپریټر ته) |
| 1012 | لیرې په کتار کې |
| 1013 | پیغام چلونکي ته لیږل شوی، چارج ځنډول شوی |
| 2000 | د ناسمې سرچینې شمیره |
| 2001 | لنډ شمیر د سرچینې په توګه نه ملاتړ کیږي |
| 2002 | الفا د سرچینې په توګه نه ملاتړ کیږي |
| 2003 | MSISDN د سرچینې شمیرې په توګه نه ملاتړ کیږي |
| 2100 | لنډ شمیر د منزل په توګه نه ملاتړ کیږي |
| 2101 | الفا د منزل په توګه نه ملاتړ کیږي |
| 2102 | MSISDN د منزل په توګه نه ملاتړ کیږي |
| 2103 | عملیات بند کړل |
| 2104 | نامعلوم پیرودونکي |
| 2105 | منزل بند شو |
| 2106 | شمېره تېروتنه |
| 2107 | منزل په موقتي توګه بند شوی |
| 2108 | Invalid destination |
| 2200 | د چارج کولو تېروتنه |
| 2201 | پیرودونکي ټیټ توازن لري |
|
2202 |
Subscriber barred for overcharged (premium)
پیغامونه |
|
2203 |
Subscriber too young (for this particular
منځپانګه) |
| 2204 | پری پیډ پیرودونکي اجازه نلري |
| 2205 | خدمت د پیرودونکي لخوا رد شوی |
| 2206 | پیرودونکي د تادیې سیسټم کې ثبت شوي ندي |
| 2207 | پیرودونکي اعظمي توازن ته رسیدلی |
| 2208 | د پای کارونکي تایید ته اړتیا ده |
| 2300 | بیرته ورکول |
|
2301 |
Could not refund due to illegal or missing
MSISDN |
| 2302 | د ورک شوي پیغام ID له امله بیرته راستنیدنه نشي کولی |
| 2303 | د بیرته ورکولو لپاره په کتار کې |
| 2304 | د بیرته ورکولو وخت پای ته ورسید |
| 2305 | د بیرته ورکولو ناکامي |
| 3000 | د GSM کوډ کول نه ملاتړ کیږي |
| 3001 | د UCS2 کوډ کول نه ملاتړ کیږي |
| 3002 | د بائنری کوډ کول نه ملاتړ کیږي |
| 4000 | د سپارلو راپور نه ملاتړ کیږي |
| 4001 | ناسم پیغام منځپانګه |
| 4002 | ناسم تعرفه |
| 4003 | د کارونکي ناسم معلومات |
| 4004 | د کارونکي د معلوماتو ناسم سرلیک |
| 4005 | د معلوماتو ناسم کوډ کول |
| 4006 | ناسم VAT |
| 4007 | د منزل لپاره غیر ملاتړ شوی مواد |
اسناد / سرچینې
 |
د لینک خوځښت SMS API، SMPP API MS مهالویش API [pdf] د کارونکي لارښود د SMS API SMPP API MS مهالویش API، SMS API SMPP API، MS مهالویش API، مهالویش API، API |