SMS API، SMPP API MS شیڈولر API
یوزر گائیڈ

SMS API، SMPP API MS شیڈولر API

ترمیم شدہ:	6/24/2025
ورژن:	1.7
مصنف:	کینی کولنڈر نورڈن، کے سی این

یہ دستاویز صرف نامزد وصول کنندہ کے لیے ہے اور اس میں مراعات یافتہ، ملکیتی، یا دوسری صورت میں نجی معلومات شامل ہو سکتی ہیں۔ اگر آپ کو یہ غلطی سے موصول ہوا ہے تو براہ کرم فوری طور پر بھیجنے والے کو مطلع کریں اور اصل کو حذف کریں۔ آپ کے ذریعہ دستاویز کا کوئی دوسرا استعمال ممنوع ہے۔

تاریخ کو تبدیل کریں۔

Rev	تاریخ	By	پچھلی ریلیز سے تبدیلیاں
1.0	2010-03-16	کے سی این	بنایا
1.	2019-06-11	ٹی پی ای	اپ ڈیٹ کردہ LINK لوگو
1.	2019-09-27	PNI	SMPP 3.4 تفصیلات کا حوالہ شامل کیا گیا۔
1.	2019-10-31	EP	درستگی کی مدت کے بارے میں مشاہدہ tag
1.	2020-08-28	کے سی این	تعاون یافتہ TLS ورژن کے بارے میں معلومات شامل کی گئی۔
2.	2022-01-10	کے سی این	ڈیلیوری رپورٹس کے حوالے سے اضافی معلومات شامل کی گئیں۔ TLS 1.3 سے متعلق تازہ ترین معلومات
2.	2025-06-03	GM	رزلٹ کوڈ 2108 شامل کیا گیا۔
2.	2025-06-24	AK	کوٹہ شامل کر دیا گیا۔

تعارف

LINK موبلٹی 2001 سے ایک SMS ڈسٹریبیوٹر ہے اور اسے آپریٹرز اور کنکشن ایگریگیٹرز دونوں کے ساتھ کام کرنے کا کافی تجربہ ہے۔ یہ پلیٹ فارم بڑی ٹریفک والیوم کو ہینڈل کرنے، اعلیٰ دستیابی کو برقرار رکھنے اور متعدد رابطوں کے ذریعے ٹریفک کو روٹ کرنے کے لیے ڈیزائن کیا گیا ہے۔
یہ وہ دستاویز ہے جس میں ایس ایم پی پی انٹرفیس کو ایس ایم ایس سی پلیٹ فارم اور کون سے پیرامیٹرز اور کمانڈز کی ضرورت ہے اور کون سے پیرامیٹرز کی حمایت کی گئی ہے۔
یہ دستاویز مخصوص استعمال کے معاملات کو مربوط پیغامات، WAPpush، فلیش ایس ایم ایس وغیرہ کے طور پر نہیں سنبھالے گی۔ ان معاملات کے بارے میں مزید معلومات سپورٹ سے رابطہ کر کے فراہم کی جا سکتی ہیں۔

سپورٹڈ کمانڈز

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 جمع کروائیں۔
پیغامات پہنچانے کے لیے جمع کرانے کا طریقہ استعمال کیا جانا چاہیے۔
مطلوبہ پیرامیٹرز:

• source_addr_ton
• source_addr_npi
• source_addr
• dest_addr_ton
• dest_addr_npi
• dest_addr
• esm_class
• ڈیٹا_کوڈنگ
• sm_length
• چھوٹا پیغام

غیر تعاون یافتہ پیرامیٹرز:

• service_type
• protocol_id
• ترجیحی_پرچم
• شیڈول_ڈیلیوری_وقت
• اگر_موجودہ_پرچم کو تبدیل کریں۔
• sm_default_msg_id

نوٹ کہ پے لوڈ tag تعاون یافتہ نہیں ہے اور فی کال صرف ایک SMS ڈیلیور کیا جا سکتا ہے اور یہ تجویز کیا جاتا ہے کہ validity_period tag کم از کم 15 منٹ کی قدر ہے۔
4.4.1 تجویز کردہ TON اور NPI
Submit کمانڈ کا استعمال کرتے ہوئے پیغامات بھیجتے وقت درج ذیل TON اور NPI کا استعمال کیا جانا چاہیے۔
4.4.1.1 ماخذ
مندرجہ ذیل TON اور NPI کے مجموعے سورس ایڈریس کے لیے معاون ہیں۔ دیگر تمام امتزاج کو غلط سمجھا جائے گا۔ اگر TON نامعلوم (0) پر سیٹ ہو تو bind کمانڈ سے ڈیفالٹ TON استعمال کیا جائے گا۔ اگر NPI کو نامعلوم (0) پر سیٹ کیا جاتا ہے تو bind کمانڈ سے ڈیفالٹ NPI استعمال کیا جائے گا۔

