30% تخفیف خرید سامانه پیامکی، ویژه شروع فصل پاییز
مشاهدهٔ تعرفه‌ها

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

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

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

شما می‌توانید با استفاده از وبسرویس خدماتی-اشتراکی سامانه ملی پیامک بدون هزینه اضافه این ویژگی را به سایت، اپلیکیشن، CRM و یا سرویس‌های درون سازمانی خود اضافه کنید.

وبسرویس خدماتی-اشتراکی (که ارسال از طریق پترن یا قالب نیز از آن یاد می‌شود) به شما امکان ارسال پیامک به تمامی شماره‌ها (حتی لیست سیاه مخابرات) را خواهد داد. در اولین گام برای استفاده از این سرویس درج متن یا قالب می‌باشد که در ویدیو زیر به آن می‌پردازیم.

 

 

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

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

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

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

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

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

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

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

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

 

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

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

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

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

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

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

     

  2. سپس مطابق با شکل 2، بر روی گزینه "+درج متن جدید" کلیک کنید.
    درج پترن و الگو در وبسرویس خدماتی

    شکل 2 درج متن جدید

     

  3. سپس مطابق با شکل 3، پس از پذیرش قوانین وبسرویس خدماتی، روی گزینه "مرحله بعد" کلیک کنید.
    قوانین وبسرویس خدماتی و ارسال از پترن

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

     

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

    ارسال پیامک از طریق پترن و الگو

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

    با ذکر یک مثال نحوه درج متن را توضیح خواهیم داد:
    متن ارسالی به‌ شرح زیر خواهد بود.
    "مشتری عزیز سعید سعیدی، سفارش شما با آیتم کیف چرمی در تاریخ 1401/07/01 ثبت شد. از خرید شما متشکریم. address.com"

    هنگامی که مشتری از سایت address.com خرید انجام دهد، پیامکی مشابه با محتوای فوق برای کاربر ارسال خواهد شد. در متن فوق 3 متغیر وجود دارد که در هر خرید متفاوت خواهد بود.
    نام مشتری: سعید سعیدی
    کالایی که کاربر خریداری کرده است: کیف چرمی
    تاریخ ثبت سفارش توسط کاربر: 1401/07/01

    هنگامی که در متن متغیر وجود داشته باشد، می‌توان آنرا بصورت {0}، {1}، {2} و ... درج نمود. اولین متغیر متن {0} خواهد بود و nاُمین متغیر بصورت {n-1} در متن جایگذاری خواهد شد. بنابرین متن مورد نظر در بخش درج متن جدید (شکل 5) به‌صورت زیر تغییر خواهد یافت.
    (این نکته را به‌خاطر بسپارید که همواره به‌جای آدرس address.com باید آدرس سایت خودتان را قرار دهید که به‌عنوان نمونه از آدرس فرضی zarzar.ir استفاده شده است.)

    مشتری عزیز {0} سفارش شما با آیتم‌ {1} در تاریخ {2} ثبت شد. از خرید شما متشکریم. zarzar.ir

نمونه پترن و الگو برای ثبت سفارش

شکل 5 نمونه پترن مربوط به ثبت سفارش مشتری

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

پترن‌های ایجاد شده در وبسرویس خدماتی

شکل 6 رکوردهای ایجاد شده برای هر پترن

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

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

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

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

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

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

SendByBaseNumber

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

 

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

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

ثبت نام

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

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

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