راهنمای فوری

استفاده از وب‌سرویس ارسال پیامک انبوه و تکی در سیستم پیامدهی نگین


آخرین بروزرسانی: 1395/7/24


1. آدرس وب سرویس پیامدهی نگین:

http://messagingws.negins.com/sendSMS.asmx?wsdl


2. متدهای فعال، پارامترهای ضروری و خروجی‌ها:

getSystemcredit(portalCode as Integer,userName as String,passWord as String) as Long

singleSMSengine(portalCode as Integer,userName as string,passWord as String,mobile as String,message as String,flashSMS as Boolean,serverType as Integer) as Long

multiSMSengine(portalCode as Integer,userName as String,passWord as String,Mobiles() as String,messages() as String,flashSMS as Boolean,serverType as Integer,retCode as integer) As Long() output as array

getDeliverystatus(ByVal portalCode as Integer, ByVal userName as String, password As String, serverType as Integer, ByVal ids() As Long) As Integer() output as array


3. شرح متدها:

portalCode: کد اشتراک یا کد پرتال.

userName: نام کاربری مدیر سیستم.

passWord: کلمه عبور مدیر سیستم.

mobile: رشته ای شامل فقط یک شماره موبایل(به‌صورت صحیح، 11 رقمی و با اعداد لاتین پر شده باشد): 09121234567.

message: رشته حاوی متن پیامک.

flashSMS: ارسال به‌صورت فلش باشد یا خیر.

serverType: کد سرور ارسال کننده (اپراتور 3000=کد 1 , اپراتور خط ثابت=کد 4 , اپراتور 50004=کد 6).

آرایه ()mobiles: آرایه‌ای متشکل از شماره موبایل‌ها در هنگام ارسال انبوه.

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

آرایه ()ids: آرایه‌ای متشکل از کدهای ارسال تکی که از خروجی متد singleSMSengine به‌دست آمده است.

retCode: کد بازگشت عملیات ارسال انبوه.


4. کدهای بازگشتی و خطا

A- ارسال تکی singleSMSengine و دریافت اعتبار پنل getSystemcredit:

کد XXXXXXX: یک عدد صحیح بزرگتر از 1000 نشاندهنده ارسال تکی موفقیت آمیز است و همین کد(شناسه ارسال) هنگام دریافت وضعیت پیامک ارسال شده و طبق متد getDeliverystatus کاربرد دارد.


کدهای بازگشتی وب‌سرویس نگین:

کد (صفر)=بدون خطا(ارسال انبوه).

کد (1-)=هنگام ارسال تکی، متن پیام مشخص نیست یا خالی است.

کد (2-)=اعتبارسنجی موفقیت‌آمیز نیست(نام کاربری/کلمه عبور/کد پرتال اشتباه است).

کد (3-)=هنگام ارسال تکی، شماره موبایل صحیح نیست یا خالی است.

کد (5-)=خطای داخلی سرور(لطفا در صورت تکرار دائم این خطا، به پشتیبانی اطلاع دهید).

کد (6-)=اعتبار(شارژ) پرتال کافی نیست.

کد (7-)=هنگام ارسال تکی، شماره موبایل وارد شده در لیست سیاه داخلی قرار دارد.

کد (8-)=آرایه موبایل‌ها خالی است/معتبر نیست.

کد (9-)=آرایه پیام‌ها خالی است/معتبر نیست.

کد (10-)=آرایه پیام‌ها و موبایل‌ها از نظر تعداد اندیس برابر نیستند.

کد (11-)=ارسال انبوه قبلی ناتمام است(در حال ارسال است) و باید صبر کنید.

کد (12-)=هنگام ارسال تکی، پیام تکراری به شماره موبایل مشابه تا چند دقیقه امکان‌پذیر نیست(می‌توانید از قسمت مربوطه این گزینه را غیرفعال نمائید).

کد (13-)=آرگومان ورودی "نوع سرور serverType" معتبر نیست/مشخص نشده است.


کدهای بازگشتی وب‌سرویس مخابراتی:

کد (0)=مرجع ارسال بر روی اپراتور "50004" تعیین شده ولی شماره 50004 معتبر نیست.

کد (12)=مرجع ارسال بر روی اپراتور "9821" تعیین شده ولی شماره 9821 معتبر نیست.

کد (20)=مرجع ارسال بر روی اپراتور "3000" تعیین شده ولی شماره 3000 معتبر نیست.

کد (111-,15,20,27)=هنگام ارسال تکی، شماره موبایل در لیست سیاه مخابرات قرار دارد.


کاربر گرامی
لطفا هرگونه سوال و یا درخواست خود را حتما با واحد پشتیبانی سیستم‌های پیامدهی، از طریق شماره تلفن 88341104 و یا ایمیل negin [at] shahreNovin.com در میان بگذارید.