وب سرویس

وب سرویس پیام کوتاه سات

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

نمونه کد و پلاگین ها

نمونه کد و افزونه

افزونه پیامک وردپرس

WP-SMS Plugin SMS

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

مشاهده جزییات

افزونه پیامک ووکامرس

Woocommerce Plugin SMS

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

مشاهده جزییات

افزونه پیامک گرویتی فرم

Gravity Forms SMS

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

مشاهده جزییات

افزونه پیامک دیجیتس

Digits Plugin SMS

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

مشاهده جزییات

نمونه کد وب سرویس به زبان Delphi

مشاهده جزییات

نرم افزار تحت ویندوز به زبان #C

# Dveloped for C

نمونه کد برای برنامه های به زبان #c

مشاهده جزییات

نمونه کد وب سرویس به زبان PHP

مشاهده جزییات

افزونه ارسال پیامک WHMCS

WHMCS verify number

ماژول اطلاع رسانی اختصاصی برای اتوماسیون WHMCS

مشاهده جزییات

افزونه تایید شماره موبایل WHMCS

WHMCS send sms

ماژول اطلاع رسانی اختصاصی برای اتوماسیون WHMCS

مشاهده جزییات

برتری های وب سرویس ما

بدون پترن ارسال

ارسال لحظه ای پیامک

خط وب سرویس خدماتی

وب سرویس ارسال پیامک

استفاده از وب سرویس پیامکی در Net.

برای استفاده از وب سرویس در دات نت از آدرس زیر استفاده کنید.

http://payamak-service.ir/SendService.svc

استفاده از وب سرویس پیامکی در PHP,Java

برای استفاده از وب سرویس در php و java از آدرس زیر استفاده کنید.

http://payamak-service.ir/SendService.svc?wsdl

برای ارسال از طریق متد Post از فرمت زير استفاده نماييد. (مناسب برای استفاده در نرم افزار هلو)

مقادیر UserName, Password, From, To, Message باید در قالب تگ فرم یا json به آدرس ذیل sumit شوندشوند

آدرس :

http://payamak-service.ir/SMSInOutBox/Send

برای ارسال از طریق متد Get نيز از فرمت زير استفاده نماييد.(مناسب برای نرم افزارهای مختلف)

http://payamak-service.ir/SMSInOutBox/SendSms?username=*****&password=*****&from=*****&to=*****&text=*****

وب سرویس ارسال پیامک

استفاده از وب سرویس پیامکی در Net.

برای استفاده از وب سرویس در دات نت از آدرس زیر استفاده کنید.

http://payamak-service.ir/SendService.svc

استفاده از وب سرویس پیامکی در PHP,Java

برای استفاده از وب سرویس در php و java از آدرس زیر استفاده کنید.

http://payamak-service.ir/SendService.svc?wsdl

برای ارسال از طریق متد Post از فرمت زير استفاده نماييد. (مناسب برای استفاده در نرم افزار هلو)

مقادیر UserName, Password, From, To, Message باید در قالب تگ فرم یا json به آدرس ذیل sumit شوندشوند

آدرس :

http://payamak-service.ir/SMSInOutBox/Send

برای ارسال از طریق متد Get نيز از فرمت زير استفاده نماييد.(مناسب برای نرم افزارهای مختلف)

http://payamak-service.ir/SMSInOutBox/SendSms?username=*****&password=*****&from=*****&to=*****&text=*****

مستندات وب سرویس

این متد برای دریافت میزان اعتبارکاربر بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
مقدار بازگشتی	decimal	میزان اعتبار کاربر به پیامک می باشد مقدار اعتبار صفر یا عددی برزگتر از صفر می باشد در غیر اینصورت : 1 - نام کاربری و رمز عبور صحیح نمی باشد 2 - کاربر غیرفعال می باشد

این متد جهت دریافت تعداد پیامهای دریافتی بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
isRead	bool	مقدار true برای پیامهای خوانده شده مقدار false برای پیامهای خوانده نشده
مقدار بازگشتی	int	اگر نام کاربری و رمز عبور صحیح باشد مقدار برگشتی یک عدد می باشد که بر اساس پارامتر isRead بیانگر تعداد پیامها دریافتی می باشد 1 - : نام کاربری و رمز عبور صحیح نمی باشد

