ارسال پیامک به یک یا چند گروه خاص از دفتر تلفن به صورت زمانبندی شده

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

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

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

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

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

نام پارامترنوعاجباری/اختیاریتوضیح
UserNameStringاجبارینام کاربری در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
PasswordStringاجباریکلمه عبور در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
NumberGroupIDLong Integerاجباریشناسه گروه دفتر تلفن
MessageBodyStringاجباریمتن پیامک متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد
SpecialNumberStringاجباریشماره اختصاصی ( شماره فرستنده پیامک ) شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید
DontSendToRepeatedNumberBooleanاجباریبه شماره های تکراری ارسال نشود؟ در متد های ارسال به گروه شماره های دفتر تلفن ، برای جلوگیری از ارسال مکرر به شماره های که در گروه/گروه ها تکرار شده اند شما می توانید با استفاده از این پارامتر از ارسال تکراری جلوگیری کنید . اگر مقدار این پارامتر را برابر False قرار دهید پیامک ها به شماره های تکراری نیز ارسال می گردد ولی اگر مقدار آن را برابر True قرار دهید پیامک ها به شماره های تکرار ارسال نمی گردد .
YearIntegerاجباریسال مورد نظر برای ارسال زمانبندی
MonthIntegerاجباریماه مورد نظر برای ارسال زمانبندی
DayIntegerاجباریروز مورد نظر برای ارسال زمانبندی
HourIntegerاجباریساعت مورد نظر برای ارسال زمانبندی
MinuteIntegerاجباریدقیقه مورد نظر برای ارسال زمانبندی
UserName
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، نام کاربری به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که نام کاربری وب سرویس و سامانه شما مشترک می باشد )
Password
از نوع String (اجباری)
در زمان ایجاد حساب کاربری ، کلمه عبور به شما داده می شود . ( اگر شما کاربر سامانه ارسال و دریافت پیام کوتاه نیز می باشید ، لازم به ذکر است که کلمه عبور وب سرویس و سامانه شما مشترک می باشد )
NumberGroupID
از نوع Long Integer (اجباری)
شناسه گروه دفتر تلفن
MessageBody
از نوع String (اجباری)
متن پیامک
متن پیامک می تواند به سه صورت فارسی ، انگلیسی یا باینری باشد
SpecialNumber
از نوع String (اجباری)
شماره اختصاصی ( شماره فرستنده پیامک )
شماره خط 3000 یا 2000 یا 1000 یا 5000 و ... می باشد که شما جهت ارسال و دریافت پیام کوتاه خریداری کرده اید . دقت بفرمایید که این شماره را فقط به صورت ???????3000 به متد ها ارسال کنید و از قرار دادن 98+ یا 98 در ابتدای آن خوداری کنید
DontSendToRepeatedNumber
از نوع Boolean (اجباری)
به شماره های تکراری ارسال نشود؟
در متد های ارسال به گروه شماره های دفتر تلفن ، برای جلوگیری از ارسال مکرر به شماره های که در گروه/گروه ها تکرار شده اند شما می توانید با استفاده از این پارامتر از ارسال تکراری جلوگیری کنید . اگر مقدار این پارامتر را برابر False قرار دهید پیامک ها به شماره های تکراری نیز ارسال می گردد ولی اگر مقدار آن را برابر True قرار دهید پیامک ها به شماره های تکرار ارسال نمی گردد .
Year
از نوع Integer (اجباری)
سال مورد نظر برای ارسال زمانبندی
Month
از نوع Integer (اجباری)
ماه مورد نظر برای ارسال زمانبندی
Day
از نوع Integer (اجباری)
روز مورد نظر برای ارسال زمانبندی
Hour
از نوع Integer (اجباری)
ساعت مورد نظر برای ارسال زمانبندی
Minute
از نوع Integer (اجباری)
دقیقه مورد نظر برای ارسال زمانبندی

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

