ارسال پیامک به یک/چند شماره

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

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

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

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

https://sms.sunwaysms.com/smsws/HttpService.ashx?service=SendArray&username=$UserName$&password=$Password$&to=$RecipientNumber$&message=$MessageBody$&from=$SpecialNumber&$chkMessageId=$CheckingMessageID$

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

نام پارامترنوعاجباری/اختیاریتوضیح
UserNameStringاجبارینام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
PasswordStringاجباریکلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
RecipientNumberStringاجباریشماره گیرنده ویا گیرندگان ( شماره تلفن همراه مقصد ) آرایه ای از شماره موبایل های افراد گیرنده پیامک . شما می توانید در این آرایه حداقل 1 و حداکثر 1000 عدد شماره موبایل گیرنده را جهت ارسال پیامک قرار دهید . توجه داشته باشید که فرمت شماره می بایست به یکی از شکل های زیر تعریف شود : ( در حال حاضر این سیستم توانایی ارسال پیامک به تمام اپراتورهای معتبر پیام کوتاه را دارد ) 0912??????? پیشنهاد می شود از این حالت استفاده کنید - یازده کاراکتر
98912??????? دوازده کاراکتر
912??????? ده کاراکتر
MessageBodyStringاجباریمتن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد
SpecialNumberStringاجباریشماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید
CheckingMessageIDStringاختیاریشناسه پیامک کاربر
UserName
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
Password
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
RecipientNumber
از نوع String (اجباری)
شماره گیرنده ویا گیرندگان ( شماره تلفن همراه مقصد )
آرایه ای از شماره موبایل های افراد گیرنده پیامک . شما می توانید در این آرایه حداقل 1 و حداکثر 1000 عدد شماره موبایل گیرنده را جهت ارسال پیامک قرار دهید . توجه داشته باشید که فرمت شماره می بایست به یکی از شکل های زیر تعریف شود : ( در حال حاضر این سیستم توانایی ارسال پیامک به تمام اپراتورهای معتبر پیام کوتاه را دارد ) 0912??????? پیشنهاد می شود از این حالت استفاده کنید - یازده کاراکتر
98912??????? دوازده کاراکتر
912??????? ده کاراکتر
MessageBody
از نوع String (اجباری)
متن پیامک
متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد
SpecialNumber
از نوع String (اجباری)
شماره اختصاصی ( شماره فرستنده پیامک )
شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید
CheckingMessageID
از نوع String (اختیاری)
شناسه پیامک کاربر

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

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

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

  • شما می توانید با استفاده از این متد به یک یا چند شماره پیامک ارسال کنید ، به این صورت که اگر قصد ارسال تکی را دارید در کلید RecipientNumber فقط یک شماره قرار دهید و اگر قصد ارسال به بیش از یک شماره را دارید در کلید RecipientNumber می توانید تا 1000 شماره را وارد کنید .
  • حتما قبل از ارسال از تکراری نبودن شماره های گیرندگان در آرایه ارسالی مطمئن شوید .
  • شما می توانید برای اطمینان از ارسال شدن پیامک های خود ، از کلید CheckingMessageID استفاده کنید . نحوه کار با کلید CheckingMessageID به این صورت می باشد که درهنگام استفاده از متد SendArray ، به همراه کلید RecipientNumber و به همان تعداد شماره های داخل آن ، شناسه های منحصر بفرد پیامک در سمت Application خودتان را در کلید CheckingMessageID قرار دهید و در هنگام بروز خطا ، قطع شدن ارتباط با سرور و … ، مقادیر CheckingMessageID که قبلا در متد ارسال قرار داده اید را به GetMessageID بفرستید و مقدار MessageID متناظر در سرور را بدست آورید ، و در نهایت با استفاده از متد GetMessageStatus از وضعیت آن پیام ها مطلع گردید.
  • شماره های گیرنده در کلیدRecipientNumber به صورت یک رشته ارسال می شود به طوری که توسط “,” از هم جدا می شوند.
  • شناسه های منحصر بفرد پیامک در کلید CheckingMessageID به صورت یک رشته ارسال می شود به طوری که توسط “,” از هم جدا می شوند.
  • خروجی این متد یک رشته شامل شناسه پیامک ها است که توسط “,” از هم جدا شده اند . در صورت بروز خطا شماره خطا برگردانده می شود.

کدهای خطا

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

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

کد خطاتوضیحات
51نام کاربری یا رمز عبور اشتباه است
52نام کاربری یا رمز عبور خالی است
53طول کلید RecipientNumber بیش از حد مجاز است ( بیش از 1000 عدد است )
54کلید RecipientNumber خالی است
55کلید RecipientNumber نامعتبر است ( مقدار آن Null است )
59کلید MessageBody خالی است
60در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید
61کلید SpecialNumber نامعتبر است ( شماره اختصاصی وارد شده وجود ندارد یا متعلق به این کاربر نمی باشد )
62کلید SpecialNumber خالی است
63این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید )
66طول کلید CheckingMessageID با طول کلید RecipientNumber برابر نیست
67طول آرایه CheckingMessageID بیش از حد مجاز است ( بیش از 50 عدد است )
68کلید CheckingMessageID خالی است
69کلید CheckingMessageID نامعتبر است ( مقدار آن Null است )
70کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید )
77شما کاربر وب سرویس نیستید
78شما کاربر سامانه مدیریت ارسال و دریافت پیام کوتاه نیستید
80در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید )
201فرمت شماره RecipientNumber اشتباه است
202اپراتور مخابراتی شماره RecipientNumber برای سیستم ناشناخته است
203به علت کمبود اعتبار پیام کوتاه شما توانایی ارسال به این شماره را ندارید ( پس از شارژ حساب دوباره ارسال کنید )
206شماره اپراتور نامعتبر می باشد
300ارسال پیامک حاوی لینک مجاز نمی باشد ( توافقنامه ارسال لینک امضا نشده است)
400تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است.
666سرویس موقتاً غیر فعال است
777این IP مسدود است
888برای شماره فرستنده احراز هویت ثبت نشده است
999ارسال این پیامک مجاز نیست
2 رای ثبت شده
پشتیبانی سامانه پیامک

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

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

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

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

ویرایش محتوا

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

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