از این متد جهت ارسال پیامک به یک تا حداکثر 100 شماره بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
fromNumber	string	شماره فرستنده
toNumbers	[] string	آرایه ای از شماره موبایل های گیرندگان می باشد حداکثر 100 شماره در هر بار فراخوانی
messageContent	string	متن پیامک
isFlash	bool	تعیین میکند آیا پیامک به صورت فلش ارسال گردد یا خیر
ref recId	[] int	هر خانه آرایه یک عدد یکتا به ازای هر گیرنده تولید می کند، این کد یکتا برای دریافت وضعیت تحویل کاربر دارد
ref status	[] byte	هر خانه آرایه عدد 0 یا 1 بوده به ازای هر گیرنده تولید می شود، 1 به معنی ارسال شده و 0 ارسال نشده
مقدار بازگشتی	int	0: ارسال با موفقیت انجام شد 1: نام کاربر یا کلمه عبور نامعتبر می باشد. 2: کاربر مسدود شده است 3:شماره فرستنده نامعتبر است. 4: محدودیت در ارسال روزانه. 5: تعداد گیرندگان حداکثر 100 شماره می باشد. 6: خط فرستنده غیر فعال است. 7: متن پیامک شامل کلمات فیلتر شده است. 8: اعتبار کافی نیست. 9: سامانه در حال بروز رسانی می باشد. 10:وب سرویس غیر فعال است 11: وب سرویس غیرفعال است. 12:تعداد پیام و شماره ها باید یکسان باشد 13:تعداد پیام ها حداکثر 100 عدد باید باشد 14:تعرفه مشخص نشده است 15:تشخیص ارسال تکراری توسط سامانه 16:شماره موبایل گیرنده معتبر نیست 17:خط OTP برای کاربر یافت نشد 18:از این شماره فرستنده فقط ارسال تکی مجاز است

از این متد جهت ارسال پیامک به یک تا حداکثر 100 شماره به کار می رود.

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
fromNumber	string	شماره فرستنده
toNumbers	[] string	آرایه ای از شماره موبایل های گیرندگان می باشد حداکثر 100 شماره در هر بار فراخوانی
messageContent	string	متن پیامک
isFlash	bool	تعیین میکند آیا پیامک به صورت فلش ارسال گردد یا خیر
out batchSmsId	int	شناسه ارسال گروهی
مقدار بازگشتی	int	0: ارسال با موفقیت انجام شد 1: نام کاربر یا کلمه عبور نامعتبر می باشد. 2: کاربر مسدود شده است 3:شماره فرستنده نامعتبر است. 4: محدودیت در ارسال روزانه. 5: تعداد گیرندگان حداکثر 100 شماره می باشد. 6: خط فرستنده غیر فعال است. 7: متن پیامک شامل کلمات فیلتر شده است. 8: اعتبار کافی نیست. 9: سامانه در حال بروز رسانی می باشد. 10:وب سرویس غیر فعال است 11: وب سرویس غیرفعال است. 12:تعداد پیام و شماره ها باید یکسان باشد 13:تعداد پیام ها حداکثر 100 عدد باید باشد 14:تعرفه مشخص نشده است 15:تشخیص ارسال تکراری توسط سامانه 16:شماره موبایل گیرنده معتبر نیست 17:خط OTP برای کاربر یافت نشد 18:از این شماره فرستنده فقط ارسال تکی مجاز است