نوع خروجیتوضیحات
Long Integerشناسه ارسال زمانبندی شده یا کد خطا

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

  • فقط کاربرانی می توانند از این متد استفاده کنند که هم کاربر وب سرویس و هم کاربر سامانه مدیریت پیام کوتاه باشند.
  • حتما تاریخ و زمان آینده را انتخاب کنید ، اگر قصد ارسال در زمان جاری را دارید ، به جای این متد از متد SendNumberGroup استفاده کنید .
  • توجه کنید برخلاف متد SendNumberGroup ، خروجی این متد شناسه ارسال زمانبندی شده شماست ، به این معنی که ارسال شما هنوز در صف ارسال سیستم قرار نگرفته است و می توانید با مراجعه به سامانه مدیریت پیام کوتاه خود ، از وضعیت ارسال زمانبندی شده ( که شناسه آن را از خروجی متد SendNumberGroupSchedule دریافت کرده اید ) مطلع شوید و در صورت نیاز این ارسال را لغو کنید .

کدهای خطا

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

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

کد خطاتوضیحات
51نام کاربری یا رمز عبور اشتباه است
52نام کاربری یا رمز عبور خالی است
59کلید MessageBody خالی است
60در حال حاضر به علت ترافیک بالا سرور توانایی پاسخ گویی ندارد در این وضعیت لطفا پیام های ارسالی خود را با استفاده از CheckingMessageID بررسی کنید و در صورت این که ارسال نشده بودند ، اقدام به ارسال مجدد آن ها بفرمایید
61کلید SpecialNumber نامعتبر است ( شماره اختصاصی وارد شده وجود ندارد یا متعلق به این کاربر نمی باشد )
62کلید SpecialNumber خالی است
63این IP اجازه دسترسی به وب سرویس این کاربر را ندارد ( برای دسترسی دادن به IP ، لطفا از بخش وب سرویس موجود در سامانه اقدام به افزودن IP مورد نظر به لیست IP های تایید شده بفرمایید )
70کاربر غیر فعال شده است ( برای اطلاع از علت غیر فعال بودن با بخش پشتیبانی تماس بگیرید )
72ترکیب پارامترهای زمان ( ترکیب Hour و Minute ) اشتباه است ( چنین زمانی وجود ندارد )
73ترکیب پارامترهای تاریخ ( ترکیب Year ، Month و Day ) اشتباه است ( چنین تاریخی وجود ندارد (
74طول کلید NumberGroupID بیش از حد مجاز است ( بیش از 1000 عدد است )
75کلید NumberGroupID خالی است
76کلید NumberGroupID نامعتبر است ( مقدار آن Null است )
77شما کاربر وب سرویس نیستید
78شما کاربر سامانه مدیریت ارسال و دریافت پیام کوتاه نیستید
80در حال حاضر وب سرویس توسط Admin غیر فعال شده است ( بعدا برای ارسال پیامک اقدام کنید )
84شماره گروه دفتر تلفن (NumberGroupID ) نامعتبر است ( وجود ندارد یا توسط کاربر حذف شده است )
203به علت کمبود اعتبار پیام کوتاه شما توانایی ارسال به این شماره را ندارید ( پس از شارژ حساب دوباره ارسال کنید )
206شماره اپراتور نامعتبر می باشد
300ارسال پیامک حاوی لینک مجاز نمی باشد ( توافقنامه ارسال لینک امضا نشده است)
400تعداد درخواست های ارسالی از حد مجاز در یک فراخوانی سرویس یا بازه زمانی بیشتر است.
666سرویس موقتاً غیر فعال است
777این IP مسدود است
888برای شماره فرستنده احراز هویت ثبت نشده است
999ارسال این پیامک مجاز نیست
3 رای ثبت شده
سان‌وی
ویرایش محتوا
پشتیبانی سامانه پیامک

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

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

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

ویرایش محتوا

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

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