راهنمای فوری

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

به علاوه‌ی: ارسال پیامک از طریق URL


آخرین بروزرسانی: 1397/2/29


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

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


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

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

singleSMS(portalCode as Integer,userName as string,passWord as String,mobile as String,message as String,serverType as Integer) as Long

multiSMS(portalCode as Integer,userName as String,passWord as String,Mobiles() as String,messages() as String,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

readInbox(ByVal portalCode as Integer, ByVal userName as String, password As String, latestCount as Integer,returnStatus ByRef As integer) as datatable output as system.data.datatable(kind of dotnet class)


شرح متدها:

getSystemcredit: میزان اعتبار پرتال را نشان می‌دهد.


singleSMS: ارسال پیامک تکی.


multiSMSengine: ارسال پیامک انبوه.


getDeliverystatus: استعلام وضعیت دلیوری.


readInbox: خواندن پیام‌های صندوق دریافت.



3. شرح پارامترها:

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

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

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

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

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

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

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

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

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

returnStatus,retCode: کد بازگشت عملیات.


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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

کد (14 -)= کد پرتال معتبر نیست

کد (15 -)= اعتبار سنجی با موفقیت انجام نشد

کد (20 -)= عدم ارتباط با وب سرویس مخابراتی/قطعی ارتباط با سرویس مرکز.


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

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

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

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

ارسال پیامک از طریق URL طبق فرمت ذیل انجام می‌گردد:

https://negins.com/tools/urlservice/send/?username=XXXX&password=YYYY&PortalCode=ZZZZZ&to=09120000000&message=myTest&Server=0 or 1 or 4


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



کلیدواژه‌ها: وب‌سرویس- ارسال پیامک انبوه-وب سرویس پیامدهی نگین-نام کاربری مدیر سیستم-کلمه عبور مدیر سیستم-اپراتور 3000=-اپراتور خط ثابت-وب‌سرویس نگین-کد پرتال معتبر نیست کد-اعتبار سنجی با موفقیت انجام نشد-عدم ارتباط با وب سرویس- ارسال پیامک از طریق URL-پشتیبانی سیستم‌های پیامدهی-شماره تلفن 02188346186