از این متد جهت ارسال پیامک به یک تا حداکثر 100 شماره به کار می رود.

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
batchSmsId	int	شناسه ارسال با متد SendBatchSms
numbers	[] string	آرایه ای از شماره موبایل های گیرندگان می باشد
index	int	اندیس مربوط به ردیف پیام ارسالی، توجه مقدار اندیس از 1 شروع می شود.
count	int	تعداد رکورد درخواستی، حداکثر 100
deliveryStatus	[] int	آرایه ی از وضعیت تحویل متناظر با آرایه شماره موبایل ها می باشد ترجمه مقدار وضعیت تحویل: 5 - : برای گرفتن گزارش تحویل حداقل یک دقیقه بعد از ارسال اقدام نمایید 4 - : به علت اینکه پیام در صف ارسال مخابرات می باشد، امکان گرفتن گزارش تحویل وجود ندارد 3 - : به علت اینکه مهلت یک هفته ای گرفتن گزارش پایان یافته است، امکان گرفتن گزارش تحویل وجود ندارد 2 - : پیام با این کد وجود ندارد (batchSmsId نامعتبر است) 1 - : خطا در ارتباط با سرویس دهنده 0 : ارسال شده به مخابرات 1 : رسیده به گوشی 2 : نرسیده به گوشی 3 : خطای مخابراتی 4 : خطای نامشخص 5 : رسیده به مخابرات 6 : نرسیده به مخابرات 7 : مسدود شده توسط مقصد 8 : نامشخص 9 : مخابرات پیام را مردود اعلام کرد 1 : کنسل شده توسط اپراتور 11 : ارسال نشده
مقدار بازگشتی	int	1 - : نام کاربری و رمز عبور صحیح نمی باشد 2 - : ارسال با مقدار شناسه batchSmsId وجود ندارد

از این متد جهت دریافت پیامک های دریافتی یا ارسالی استفاده می شود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
messageType	int	مشخص کننده نوع پیامک است، اگر 1 باشد پیامک های دریافتی و اگر 2 باشد پیامک های ارسالی را مشخص می کند
fromNumbers	[] string	آرایه ی از شماره های فرستنده می باشد مانند : 10002188
index	int	اندیس مربوط به ردیف پیام های دریافتی، توجه مقدار اندیس از 1 شروع می شود
count	int	تعداد رکورد درخواستی، حداکثر 1000
مقدار بازگشتی	[] MessageInfo	آرایه ی از نوع MessageInfo
FromDate	string	تاریخ شروع(شمسی) فرمت نمونه:1400/01/01
ToDate	string	تاریخ پایان(شمسی) فرمت نمونه:1400/10/01
تاریخ شروع و پایان اختیاری است،دو نسخه از این متد برای پوشش هر دو حالت تعبیه شده است

این متد جهت دریافت وضعیت تحویل پیامک ارسال شده بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
recId	long	شناسه پیامک ارسال شده
مقدار بازگشتی	int	وضعیت تحویل پیامک می باشد ترجمه مقدار وضعیت تحویل: 5 - : برای گرفتن گزارش تحویل حداقل یک دقیقه بعد از ارسال اقدام نمایید 4 - : به علت اینکه پیام در صف ارسال مخابرات می باشد، امکان گرفتن گزارش تحویل وجود ندارد 3 - : به علت اینکه مهلت یک هفته ای گرفتن گزارش پایان یافته است، امکان گرفتن گزارش تحویل وجود ندارد 2 - : پیام با این کد وجود ندارد (batchSmsId نامعتبر است) 1 - : خطا در ارتباط با سرویس دهنده 0 : ارسال شده به مخابرات 1 : رسیده به گوشی 2 : نرسیده به گوشی 3 : خطای مخابراتی 4 : خطای نامشخص 5 : رسیده به مخابرات 6 : نرسیده به مخابرات 7 : مسدود شده توسط مقصد 8 : نامشخص 9 : مخابرات پیام را مردود اعلام کرد 1 : کنسل شده توسط اپراتور 11 : ارسال نشده

مستندات وب سرویس

SendSMS

SendBatchSms

GetDelivery

