SMS API، SMPP API MS Scheduler API
راهنمای کاربر
SMS API، SMPP API MS Scheduler API
| اصلاح شده: | 6/24/2025 |
| نسخه: | 1.7 |
| نویسنده: | کنی کولاندر نوردن، KCN |
این سند فقط برای گیرنده تعیین شده است و ممکن است حاوی اطلاعات ممتاز، اختصاصی یا خصوصی باشد. اگر به اشتباه آن را دریافت کرده اید، لطفاً فوراً به فرستنده اطلاع داده و نسخه اصلی را حذف کنید. هرگونه استفاده دیگری از سند توسط شما ممنوع است.
تاریخچه را تغییر دهید
| کشیش | تاریخ | 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 | اطلاعات اضافی در مورد گزارش‌های تحویل اضافه شد اطلاعات به‌روزرسانی‌شده در مورد TLS 1.3 |
| 2. | 2025-06-03 | GM | کد نتیجه ۲۱۰۸ اضافه شد |
| 2. | 2025-06-24 | AK | سهمیه اضافه شد |
مقدمه
LINK Mobility از سال 2001 یک توزیع کننده پیامک بوده و تجربه زیادی در کار با اپراتورها و تجمیع کننده های اتصال دارد. این پلت فرم برای مدیریت حجم ترافیک زیاد، حفظ دسترسی بالا و آسان کردن مسیریابی ترافیک از طریق چندین اتصال طراحی شده است.
این سند رابط SMPP با پلتفرم SMSC و پارامترها و دستورات مورد نیاز و پارامترهای پشتیبانی شده را شرح می‌دهد.
این سند موارد استفاده خاصی مانند پیام‌های به هم پیوسته، WAPpush، پیامک فلش و غیره را پوشش نمی‌دهد. اطلاعات بیشتر در مورد این موارد را می‌توانید با تماس با پشتیبانی ارائه دهید.
دستورات پشتیبانی شده
سرور LINK Mobility باید به عنوان SMPP 3.4 در نظر گرفته شود. مشخصات رسمی را می توان در یافت https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
همه روش ها پشتیبانی نمی شوند و همه تفاوت ها در زیر مشخص شده است.
4.1 اتصال
دستورات bind زیر پشتیبانی می شوند.
- فرستنده
- فرستنده گیرنده
- گیرنده
پارامترهای مورد نیاز:
- system_id - از پشتیبانی به دست آمده است
- رمز عبور - از پشتیبانی دریافت شده است
پارامترهای اختیاری:
- addr_ton – مقدار پیش‌فرض اگر TON در حین ارسال روی Unknown تنظیم شود.
- addr_npi – مقدار پیش‌فرض اگر NPI در حین ارسال روی Unknown تنظیم شود.
پارامترهای پشتیبانی نشده:
- محدوده_ آدرس
4.2 Unbind
دستور unbind پشتیبانی می شود.
4.3 لینک استعلام
دستور inquire link پشتیبانی می شود و باید هر 60 ثانیه فراخوانی شود.
4.4 ارسال کنید
برای ارسال پیام باید از روش ارسال استفاده شود.
پارامترهای مورد نیاز:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- داده_کدینگ
- sm_length
- پیام کوتاه
پارامترهای پشتیبانی نشده:
- نوع_سرویس
- protocol_id
- اولویت_پرچم
- برنامه_زمان_تحویل
- replace_if_present_flag
- sm_default_msg_id
توجه داشته باشید که محموله tag پشتیبانی نمی شود و ممکن است در هر تماس فقط یک پیامک تحویل داده شود و توصیه می شود اعتبار_دوره tag دارای ارزش حداقل 15 دقیقه است.
4.4.1 TON و NPI توصیه شده
هنگام ارسال پیام با استفاده از دستور ارسال باید از TON و NPI زیر استفاده شود.
4.4.1.1 منبع
ترکیبات TON و NPI زیر برای آدرس منبع پشتیبانی می‌شوند. سایر ترکیبات نامعتبر تلقی خواهند شد. اگر TON روی Unknown (0) تنظیم شده باشد، از دستور پیش‌فرض TON from bind استفاده خواهد شد. اگر NPI روی Unknown (0) تنظیم شده باشد، از دستور پیش‌فرض NPI from bind استفاده خواهد شد.
| تن | NPI | توضیحات |
| حروف عددی (5) | ناشناخته (0) شماره تلفن گویا (1) |
به عنوان متن فرستنده الفبایی اعدادی در نظر گرفته می شود |
| بین المللی (1) | ناشناخته (0) شماره تلفن گویا (1) |
به عنوان MSISDN رفتار خواهد شد |
| ملی (2) مختص شبکه (3) شماره مشترک (4) اختصار (6) |
ناشناخته (0) شماره تلفن گویا (1) ملی (8) |
به عنوان شماره کوتاه خاص کشور تلقی خواهد شد. |
4.4.1.2 مقصد
ترکیب‌های TON و NPI زیر برای آدرس مقصد پشتیبانی می‌شوند. تمام ترکیبات دیگر به عنوان نامعتبر تلقی خواهند شد. اگر TON روی Unknown (0) تنظیم شود، از دستور پیش‌فرض TON from bind استفاده می‌شود. اگر NPI روی Unknown (0) تنظیم شده باشد، از دستور پیش‌فرض NPI from bind استفاده می‌شود.
| تن | NPI | توضیحات |
| بین المللی (1) | ناشناخته (0) شماره تلفن گویا (1) |
به عنوان MSISDN رفتار خواهد شد |
4.4.2 کدهای پشتیبانی شده
کدهای زیر پشتیبانی می شوند. X ممکن است حاوی هر مقدار باشد.
| DCS | رمزگذاری |
| 0xX0 | الفبای پیش فرض GSM با پسوند |
| 0xX2 | باینری 8 بیتی |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
سهمیه
۵.۱ سهمیه تمام شدview
سهمیه، حداکثر تعداد پیامک‌هایی را که می‌توان در یک بازه زمانی مشخص (مانند روز، هفته، ماه یا به طور نامحدود) ارسال کرد، تعریف می‌کند. هر سهمیه به طور منحصر به فرد توسط یک quotaId (UUID) شناسایی می‌شود و بر اساس منطقه زمانی مشتری تنظیم مجدد می‌شود. سهمیه‌ها را می‌توان از طریق Quota Pro در سطح کشور، منطقه یا سطح پیش‌فرض اختصاص داد.fileسهمیه همچنین می‌تواند به صورت پویا با استفاده از نگاشت سهمیه اختصاص داده شود. این کار یک QuotaId والد (UUID) و یک کلید سهمیه منحصر به فرد (مثلاً فرستنده یا کاربر) را به یک quotaId خاص نگاشت می‌کند.
سهمیه مطابق با پشتیبانی محلی شما، مدیر حساب تعیین‌شده شما یا اگر چیزی مشخص نشده باشد، به‌طور پیش‌فرض تعیین می‌شود.
۵.۲ وضعیت ۱۰۶ – سهمیه تکمیل شد
یک پیامک ممکن است با کد وضعیت ۱۰۶ ("سهمیه از حد مجاز فراتر رفته") مسدود شود، در صورتی که:
- پیام از حد تعریف شده برای quotaId مربوطه در بازه فعلی فراتر رفته است.
- به کشور یا منطقه مقصد هیچ سهمیه‌ای اختصاص داده نشده است (یعنی، صراحتاً با نگاشت سهمیه تهی در نرم‌افزار مسدود شده است).file).
- هیچ سهمیه تطبیقی وجود ندارد و هیچ سهمیه پیش‌فرضی تعریف نشده است که منجر به رد درخواست می‌شود.
در این موارد، سیستم از پردازش بیشتر پیام جلوگیری می‌کند تا محدودیت‌های مبتنی بر مشتری یا مقصد را اعمال کند و از سوءاستفاده جلوگیری نماید.
گزارش تحویل
فقط هیچ یا تحویل نهایی با نتیجه موفقیت آمیز/شکست پشتیبانی می شود.
قالب گزارش تحویل: شناسه: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx تاریخ انجام: yyMMddHHmm آمار:
مقادیر موجود در وضعیت:
- DELIVRD
- منقضی شده
- رد شد
- UNDELIIV
- حذف شد
6.1 فرمت گزارش تحویل گسترده
اطلاعات گسترده در گزارش های تحویل ممکن است در تماس با نماینده فروش شما درخواست شود.
قالب گزارش تحویل: شناسه: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 تاریخ ارسال:
تاریخ انجام: yyMMddHHmm آمار: خطا: متن:
مقادیر موجود در وضعیت:
- DELIVRD
- منقضی شده
- رد شد
- UNDELIIV
- حذف شد
فیلدهای "sub" و "dlvrd" همیشه روی 000 تنظیم می شوند و فیلد "متن" همیشه خالی خواهد بود.
به بخش کدهای خطا برای مقادیر فیلد "err" مراجعه کنید.
نسخه های TLS پشتیبانی شده
TLS 1.2 یا TLS 1.3 برای همه اتصالات TLS از طریق SMPP مورد نیاز است.
پشتیبانی از TLS 1.0 و 1.1 از سال 2020-11-15 متوقف شده است. نسخه های 1.0 و 1.1 TLS پروتکل های قدیمی تری هستند که منسوخ شده اند و به عنوان خطرات امنیتی در جامعه اینترنتی در نظر گرفته می شوند.
اگر امروزه از اتصالات SMPP رمزگذاری نشده استفاده می شود، LINK قویاً توصیه می کند که از TLS استفاده کنید. اتصالات SMPP رمزگذاری نشده از 2020-09-01 توسط LINK منسوخ شده و در آینده حذف خواهند شد. تاریخ حذف اتصالات رمزگذاری نشده هنوز مشخص نشده است.
اتصالات به سرور SMPP برای TLS در پورت 3601 به جای رمزگذاری نشده در پورت 3600 است.
حتی اگر اجرای SMPP شما از TLS با استفاده از stunnel پشتیبانی نمی کند، همچنان می توانید از 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 | محتوای پشتیبانی نشده برای مقصد |
اسناد / منابع
 |
تحرک پیوند SMS API، SMPP API MS Scheduler API [pdfراهنمای کاربر SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |