راهنمای استفاده از خط خدماتی اشتراکی (وبسرویس خدماتی)

وقتی شما در سامانه ملی‌پیامک ثبت‌نام می‌کنید، یک خط اختصاصی به شما اهدا می‌گردد. این شماره تبلیغاتی بوده و قابلیت ارسال به لیست سیاه مخابرات را نخواهد داشت. ملی‌پیامک در صورتیکه شما دارای شرایط اعلام شده در ادامه این مقاله ارائه خواهد شد، باشید، به شما امکان استفاده از خط خدماتی اشتراکی این سامانه را خواهد داد تا با استفاده از این خط بتوانید ارسال‌های مربوط به پیامک‌های خدماتی خود را انجام دهد. این ماژول تنها بر روی وبسرویس قابل ارائه بوده و از پنل کاربری قادر به استفاده از آن نخواهید بود.

لیست سیاه مخابرات چیست؟

در اولین قدم نیاز است که بدانیم، خطوط ارسال کننده پیامک، به دو دسته تقسیم می‌شوند.

  • خط تبلیغاتی: فارغ از محتوایی که از این خطوط ارسال خواهد شد، آن دسته از مشترکین مخابرات که شماره آن‌ها در لیست سیاه مخابرات قرار داشته باشد، قادر به دریافت پیامک نخواهند بود.
  • خط خدماتی: تنها امکان ارسال پیامک با محتوای خدماتی (اطلاع رسانی در مورد خدمات درخواستی از سمت صاحب خط)، میسر می‌باشد و ارسال پیامک تبلیغاتی از این خطوط تبعات قانونی خواهد داشت. این خطوط قابلیت تحویل پیامک به لیست سیاه مخابرات را دارا می‌باشند.

مخابرات امکانی را فراهم نموده است تا مشترکین سیمکارت‌های همراه اول بتوانند در ازای درخواست خود، امکان دریافت پیامک‌های تبلیغاتی را لغو نمایند. در صورت انجام این عمل شماره مشترک موردنظر به لیستی خاص (لیست سیاه مخابرات) انتقال یافته و تمامی پیامک‌هایی که از خطوط تبلیغاتی ارسال خواهد شد، به این دسته از سیمکارت‌ها تحویل نخواهد شد.

چگونه بتوانیم پیامک‌های خود را به لیست سیاه مخابرات ارسال کنیم؟

برای این پرسش دو راه حل وجود دارد.

  • تهیه خط خدماتی : این خط به نام صاحب پنل کاربری ثبت خواهد شد. برای آگاهی از شرایط تهیه این خطوط اطلاعیه شرایط جدید خطوط خدماتی را مطالعه فرمایید.
  • استفاده از خط خدماتی-اشتراکی سامانه ملی‌پیامک : شرایط احراز برای دریافت این سرویس در ادامه عنوان خواهد شد و تنها در وب‌سرویس این سامانه قابلیت استفاده وجود خواهد داشت.

شرایط استفاده از خط خدماتی-اشتراکی (وبسرویس خدماتی)

  1. برای استفاده از این سرویس در سایت، وجود اینماد و درگاه پرداخت الزامیست.
  2. برای سایت‌های پزشکی علاوه بر وجود اینماد، پروانه سازمان نظام پزشکی موردنیاز خواهد بود.
  3. در صورتیکه شرکت به ثبت رسیده می‌باشید، آگهی تأسیس شرکت ارسال گردد و مالکیت پنل پیامکی بنام مدیریت مجموعه باشد.
  4. در صورتیکه دارای app هستید، در صورت بررسی app شما و عدم وجود مشکل سرویس ارائه خواهد شد.
    در ارائه وبسرویس خدماتی برای app، وجود لینک دانلود آن در کافه‌بازار امکان ارائه این سرویس را تسهیل خواهد کرد.
  5. در صورتیکه در حال توسعه پروژه‌های مربوط به ارگان‌های دولتی می‌باشید، با ارائه نامه معرفی در سربرگ سازمان مذکور می‌توانید از این سرویس بهره‌مند شوید.
  6. برای ارسال کد احراز هویت، وجود درگاه ذرین‌پال کافیست(به غیر از سایتهایی با محتوای تبلیغات، املاک و پزشکی)
  7. برای سایت‌های فعال در زمینه املاک، ارائه مجوز فعالیت و وجود اینماد در سایت الزامی است.
  8. برای سایت‌های ثبت آگهی، ارائه مجوزهای مربوطه با شرکت (و یا شخص) دارنده سایت، الزامی است.

 