از این متد جهت ارسال پیامک به یک تا حداکثر 100 شماره بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
fromNumber	string	شماره فرستنده
toNumbers	[] string	آرایه ای از شماره موبایل های گیرندگان می باشد حداکثر 100 شماره در هر بار فراخوانی
messageContent	string	متن پیامک
isFlash	bool	تعیین میکند آیا پیامک به صورت فلش ارسال گردد یا خیر
ref recId	[] int	هر خانه آرایه یک عدد یکتا به ازای هر گیرنده تولید می کند، این کد یکتا برای دریافت وضعیت تحویل کاربر دارد
ref status	[] byte	هر خانه آرایه عدد 0 یا 1 بوده به ازای هر گیرنده تولید می شود، 1 به معنی ارسال شده و 0 ارسال نشده
مقدار بازگشتی	int	0: ارسال با موفقیت انجام شد 1: نام کاربر یا کلمه عبور نامعتبر می باشد. 2: کاربر مسدود شده است 3:شماره فرستنده نامعتبر است. 4: محدودیت در ارسال روزانه. 5: تعداد گیرندگان حداکثر 100 شماره می باشد. 6: خط فرستنده غیر فعال است. 7: متن پیامک شامل کلمات فیلتر شده است. 8: اعتبار کافی نیست. 9: سامانه در حال بروز رسانی می باشد. 10:وب سرویس غیر فعال است 11: وب سرویس غیرفعال است. 12:تعداد پیام و شماره ها باید یکسان باشد 13:تعداد پیام ها حداکثر 100 عدد باید باشد 14:تعرفه مشخص نشده است 15:تشخیص ارسال تکراری توسط سامانه 16:شماره موبایل گیرنده معتبر نیست 17:خط OTP برای کاربر یافت نشد 18:از این شماره فرستنده فقط ارسال تکی مجاز است

از این متد جهت ارسال پیامک به یک تا حداکثر 100 شماره به کار می رود.

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
fromNumber	string	شماره فرستنده
toNumbers	[] string	آرایه ای از شماره موبایل های گیرندگان می باشد حداکثر 100 شماره در هر بار فراخوانی
messageContent	string	متن پیامک
isFlash	bool	تعیین میکند آیا پیامک به صورت فلش ارسال گردد یا خیر
out batchSmsId	int	شناسه ارسال گروهی
مقدار بازگشتی	int	0: ارسال با موفقیت انجام شد 1: نام کاربر یا کلمه عبور نامعتبر می باشد. 2: کاربر مسدود شده است 3:شماره فرستنده نامعتبر است. 4: محدودیت در ارسال روزانه. 5: تعداد گیرندگان حداکثر 100 شماره می باشد. 6: خط فرستنده غیر فعال است. 7: متن پیامک شامل کلمات فیلتر شده است. 8: اعتبار کافی نیست. 9: سامانه در حال بروز رسانی می باشد. 10:وب سرویس غیر فعال است 11: وب سرویس غیرفعال است. 12:تعداد پیام و شماره ها باید یکسان باشد 13:تعداد پیام ها حداکثر 100 عدد باید باشد 14:تعرفه مشخص نشده است 15:تشخیص ارسال تکراری توسط سامانه 16:شماره موبایل گیرنده معتبر نیست 17:خط OTP برای کاربر یافت نشد 18:از این شماره فرستنده فقط ارسال تکی مجاز است

این متد جهت دریافت وضعیت تحویل پیامک ارسال شده بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
recId	long	شناسه پیامک ارسال شده
مقدار بازگشتی	int	وضعیت تحویل پیامک می باشد ترجمه مقدار وضعیت تحویل: 5 - : برای گرفتن گزارش تحویل حداقل یک دقیقه بعد از ارسال اقدام نمایید 4 - : به علت اینکه پیام در صف ارسال مخابرات می باشد، امکان گرفتن گزارش تحویل وجود ندارد 3 - : به علت اینکه مهلت یک هفته ای گرفتن گزارش پایان یافته است، امکان گرفتن گزارش تحویل وجود ندارد 2 - : پیام با این کد وجود ندارد (batchSmsId نامعتبر است) 1 - : خطا در ارتباط با سرویس دهنده 0 : ارسال شده به مخابرات 1 : رسیده به گوشی 2 : نرسیده به گوشی 3 : خطای مخابراتی 4 : خطای نامشخص 5 : رسیده به مخابرات 6 : نرسیده به مخابرات 7 : مسدود شده توسط مقصد 8 : نامشخص 9 : مخابرات پیام را مردود اعلام کرد 1 : کنسل شده توسط اپراتور 11 : ارسال نشده

