دریافت وضعیت پیامک‌های ارسال شده

برای استفاده از وب سرویس SOAP کافی است این سرویس را از یکی از آدرس‌های زیر فراخوانی کنید و با توجه به توضیحات متد از آن استفاده کنید:

wsdl http://sms.sunwaysms.com/SMSWS/SOAP.asmx?wsdl

non-wsdl http://sms.sunwaysms.com/SMSWS/SOAP.asmx
متد GetMessageStatus

برای اطلاع از وضعیت پیامک های ارسال شده از این متد استفاده کنید . جهت به کارگیری آن آدرس URL زیر را فراخوانی نمایید :

https://sms.sunwaysms.com/smsws/HttpService.ashx?service=GetMessageStatus&username=$UserName$&password=$Password$&MessageID=$MessageID$

پارامترهای ورودی

نام پارامترنوعاجباری/اختیاریتوضیح
UserNameStringاجبارینام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
PasswordStringاجباریکلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
MessageIDArray Of Long Integerاجباریشناسه پیامک
UserName
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
Password
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
MessageID
از نوع Array Of Long Integer (اجباری)
شناسه پیامک

مقدار بازگشتی

نوع خروجیتوضیحات
Stringشامل وضعیت پیامک تا این لحظه و یا کد خطا

نکات مهم در مورد کار با متد GetMessageStatus

  • شما با استفاده از شناسه پیامک ( MessageID که خروجی متد SendArray یا GetMessageID می باشد ) به عنوان کلید متد GetMessageStatus ، می توانید از وضعیت پیامک ارسال شده مطلع شوید .
  • شناسه های پیامک در کلید MessageID به صورت یک رشته ارسال می شود به طوری که توسط “,” از هم جدا می شوند.
  • خروجی این متد یک رشته شامل وضعیت پیامک ارسالی است که توسط “,” از هم جدا شده اند . در صورت بروز خطا شماره خطا برگردانده می شود . دقت کنید که وضعیت پیامک یک عدد کوچکتر از 50 می باشد ، در غیر این صورت مقدار بازگشتی نشان دهنده یک کد خطا می باشد . کد و توضیحات مربوط به وضعیت پیامک در جدول ذیل ذکر شده است:

کدهای وضعیت پیامک

کدتوضیحات
0 شناسه پیامک نامعتبر است ( یا ممکن است شناسه پیامک ارسال شده مربوط به پیامکی باشد که بیش از یک ماه از ارسال آن می گذرد )
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
1 هنوز وضعیتی دریافت نشده است ، سیستم در حال پیگیری وضعیت پیامک از مخابرات است
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
2 پیامک به موبایل گیرنده رسیده است وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
3 پیامک به موبایل گیرنده نرسیده است ، به یکی از دلایل ذیل :
  • پر بودن Inbox موبایل گیرنده پیام
  • خاموش بودن موبایل گیرنده پیام
  • در دسترس نبودن موبایل گیرنده پیام
  • اختلال در شبکه BTS
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
4 پیامک به مرکز مخابراتی رسیده است ( در صف ارسال مخابرات قرار گرفته است و بزودی به موبایل گیرنده ارسال می گردد )
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
5 پیامک به مرکز مخابراتی نرسیده است ( این وضعیت زمانی رخ می دهد که مرکز مخابراتی نتواند به اپراتور تلفن همراه شماره گیرنده ، پیامک ارسال کند )
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
6 شماره موبایل گیرنده پیامک به درخواست کاربر در لیست غیر فعال مخابرات قرار گرفته است
هزینه این ارسال به کاربر برگردانده می شود
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
7 پیامک در صف ارسال قرار دارد ( سرور هنوز شروع به ارسال پیامک نکرده است )
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
8 سرور در حال ارسال پیامک می باشد
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
9 در زمان ارسال به علت کمبود اعتبار پیام کوتاه ، این پیامک ارسال نشده است
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود
10 پیامک ارسال نشده است ( به دلیل اختلالات ارتباطی پیامک ارسال نشده است اما سرور به مدت 2 ساعت تلاش به ارسال مجدد این پیامک می کند و اگر طی این 2 ساعت نتواند پیامک را ارسال کند ، هزینه آن را به کاربر برمی گرداند
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
11 پیامک هنوز توسط اپراتور تأیید نشده است
می توانید وضعیت این پیامک را مجددا بررسی فرمایید زیرا تغییر خواهد کرد
12 پیامک در لیست کنسل شده یا فیلتر شده قرار دارد
وضعیت این پیامک را مجددا بررسی نفرمایید زیرا تغییری در وضعیت آن حاصل نمی شود

کدهای خطا

در تمام متدهایی که مقدار String برمیگردانند ممکن است در مقدار بازگشتی ، عددی کوچکتر از 1000 و بزرگتر از 50 قرار گیرد ، در این صورت مقدار بازگشتی متد یک کد خطا می باشد و باید با توجه به جدول ذیل خطای موجود را پیدا کرده و در صورت امکان مشکل موجود را برطرف نمایید .

توجه : خود کد 50 به معنی موفقیت آمیز بودن عملیات ( Successful ) می باشد و این مقدار فقط در مقدار بازگشتی از متد InsertNumberInNumberGroup قرار می گیرد .

کد خطاتوضیحات
51نام کاربری یا رمز عبور اشتباه است
52نام کاربری یا رمز عبور خالی است
56طول آرایه MessageID بیش از حد مجاز است ( بیش از 1000 عدد است )
57کلید MessageID خالی است
58کلید MessageID نامعتبر است ( مقدار آن Null است )
60در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید
63این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید )
70کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید )
77شما کاربر وب سرویس نیستید
78شما کاربر سامانه مدیریت ارسال و دریافت پیام کوتاه نیستید
400تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است.
666سرویس موقتاً غیر فعال است
777این IP مسدود است
1 رای ثبت شده
پشتیبانی سامانه پیامک

خیلی زود با شما تماس خواهیم گرفت

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

سان‌وی
ویرایش محتوا

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

ویرایش محتوا

سامانه پیامک و وب‌سرویس هدیه

در کمتر از یک دقیقه یک سامانه پیامک و وب‌سرویس با ۳۰.۰۰۰ ریال اعتبار ارسال پیامک هدیه بگیرید