ٹن	این پی آئی	تفصیل
حروف نمبری (5)	نامعلوم (0) ISDN (1)	اسے حروف نمبری بھیجنے والے متن کے طور پر سمجھا جائے گا۔
بین الاقوامی (1)	نامعلوم (0) ISDN (1)	MSISDN سمجھا جائے گا۔
قومی (2) نیٹ ورک مخصوص (3) سبسکرائبر نمبر (4) مخفف (6)	نامعلوم (0) ISDN (1) قومی (8)	ملک کے مخصوص مختصر نمبر کے طور پر سمجھا جائے گا۔

4.4.1.2 منزل
درج ذیل TON اور NPI مجموعے منزل کے پتے کے لیے معاون ہیں۔ دیگر تمام امتزاج کو غلط سمجھا جائے گا۔ اگر TON نامعلوم (0) پر سیٹ ہو تو bind کمانڈ سے ڈیفالٹ TON استعمال کیا جائے گا۔ اگر NPI کو نامعلوم (0) پر سیٹ کیا جاتا ہے تو bind کمانڈ سے ڈیفالٹ NPI استعمال کیا جائے گا۔

ٹن	این پی آئی	تفصیل
بین الاقوامی (1)	نامعلوم (0) ISDN (1)	MSISDN سمجھا جائے گا۔

4.4.2 تعاون یافتہ انکوڈنگز
درج ذیل انکوڈنگز معاون ہیں۔ X میں کوئی بھی قدر ہو سکتی ہے۔

ڈی سی ایس	انکوڈنگ
0xX0	ڈیفالٹ GSM حروف تہجی توسیع کے ساتھ
0xX2	8 بٹ بائنری

0xX8	UCS2 (ISO-10646-UCS-2)

کوٹہ

5.1 کوٹہ ختمview
کوٹہ ایس ایم ایس پیغامات کی زیادہ سے زیادہ تعداد کی وضاحت کرتا ہے جو ایک مخصوص وقت کے وقفے کے اندر بھیجے جا سکتے ہیں (جیسے فی دن، ہفتہ، مہینہ، یا غیر معینہ مدت تک)۔ ہر کوٹہ کو کوٹا آئی ڈی (UUID) کے ذریعے منفرد طور پر شناخت کیا جاتا ہے اور اسے کسٹمر کے ٹائم زون کے مطابق دوبارہ ترتیب دیا جاتا ہے۔ کوٹہ کوٹہ پرو کے ذریعے ملک، علاقے یا پہلے سے طے شدہ سطح پر تفویض کیا جا سکتا ہے۔file. کوٹا میپنگ کا استعمال کرتے ہوئے کوٹہ کو متحرک طور پر بھی تفویض کیا جا سکتا ہے۔ یہ پیرنٹ کوٹ آئی ڈی (یو یو آئی ڈی) اور ایک منفرد کوٹہ کلید (مثلاً بھیجنے والا یا صارف) کو مخصوص کوٹہ آئی ڈی پر نقش کرتا ہے۔
ایک کوٹہ آپ کے مقامی سپورٹ، آپ کے تفویض کردہ اکاؤنٹ مینیجر کے مطابق یا طے شدہ طور پر مقرر کیا جاتا ہے اگر کچھ بھی متعین نہ ہو۔
5.2 اسٹیٹس 106 – کوٹہ سے تجاوز کر گیا۔
ایک SMS پیغام کو اسٹیٹس کوڈ 106 ("کوٹہ سے تجاوز") کے ساتھ بلاک کیا جا سکتا ہے جب:

• پیغام موجودہ وقفہ کے اندر اپنے متعلقہ کوٹہ آئی ڈی کے لیے متعین حد سے زیادہ ہے۔
• منزل کے ملک یا علاقے میں کوئی کوٹہ تفویض نہیں کیا گیا ہے (یعنی پرو میں خالی کوٹہ میپنگ کے ساتھ واضح طور پر مسدود ہےfile).
• کوئی مماثل کوٹہ نہیں ہے اور کوئی ڈیفالٹ کوٹہ متعین نہیں ہے، جس کے نتیجے میں مسترد ہو جاتا ہے۔
  ان صورتوں میں، نظام گاہک یا منزل پر مبنی حدود کو نافذ کرنے اور غلط استعمال سے بچنے کے لیے مزید پیغام کی کارروائی کو روکتا ہے۔

ترسیل کی رپورٹ

