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

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

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

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

برای ارسال پیامک به یک یا چند گروه خاص از دفتر تلفن موجود در سامانه مدیریت پیام کوتاه خود از این متد استفاده کنید . جهت به کارگیری آن آدرس URL زیر را فراخوانی نمایید :

https://sms.sunwaysms.com/smsws/HttpService.ashx?service=SendNumberGroup&username=$UserName$&password=$Password$&NumberGroupID=$NumberGroupID$&message=$MessageBody$&from=$SpecialNumber$&DontSendRepeat=$DontSendToRepeatedNumber$

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

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

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

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

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

  • فقط کاربرانی می توانند از این متد استفاده کنند که هم کاربر وب سرویس و هم کاربر سامانه مدیریت پیام کوتاه باشند.
  • مقدار خروجی این متد کد رهگیری ارسال می باشد ، که با مراجعه به سامانه مدیریت پیام کوتاه خود می توانید در لیست پیام های ارسال شده از وضعیت ارسال پیامک های خود مطلع شوید .
  • شما می توانید در شناسه گروه دفتر تلفن ( NumberGroupID ) ، به یک یا چند گروه ( حداکثر 1000 گروه ) پیامک ارسال کنید .
  • قبل از ارسال حتما باید با استفاده از متد GetNumberGroupData از شناسه گروه دفتر تلفن (NumberGroupID) آگاه شوید ، و مطمئن شوید گروه یا گروه های مورد نظر شما حذف نشده باشند و شناسه آن ها معتبر باشد .
  • شناسه های گروه ها در کلید NumberGroupID به صورت یک رشته ارسال می شود به طوری که توسط “,” از هم جدا می شوند .

کدهای خطا

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

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

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

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

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

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

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

ویرایش محتوا

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

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