وقتی شما در سامانه ملی‌پیامک ثبت‌نام می‌کنید، یک خط اختصاصی به شما اهدا می‌گردد. این شماره تبلیغاتی بوده و قابلیت ارسال به لیست سیاه مخابرات را نخواهد داشت. در صورتیکه شما دارای شرایط اعلام شده در ادامه این مقاله باشید، ملی‌پیامک به شما امکان استفاده از خط خدماتی اشتراکی این سامانه را خواهد داد تا با استفاده از این خط بتوانید ارسال‌های مربوط به پیامک‌های خدماتی خود را انجام دهد. این ماژول تنها بر روی وبسرویس قابل ارائه بوده و از پنل کاربری قادر به استفاده از آن نخواهید بود.
یکی از مسائل پراهمیت برای کاربران ملی پیامک ارسال اس ام اس های کد تأیید ثبت‌نام و ورود، پیامک‌های وضعیت خرید و ثبت سفارش و اطلاع‌رسانی‌های موجود شدن کالا، اتمام موجودی محصولات، سررسید فاکتور و ... به مدیران و یا مشتریان می‌باشد.
شما می‌توانید با استفاده از وبسرویس خدماتی-اشتراکی سامانه ملی پیامک بدون هزینه اضافه این ویژگی را به سایت، اپلیکیشن، CRM و یا سرویس‌های درون سازمانی خود اضافه کنید.
وبسرویس خدماتی-اشتراکی (که ارسال از طریق پترن یا قالب نیز از آن یاد می‌شود) به شما امکان ارسال پیامک به تمامی شماره‌ها (حتی لیست سیاه مخابرات) را خواهد داد. در اولین گام برای استفاده از این سرویس درج متن یا قالب می‌باشد که در ویدیو زیر به آن می‌پردازیم.
لیست سیاه مخابرات چیست؟
در اولین قدم نیاز است که بدانیم، خطوط ارسال کننده پیامک، به دو دسته تقسیم می‌شوند.
- خط تبلیغاتی: فارغ از محتوایی که از این خطوط ارسال خواهد شد، آن دسته از مشترکین مخابرات که شماره آن‌ها در لیست سیاه مخابرات قرار داشته باشد، قادر به دریافت پیامک نخواهند بود.
- خط خدماتی: تنها امکان ارسال پیامک با محتوای خدماتی (اطلاع رسانی در مورد خدمات درخواستی از سمت صاحب خط)، میسر می‌باشد و ارسال پیامک تبلیغاتی از این خطوط تبعات قانونی خواهد داشت. این خطوط قابلیت تحویل پیامک به لیست سیاه مخابرات را دارا می‌باشند.
مخابرات امکانی را فراهم نموده است تا مشترکین سیمکارت‌های همراه اول بتوانند در ازای درخواست خود، امکان دریافت پیامک‌های تبلیغاتی را لغو نمایند. در صورت انجام این عمل شماره مشترک موردنظر به لیستی خاص (لیست سیاه مخابرات) انتقال یافته و تمامی پیامک‌هایی که از خطوط تبلیغاتی ارسال خواهد شد، به این دسته از سیمکارت‌ها تحویل نخواهد شد.
چگونه بتوانیم پیامک‌های خود را به لیست سیاه مخابرات ارسال کنیم؟
برای این پرسش دو راه حل وجود دارد.
- تهیه خط خدماتی : این خط به نام صاحب پنل کاربری ثبت خواهد شد. برای آگاهی از شرایط تهیه این خطوط اطلاعیه شرایط جدید خطوط خدماتی را مطالعه فرمایید.
- استفاده از خط خدماتی-اشتراکی سامانه ملی‌پیامک : شرایط احراز برای دریافت این سرویس در ادامه عنوان خواهد شد و تنها در وبسرویس این سامانه قابلیت استفاده وجود خواهد داشت.
شرایط استفاده از خط خدماتی-اشتراکی (وبسرویس خدماتی)
- برای استفاده از این سرویس در سایت، وجود اینماد و درگاه پرداخت الزامیست.
- برای کد تأیید ثبت‌نام و ورود، هیچ مدرکی مورد نیاز نخواهد بود (اما محتوای سایت می‌بایست مورد تأیید باشد).
- برای سایت‌های پزشکی در صورت عدم وجود اینماد یا درگاه پرداخت، پروانه سازمان نظام پزشکی موردنیاز خواهد بود.
- در صورتیکه شرکت به ثبت رسیده می‌باشید، آگهی تأسیس شرکت ارسال گردد و مالکیت پنل پیامکی بنام مدیریت مجموعه باشد.
- در صورتیکه دارای app هستید، در صورت بررسی app شما و عدم وجود مشکل سرویس ارائه خواهد شد.
در ارائه وبسرویس خدماتی برای app، وجود لینک دانلود آن در کافه‌بازار و یا درگاه پرداخت امکان ارائه این سرویس را تسهیل خواهد کرد. - در صورتیکه در حال توسعه پروژه‌های مربوط به ارگان‌های دولتی می‌باشید، با ارائه نامه معرفی در سربرگ سازمان مذکور می‌توانید از این سرویس بهره‌مند شوید.
- برای سایت‌های فعال در زمینه املاک و یا آگهی، ارائه مجوز فعالیت و یا وجود اینماد در سایت الزامی است.
- جهت تسریع در ارائه این سرویس، می‌توانید پس از تهیه پنل با ارسال تیکت به بخش پشتیبانی اقدام فرمایید.
درج متن وبسرویس خدماتی
پس از اینکه سایت و یا اپلیکیشن شما امکان استفاده از وبسرویس خدماتی را دریافت نماید به سراغ تنظمیات مورد نیاز برای این سرویس خواهید پرداخت.
تنظیمات مورد نیاز در پنل کاربری:
در اولین گام نیاز است تا قالب متن مورد استفاده خود را به همراه متغیرهای متن، در پنل کاربری درج نمایید تا پس از بررسی متن ثبت شده تأیید گردد.
- در پنل کاربری خود از بخش ابزار ویژه -> وبسرویس خدماتی را انتخاب نمایید (شکل 1)
شکل 1 وبسرویس خدماتی
- سپس مطابق با شکل 2، بر روی گزینه "+درج متن جدید" کلیک کنید.
شکل 2 درج متن جدید
- سپس مطابق با شکل 3، پس از پذیرش قوانین وبسرویس خدماتی، روی گزینه "مرحله بعد" کلیک کنید.
شکل 3 قوانین وبسرویس خدماتی
- مطابق با شکل 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 رکوردهای ایجاد شده برای هر پترن
در شکل فوق توجه به دو ستون کد متن و وضعیت مهم است.
پس از درج هر متن، یک کد یکتا برای آن متن درنظر گرفته خواهد شد تا با استفاده از آن در کدهای برنامه خود و یا افزونه‌ای که ارسال از طریق پترن یا وبسرویس خدماتی را انجام می‌دهد، متن مدنظر را از طریق خطوط خدماتی اشتراکی ارسال کنید.
وضعیت متن، امکان ارسال را فراهم می‌کند و تا زمانی که متن ثبت شده، به وضعیت "تأیید شده" تغییر نکند، امکان ارسال پیامک از طریق وبسرویس خدماتی یا همان خطوط خدماتی اشتراکی سامانه وجود نخواهد داشت.
افزونه‌های ملی‌پیامک که ارسال از طریق وبسرویس خدماتی را پشتیبانی می‌کنند
- افزونه Texteller : ارسال پیامک در وردپرس/ووکامرس و فرم خبرنامه.
- افزونه Digits : ارسال پیامک کد تأیید در هنگام ثبت‌نام/ورود و فراموشی رمز عبور در وردپرس.
- افزونه اطلاع رسانی و تبلیغات پیامکی : ارسال پیامک‌های اطلاع رسانی (کاربران و مدیریت سایت) و پیامک تبلیغاتی انبوه در whmcs
- افزونه تأیید شماره تلفن همراه whmcs : ارسال پیامک کد تأیید در whmcs برای احراز هویت کاربران و محدودسازی دسترسی کاربران در صورت عدم احراز هویت.
- افزونه حمل و نقل ووکامرس : با استفاده از این افزونه می توانید با روش های ارسال پستی متنوع، محصولات فیزیکی ووکامرس خود را به فروش بگذارید.
- وبسرویس خدماتی در سامانه پرتال: یک cms اختصاصی که با استفاده از آن بتوانید فروشگاه خود را ایجاد نمایید.
- افزونه پیامک حرفه‌ای ووکامرس: ارسال پیامک برای تمامی بخش‌های مربوط به فروشگاه ووکامرس در سایت وردپرسی.
- افزونه حمل و نقل ووکامرس : با استفاده از این افزونه می توانید با روش های ارسال پستی متنوع، محصولات فیزیکی ووکامرس خود را به فروش بگذارید و در کنار آن ارسال پیامک را نیز داشته باشید.
- افزونه اتصال RSForm به پیامک : ارسال پیامک در فرم ساز مطرح RSForm.
- افزونه ارسال پیامک EDD : ارسال پیامک ثبت سفارش در EDD.
- افزونه کد تأیید ثبت‌نام جوملا : تبدیل فرم ثبت‌نام پیش فرض در cms جوملا به صفحه ثبت‌نام با شماره موبایل
استفاده از وبسرویس خدماتی در برنامه نویسی
در استفاده از وبسرویس خدماتی با استفاده از API سامانه، توابع SendByBaseNumber و یا SendByBaseNumber2 مورد استفاده قرار می‌گیرد.
SendByBaseNumber
| پارامتر های ورودی | ||
| نام پارامتر | نوع پارامتر | توضیحات |
| username | String | نام کاربری شما در سامانه |
| password | String | کلمه عبور شما در سامانه |
| text | String[] | متغیرهای موجود در متن وبسرویس خدماتی که هر کدام یک اندیس از آرایه می‌باشد. |
| to | String | شماره موبایل دریافت کننده پیامک |
| bodyId | Int | کد متن مربوط قالب وبسرویس خدماتی (الگو یا پترن) |
| مقدار بازگشتی | ||
| ReturnValue | String[] | یک عدد: recId ارسال -7 : خطایی در شماره فرستنده رخ داده است، با پشتیبانی تماس بگیرید. -6 : خطای داخلی رخ داده است، با پشتیبانی تماس بگیرید. -5: متن ارسالی با توجه به متغیرهای مشخص شده در متن پیش‌فرض همخوانی ندارد. -4 : کد متن ارسالی صحیح نمی‌باشد و یا توسط مدیر سامانه تأیید نشده است. -3 : خط ارسالی در سیستم تعریف نشده است، با پشتیبانی سامانه تماس بگیرید. -2 : محدودیت تعداد شماره‌ها، محدودیت هر بار ارسال 1 شماره موبایل می‌باشد. -1 : دسترسی برای استفاده از این وبسرویس غیرفعال است، با پشتیبانی تماس بگیرید. 0 : نام کاربری یا رمز عبور صحیح نمی‌باشد. 2 : اعتبار کافی نمی‌باشد. 6: سامانه در حال بروزرسانی می‌باشد. 7 : متن حاوی کلمه فیلتر شده می باشد. 10 : کاربر مورد نظر فعال نمی باشد. 11 : ارسال نشده 12 : مدارک کاربر کامل نمی باشد. |
در استفاده از تابع SendByBaseNumber2 تنها پارامتر text بصورت String بوده و متغیرها را با استفاده از "," از هم جدا نمایید.
برای مشاهده نمونه کدهای مختلف این API می‌توانید از Github سامانه ملی‌پیامک استفاده نمایید و یا اینکه صفحه مستندات وبسرویس خدماتی را مطالعه فرمایید.