کامیاب/ناکام نتیجہ کے ساتھ صرف کوئی بھی یا حتمی ڈیلیوری تعاون یافتہ نہیں ہے۔
ڈیلیوری رپورٹ پر فارمیٹ: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx مکمل ہونے کی تاریخ: yyMMddHHmm اسٹیٹ:
حالت میں دستیاب قدریں:

• DELIVRD
• میعاد ختم
• مسترد
• UNDELIV
• حذف کر دیا گیا۔

6.1 توسیعی ترسیل کی رپورٹ کی شکل
آپ کے سیلز کے نمائندے سے رابطے میں ڈیلیوری رپورٹس میں توسیعی معلومات کی درخواست کی جا سکتی ہے۔
فارمیٹ آن ڈیلیوری رپورٹ: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 جمع کرانے کی تاریخ:
yyMMddHHmm مکمل ہونے کی تاریخ: yyMMddHHmm اسٹیٹ: غلطی: متن:
حالت میں دستیاب قدریں:

• DELIVRD
• میعاد ختم
• مسترد
• UNDELIV
• حذف کر دیا گیا۔

"sub" اور "dlvrd" فیلڈز ہمیشہ 000 پر سیٹ ہوں گے، اور "ٹیکسٹ" فیلڈ ہمیشہ خالی رہے گی۔
"غلطی" فیلڈ کی اقدار کے لیے باب کے ایرر کوڈز دیکھیں۔

تعاون یافتہ TLS ورژن

SMPP پر تمام TLS کنکشنز کے لیے TLS 1.2 یا TLS 1.3 درکار ہے۔
TLS 1.0 اور 1.1 کے لیے سپورٹ 2020-11-15 سے بند ہے۔ TLS کے ورژن 1.0 اور 1.1 پرانے پروٹوکولز ہیں جن کو فرسودہ کر دیا گیا ہے اور انٹرنیٹ کمیونٹی میں حفاظتی خطرات کے طور پر سمجھا جاتا ہے۔
اگر آج غیر خفیہ کردہ SMPP کنکشنز استعمال ہو رہے ہیں تو LINK TLS استعمال کرنے کی سختی سے تجویز کرتا ہے۔ غیر مرموز کردہ SMPP کنکشنز 2020-09-01 تک LINK کے ذریعے فرسودہ ہیں، اور مستقبل میں ہٹا دیے جائیں گے۔ غیر خفیہ کردہ کنکشن ہٹانے کی تاریخ ابھی طے نہیں ہوئی ہے۔
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	کوٹہ سے تجاوز کر گیا۔
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	غلط منزل
2200	چارجنگ کی خرابی۔
2201	سبسکرائبر کا بیلنس کم ہے۔
2202	سبسکرائبر کو اوور چارجڈ (پریمیم) پر روک دیا گیا پیغامات
2203	سبسکرائبر بہت کم عمر (اس خاص کے لیے مواد)
2204	پری پیڈ سبسکرائبر کی اجازت نہیں ہے۔
2205	سبسکرائبر کے ذریعہ سروس کو مسترد کر دیا گیا۔
2206	سبسکرائبر ادائیگی کے نظام میں رجسٹرڈ نہیں ہیں۔
2207	سبسکرائبر زیادہ سے زیادہ بیلنس تک پہنچ گیا ہے۔
2208	اختتامی صارف کی تصدیق کی ضرورت ہے۔
2300	رقم کی واپسی
2301	غیر قانونی یا لاپتہ ہونے کی وجہ سے رقم واپس نہیں کی جا سکی MSISDN

2302	میسج آئی ڈی غائب ہونے کی وجہ سے ریفنڈ نہیں کیا جا سکا
2303	رقم کی واپسی کے لیے قطار میں کھڑا ہے۔
2304	ریفنڈ ٹائم آؤٹ
2305	رقم کی واپسی میں ناکامی۔
3000	GSM انکوڈنگ تعاون یافتہ نہیں ہے۔
3001	UCS2 انکوڈنگ تعاون یافتہ نہیں ہے۔
3002	بائنری انکوڈنگ تعاون یافتہ نہیں ہے۔
4000	ڈیلیوری رپورٹ تعاون یافتہ نہیں ہے۔
4001	غلط پیغام کا مواد
4002	غلط ٹیرف
4003	غلط صارف ڈیٹا
4004	غلط صارف ڈیٹا ہیڈر
4005	غلط ڈیٹا کوڈنگ
4006	غلط VAT
4007	منزل کے لیے غیر تعاون یافتہ مواد

دستاویزات / وسائل

لنک موبلٹی ایس ایم ایس API، SMPP API MS شیڈولر API [پی ڈی ایف] یوزر گائیڈ SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS شیڈولر API, Scheduler API, API

حوالہ جات

• صارف دستی