تنظمیات وبسرویس خدماتی

پس از اینکه سایت و یا اپلیکیشن شما امکان استفاده از وبسرویس خدماتی را دریافت نماید به سراغ تنظمیات مورد نیاز برای این سرویس خواهید پرداخت.

تنظیمات مورد نیاز در پنل کاربری:

در اولین گام نیاز است تا قالب متن مورد استفاده خود را به همراه متغیرهای متن، در پنل کاربری درج نمایید تا پس از بررسی متن ثبت شده تأیید گردد.

  1. در پنل کاربری خود از بخش امکانات -> لیست ویژه، گزینه درج لیست ویژه جدید را انتخاب نمایید (شکل 1)
    درج لیست ویژه

    شکل 1 درج لیست ویژه

     

  2. سپس در پنجره (pop-up) باز شده، مطابق با شکل 2، یک "عنوان" دلخواه وارد نمایید، از لیست کشویی "نوع" را بر روی گزینه لیست سیاه قرار دهید، "لیست دریافت" و "لیست ارسال" خالی باشد، سپس ثبت تغییرات را انجام دهید.
    درج لیست سیاه

    شکل 2 درج لیست سیاه

     

  3. سپس مطابق با شکل 3، از بخش ابزار ویژه -> وبسرویس خدماتی،  گزینه درج متن جدید را انتخاب نمایید.
    درج متن در وبسرویس خدماتی

    شکل 3 درج متن وبسرویس خدماتی

     

  4. مطابق با شکل 4 در پنجره‌ای که مشاهده می‌کنید (پس از پذیرفتن شرایط و انتخاب گزینه مرحله بعد)، می‌توانید متن مورد نظر خود را درج نمایید.راهنما جهت تنظیم متن: با کلیک بر روی این گزینه توضیحات کاملی در مورد نحوه تنظیم متن، ارائه داده شده است.
    عنوان: یک عنوان دلخواه برای متن خود انتخاب نمایید (انتخاب یک عنوان مشخص به شما کمک می‌کند تا در زمانی که تعداد متون شما افزایش یابد، بتوانید براحتی متن خود را یافته و بررسی نمایید.)
    متن پیامک: متن مورد نظر خود را در این قسمت به همراه متغیرهای موجود انتخاب نمایید. در انتهای متن درج آدرس سایت اجباری می‌باشد (در صورتی که دارای سایت نمی‌باشید، توضیحات با ارسال تیکت به پشتیبانی ارائه خواهد شد)
    لیست ویژه (لیست سیاه): از لیست کشویی، لیست سیاهی که در بخش "لیست ویژه" درج کرده‌اید را انتخاب کنید.

    درج متن جدید در وبسرویس خدماتی

    شکل 4 درج متن جدید در وبسرویس خدماتی

    با ذکر یک مثال نحوه درج متن را توضیح خواهیم داد:
    متن ارسالی بشرح زیر خواهد بود
    "مشتری عزیز سعید سعیدی، خرید شما در تاریخ 1399/1/1 با شماره تراکنش 124587 انجام شد. آیتم‌های خریداری شده کیف چرمی و مبلغ پرداختی 1000000 تومان می‌باشد. address.com"

    هنگامی که مشتری از سایت address.com خرید انجام دهد، پیامکی مشابه با محتوای فوق برای کاربر ارسال خواهد شد. در متن فوق 4 متغیر وجود دارد که در هر خرید متفاوت خواهد بود.
    نام مشتری: سعید سعیدی
    تاریخ خرید: 1399/1/1
    شماره تراکنش مربوط به خرید انجام شده: 124587
    کالایی که کاربر خریداری کرده است: کیف چرمی
    مبلغ پرداختی: 1000000 تومان

    هنگامی که در متن متغیر وجود داشته باشد، می‌توان آنرا بصورت {0}، {1}، {2} و ... درج نمود. اولین متغیر متن {0} خواهد بود و nاُمین متغیر بصورت {n-1} در متن جایگذاری خواهد شد. بنابرین متن مورد نظر در بخش درج متن جدید (شکل 4) بصورت زیر تغییر خواهد یافت.

    مشتری عزیز {0}، خرید شما در تاریخ {1} با شماره تراکنش {2} انجام شد. آیتم‌های خریداری شده {3} و مبلغ پرداختی {4} می‌باشد. address.com

وقتی گزینه تأیید در بخش درج متن را انجام دهید، رکورد مورد نظر آن در صفحه وبسرویس خدماتی اضافه خواهد شد (شکل 5).

لیست متون وبسرویس خدماتی

