خط خدماتی اشتراکی

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

۱. تفاوت خطوط تبلیغاتی و خدماتی

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

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

• ارسال کد تأیید ثبت‌نام/ورود.
• اطلاع‌رسانی وضعیت سفارش، سررسید فاکتور و …
• ارسال پیامک به تمامی شماره‌ها (حتی لیست سیاه).

۳. شرایط استفاده از خط خدماتی-اشتراکی

• برای وبسایت‌ها:
  • باید دارای اینماد و درگاه پرداخت باشید.
  • در صورت نداشتن اینماد، مجوزهای لازم (مثل پروانه سازمان نظام پزشکی) ارائه شود.
• برای اپلیکیشن‌ها:
  • باید لینک دانلود اپلیکیشن در کافه‌بازار یا مشابه موجود باشد.
  • وجود درگاه پرداخت در اپلیکیشن ضروری است.
• پروژه‌های دولتی:
  • ارائه نامه رسمی از ارگان دولتی مربوطه.
• سایت‌های آگهی/املاک:
  • وجود اینماد یا مجوز فعالیت الزامی است.

۴. ایجاد متن الگو در وبسرویس خدماتی
برای استفاده از خطوط خدماتی باید متن‌های ارسال خود را به‌عنوان الگو ثبت کنید.

• مراحل ثبت الگو:
  1. وارد پنل کاربری شوید و از منوی ابزار ویژه، گزینه «وبسرویس خدماتی» را انتخاب کنید.
  2. گزینه «+ درج متن جدید» را انتخاب کنید.
  3. عنوان و متن پیامک خود را وارد کنید. متن باید حاوی متغیرها ({0}، {1} و …) باشد.
  4. آدرس سایت خود را در انتهای متن درج کنید.
  5. پس از تایید متن، از کد یکتای تولیدشده برای ارسال پیامک استفاده کنید.

مثال برای ثبت الگو:
فرض کنید متنی مانند زیر دارید:

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

این متن شامل متغیرهای:

• نام مشتری: {0}
• آیتم خریداری‌شده: {1}
• تاریخ خرید: {2}

۵. افزونه‌های کاربردی ملی‌پیامک
ملی‌پیامک افزونه‌های متعددی برای اتصال به سیستم‌های مختلف ارائه می‌دهد، از جمله:

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

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

• SendByBaseNumber: برای ارسال با استفاده از الگو.
• SendByBaseNumber2: مشابه تابع اول اما با قابلیت‌های بیشتر.

این امکانات برای توسعه‌دهندگان در سایت‌ها و اپلیکیشن‌های مختلف قابل استفاده است.

پارامتر های ورودی
نام پارامتر	نوع پارامتر	توضیحات
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 : مدارک کاربر کامل نمی باشد.