این متد برای دریافت میزان اعتبارکاربر بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
مقدار بازگشتی	decimal	میزان اعتبار کاربر به پیامک می باشد مقدار اعتبار صفر یا عددی برزگتر از صفر می باشد در غیر اینصورت : 1 - نام کاربری و رمز عبور صحیح نمی باشد 2 - کاربر غیرفعال می باشد

این متد جهت دریافت تعداد پیامهای دریافتی بکارمی رود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
isRead	bool	مقدار true برای پیامهای خوانده شده مقدار false برای پیامهای خوانده نشده
مقدار بازگشتی	int	اگر نام کاربری و رمز عبور صحیح باشد مقدار برگشتی یک عدد می باشد که بر اساس پارامتر isRead بیانگر تعداد پیامها دریافتی می باشد 1 - : نام کاربری و رمز عبور صحیح نمی باشد

از این متد جهت ارسال پیامک به یک تا حداکثر 100 شماره به کار می رود.

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
batchSmsId	int	شناسه ارسال با متد SendBatchSms
numbers	[] string	آرایه ای از شماره موبایل های گیرندگان می باشد
index	int	اندیس مربوط به ردیف پیام ارسالی، توجه مقدار اندیس از 1 شروع می شود.
count	int	تعداد رکورد درخواستی، حداکثر 100
deliveryStatus	[] int	آرایه ی از وضعیت تحویل متناظر با آرایه شماره موبایل ها می باشد ترجمه مقدار وضعیت تحویل: 5 - : برای گرفتن گزارش تحویل حداقل یک دقیقه بعد از ارسال اقدام نمایید 4 - : به علت اینکه پیام در صف ارسال مخابرات می باشد، امکان گرفتن گزارش تحویل وجود ندارد 3 - : به علت اینکه مهلت یک هفته ای گرفتن گزارش پایان یافته است، امکان گرفتن گزارش تحویل وجود ندارد 2 - : پیام با این کد وجود ندارد (batchSmsId نامعتبر است) 1 - : خطا در ارتباط با سرویس دهنده 0 : ارسال شده به مخابرات 1 : رسیده به گوشی 2 : نرسیده به گوشی 3 : خطای مخابراتی 4 : خطای نامشخص 5 : رسیده به مخابرات 6 : نرسیده به مخابرات 7 : مسدود شده توسط مقصد 8 : نامشخص 9 : مخابرات پیام را مردود اعلام کرد 1 : کنسل شده توسط اپراتور 11 : ارسال نشده
مقدار بازگشتی	int	1 - : نام کاربری و رمز عبور صحیح نمی باشد 2 - : ارسال با مقدار شناسه batchSmsId وجود ندارد

از این متد جهت دریافت پیامک های دریافتی یا ارسالی استفاده می شود

نام پارامتر	نوع پارامتر	توضیحات
userName	string	نام کاربری مربوط به حساب شما در سامانه
password	string	رمز عبور مربوط به حساب شما در سامانه
messageType	int	مشخص کننده نوع پیامک است، اگر 1 باشد پیامک های دریافتی و اگر 2 باشد پیامک های ارسالی را مشخص می کند
fromNumbers	[] string	آرایه ی از شماره های فرستنده می باشد مانند : 10002188
index	int	اندیس مربوط به ردیف پیام های دریافتی، توجه مقدار اندیس از 1 شروع می شود
count	int	تعداد رکورد درخواستی، حداکثر 1000
مقدار بازگشتی	[] MessageInfo	آرایه ی از نوع MessageInfo
FromDate	string	تاریخ شروع(شمسی) فرمت نمونه:1400/01/01
ToDate	string	تاریخ پایان(شمسی) فرمت نمونه:1400/10/01
تاریخ شروع و پایان اختیاری است،دو نسخه از این متد برای پوشش هر دو حالت تعبیه شده است