شکل 5 رکوردهای وبسرویس خدماتی

در شکل فوق توجه به دو ستون کد متن و وضعیت مهم است.

پس از درج هر متن، یک کد یکتا برای آن متن درنظر گرفته خواهد شد تا با استفاده از آن در کدهای برنامه خود و یا افزونه‌ای که ارسال از وبسرویس خدماتی را انجام می‌دهد، متن مدنظر به وبسرویس خدماتی معرفی کنید.

وضعیت متن امکان ارسال را فراهم می‌کند، تا زمانی که متن ثبت شده، به وضعیت "تأیید شده" تغییر نکند، امکان ارسال پیامک از طریق وبسرویس خدماتی وجود نخواهد داشت.

افزونه‌های ملی‌پیامک که ارسال از طریق وبسرویس خدماتی را پشتیبانی می‌کنند

  • افزونه Texteller : افزونه ارسال پیامک در وردپرس/ووکامرس و فرم خبرنامه.
  • افزونه Digits : افزونه ارسال پیامک کد تأیید در هنگام ثبت‌نام/ورود و فراموشی رمز عبور در وردپرس.
  • افزونه اطلاع رسانی و تبلیغات پیامکی : ارسال پیامک‌های اطلاع رسانی (کاربران و مدیریت سایت) و پیامک تبلیغاتی انبوه در whmcs
  • افزونه تأیید شماره تلفن همراه whmcs : ارسال پیامک کد تأیید در whmcs برای احراز هویت کاربران و محدودسازی دسترسی کاربران در صورت عدم احراز هویت.
  • افزونه حمل و نقل ووکامرس : با استفاده از این افزونه می توانید با روش های ارسال پستی متنوع، محصولات فیزیکی ووکامرس خود را به فروش بگذارید.
  • وبسرویس خدماتی در سامانه پرتال: یک cms اختصاصی که با استفاده از آن بتوانید فروشگاه خود را ایجاد نمایید.

 

API استفاده از وبسرویس خدماتی

در استفاده از وبسرویس خدماتی با استفاده از API سامانه، توابع SendByBaseNumber و یا SendByBaseNumber2 مورد استفاده قرار می‌گیرد.

SendByBaseNumber

پارامتر های ورودی
نام پارامترنوع پارامترتوضیحات
usernameStringنام کاربری شما در سامانه
passwordStringکلمه عبور شما در سامانه
fromStringشماره فرستنده
textString[]آرایه ای از رشته حروف است که هر خانه آرایه شامل یک شماره موبایل می باشد، حداکثر ۱۰۰ شماره در هر بار فراخوانی
toStringمتن پیامک
bodyIdbooleanتعیین می کند آیا پیامک بصورت فلش ارسال گردد یا خیر
مقدار بازگشتی
ReturnValueString[]یک عدد: recId ارسال
-7 : خطایی در شماره فرستنده رخ داده است، با پشتیبانی تماس بگیرید.
-6 : خطای داخلی رخ داده است، با پشتیبانی تماس بگیرید.
-5: متن ارسالی با توجه به متغیرهای مشخص شده در متن پیش‌فرض همخوانی ندارد.
-4 : کد متن ارسالی صحیح نمی‌باشد و یا توسط مدیر سامانه تأیید نشده است.
-3 : خط ارسالی در سیستم تعریف نشده است، با پشتیبانی سامانه تماس بگیرید.
-2 : محدودیت تعداد شماره‌ها، محدودیت هر بار ارسال 1 شماره موبایل می‌باشد.
-1 : دسترسی برای استفاده از این وبسرویس غیرفعال است، با پشتیبانی تماس بگیرید.
0 : نام کاربری یا رمز عبور صحیح نمی‌باشد.
2 : اعتبار کافی نمی‌باشد.
6: سامانه در حال بروزرسانی می‌باشد.
7 : متن حاوی کلمه فیلتر شده می باشد.
10 : کاربر مورد نظر فعال نمی باشد.
11 : ارسال نشده
12 : مدارک کاربر کامل نمی باشد.

 

در استفاده از تابع SendByBaseNumber2 تنها پارامتر text بصورت String بوده و متغیرها را با استفاده از "," از هم جدا نمایید.

برای مشاهده نمونه کدهای مختلف این API می‌توانید از Github سامانه ملی‌پیامک استفاده نمایید.

ثبت نام

در کمتر از 1 دقیقه ارسال پیامک را شروع کنید.

پنل خود را انتخاب کنید

مشاوره تلفنی رایگان 021-63404
مشاوره رایگان تلفنی