Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
RestClient.vb
SampleSoap.vb
mpVB-quickStart.zip

README.md

melipayamak Visual Basic (VB.net)

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

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


نصب

قبل از نصب نیاز به ثبت نام در سایت ملی پیامک دارید.

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

پس از ثبت نام، وب سرویس‌های ملی پیامک را از طریق آدرسهای زیر به عنوان Service Reference به پروژه خود اضافه کنید.

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

api.payamak-panel.com/post/Send.asmx

وب سرویس دریافت پیام

api.payamak-panel.com/post/receive.asmx

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

api.payamak-panel.com/post/contacts.asmx

api.payamak-panel.com/post/Actions.asmx

وب سرویس ارسال زماندار

api.payamak-panel.com/post/Schedule.asmx

وب سرویس پشتیبانی کاربران

api.payamak-panel.com/post/Tickets.asmx

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

api.payamak-panel.com/post/Users.asmx

وب سرویس ارسال صوتی

api.payamak-panel.com/post/Voice.asmx

نحوه استفاده

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

Const  username As String = "username"
Const  password As String = "password"
Const  from As String = "5000..."
Const  toNum As String = "09123456789"
Const  text As String = "تست وب سرویس ملی پیامک"
Const  isFlash As Boolean = False
Dim soapClient As New SendSoapClient()
soapClient.SendSimpleSMS2(username, password, toNum, from, text, isFlash)
'یا برای ارسال به مجموعه ای از مخاطبین
soapClient.SendSimpleSMS(username, password, New String() {toNum}, from, text, isFlash)

از آنجا که وب سرویس ملی پیامک تنها محدود به ارسال پیامک نیست شما از طریق زیر میتوانید به وب سرویس ها دسترسی کامل داشته باشید:

' وب سرویس پیامک
Dim restClient As New RestClient(username, password)
Dim soapClient As New SendSoapClient()
' وب سرویس تیکت پشتیبانی
Dim ticketSoapClient As New TicketsSoapClient()
' وب سرویس برای مدیریت کامل  ارسال انبوه پیامک
Dim actionSoapClient As New ActionsSoapClient()
'وب سرویس کاربران
Dim usersSoapClient As New UsersSoapClient()
'وب سرویس دفترچه تلفن
Dim contactSoapClient As New ContactsSoapClient()
'وب سرویس زمان بندی
Dim scheduleSoapClient As New ScheduleSoapClient()
'وب سرویس پیام صوتی
Dim voiceSoapClient As New VoiceSoapClient()
'وب سرویس دریافت
Dim receiveSoapClient As New ReceiveSoapClient()

تفاوت های وب سرویس پیامک rest و soap

از آنجا که ملی پیامک وب سرویس کاملی رو در اختیار توسعه دهندگان میگزارد برای راحتی کار با وب سرویس پیامک علاوه بر وب سرویس اصلی soap وب سرویس rest رو هم در اختیار توسعه دهندگان گزاشته شده تا راحتتر بتوانند با وب سرویس کار کنند. تفاوت اصلی این دو در تعداد متد هاییست که میتوانید با آن کار کنید. برای کار های پایه میتوان از وب سرویس rest استفاده کرد برای دسترسی بیشتر و استفاده پیشرفته تر نیز باید از وب سرویس باید از وب سرویس soap استفاده کرد. جهت مطالعه بیشتر وب سرویس ها به قسمت وب سرویس پنل خود مراجعه کنید.


اطلاعات بیشتر

برای مطالعه بیشتر و دریافت راهنمای وب سرویس ها و آشنایی با پارامتر های ورودی و خروجی وب سرویس به صفحه معرفی وب سرویس ملی پیامک مراجعه نمایید .


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

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

ارسال

restClient.Send(toNum, from, text, isFlash)
soapClient.SendSimpleSMS(username, password, New String() {toNum}, from, text, isFlash)
در آرگومان سوم روش soap میتوانید از هر تعداد مخاطب به عنوان آرایه استفاده کنید

ارسال از خط خدماتی اشتراکی

restClient.SendByBaseNumber(text, to, bodyId)
soapClient.SendByBaseNumber2(username, password, text, to, bodyId)

دریافت وضعیت ارسال

restClient.GetDelivery(recId)
soapClient.GetDelivery(recId)
soapClient.GetDeliveries(New Int() {recIds}, username, password)

لیست پیامک ها

restClient.GetMessages(location, index, count, from)
soapClient.getMessages(username, password, location, from, index, count)
'جهت دریافت به صورت رشته ای
receiveSoapClient.GetMessagesByDate(username, password, location, from, index, count, dateFrom, dateTo)
'جهت دریافت بر اساس تاریخ
receiveSoapClient.GetUsersMessagesByDate(username, password, location, from, index, count, dateFrom, dateTo)
'جهت دریافت پیام های کاربران بر اساس تاریخ 

موجودی

restClient.GetCredit()
soapClient.GetCredit(username, password)

تعرفه پایه / دریافت قیمت قبل از ارسال

restClient.GetBasePrice()
soapClient.GetSmsPrice(username, password, irancellCount, mtnCount, from, text)

لیست شماره اختصاصی

usersSoapClient.GetUserNumbers(username, password)

بررسی تعداد پیامک های دریافتی

soapClient.GetInboxCount(username, password, isRead)
'پیش فرض خوانده نشده 

ارسال پیامک پیشرفته

soapClient.SendSms(username, password, toNums[], from, text, isflash, udh, recId[], status[])

مشاهده مشخصات پیام

receiveSoapClient.GetMessagesReceptions(username, password, msgId, fromRows)

حذف پیام دریافتی

receiveSoapClient.RemoveMessages2(username, password, location, msgIds)

ارسال زماندار

scheduleSoapClient.AddSchedule(username, password, toNum, from, text, isflash, scheduleDateTime, period)

ارسال زماندار متناظر

scheduleSoapClient.AddMultipleSchedule(username, password, toNums[], from, text[], isflash, scheduleDateTime[], period)

ارسال سررسید

scheduleSoapClient.AddUsance(username, password, toNum, from, text, isflash, scheduleStartDateTime, repeatAfterDays, scheduleEndDateTime)

مشاهده وضعیت ارسال زماندار

scheduleSoapClient.GetScheduleStatus(username, password, schId)

حذف پیامک زماندار

scheduleSoapClient.RemoveSchedule(username, password, schId)

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

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

voiceSoapClient.SendSMSWithSpeechText(username, password, smsBody, speechBody, from, toNum)

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

voiceSoapClient.SendSMSWithSpeechTextBySchduleDate(username, password, smsBody, speechBody, from, toNum, scheduleDate)

دریافت وضعیت پیامک همراه با تماس صوتی

voiceSoapClient.GetSendSMSWithSpeechTextStatus(username, password, recId)

تماس انبوه زماندار

voiceSoapClient.SendBulkSpeechText(title, receivers, DateToSend, repeatCount)

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

voiceSoapClient.SendBulkVoiceSMS(title, voiceFileId, receivers, DateToSend, repeatCount)

آپلود فایل صوتی

voiceSoapClient.UploadVoiceFile(title, base64StringFile)

وب سرویس ارسال انبوه/منطقه ای

دریافت شناسه شاخه های بانک شماره

actionSoapClient.GetBranchs(username, password, owner)

اضافه کردن یک بانک شماره جدید

actionSoapClient.AddBranch(username, password, branchName, owner)

اضافه کردن شماره به بانک

actionSoapClient.AddNumber(username, password, branchId, mobileNumbers[])

حذف یک بانک

actionSoapClient.RemoveBranch(username, password, branchId)

ارسال انبوه از طریق بانک

actionSoapClient.AddBulk(username, password, from, branch, bulkType, title, message, rangeFrom, rangeTo, DateToSend, requestCount, rowFrom)

تعداد شماره های موجود

actionSoapClient.GetBulkCount(username, password, branch, rangeFrom, rangeTo)

گزارش گیری از ارسال انبوه

actionSoapClient.GetBulkReceptions(username, password, bulkId, fromRows)

تعیین وضعیت ارسال

actionSoapClient.GetBulkStatus(username, password, bulkId, sent, failed, status)

تعداد ارسال های امروز

actionSoapClient.GetTodaySent(username, password)

تعداد ارسال های کل

actionSoapClient.GetTotalSent(username, password)

حذف ارسال منطقه ای

actionSoapClient.RemoveBulk(username, password, bulkId)

ارسال متناظر

actionSoapClient.SendMultipleSMS(username, password, toNums[], from, text[], isflash, udh, recId[], status)

نمایش دهنده وضعیت گزارش گیری

actionSoapClient.UpdateBulkDelivery(username, password, bulkId)

وب سرویس تیکت

ثبت تیکت جدید

ticketSoapClient.AddTicket(username, password, title, content, aletWithSms)

جستجو و دریافت تیکت ها

ticketSoapClient.GetReceivedTickets(username, password, ticketOwner, ticketType, keyword)

دریافت تعداد تیکت های کاربران

ticketSoapClient.GetReceivedTicketsCount(username, password, ticketType)

دریافت تیکت های ارسال شده

ticketSoapClient.GetSentTickets(username, password, ticketOwner, ticketType, keyword)

دریافت تعداد تیکت های ارسال شده

ticketSoapClient.GetSentTicketsCount(username, password, ticketType)

پاسخگویی به تیکت

ticketSoapClient.ResponseTicket(username, password, ticketId, type, content, alertWithSms)

وب سرویس دفترچه تلفن

اضافه کردن گروه جدید

contactsSoapClient.AddGroup(username, password, groupName, Descriptions, showToChilds)

اضافه کردن کاربر جدید

contactsSoapClient.AddContact(username, password, options)

بررسی موجود بودن شماره در دفترچه تلفن

contactsSoapClient.CheckMobileExistInContact(username, password, mobileNumber)

دریافت اطلاعات دفترچه تلفن

contactsSoapClient.GetContacts(username, password, groupId, keyword, count)

دریافت گروه ها

contactsSoapClient.GetGroups(username, password)

ویرایش مخاطب

contactsSoapClient.ChangeContact(username, password, options)

حذف مخاطب

contactsSoapClient.RemoveContact(username, password, mobilenumber)

دریافت اطلاعات مناسبت های فرد

contactsSoapClient.GetContactEvents(username, password, contactId)

وب سرویس کاربران

ثبت فیش واریزی

usersSoapClient.AddPayment(username, password, options)

اضافه کردن کاربر جدید در سامانه

usersSoapClient.AddUser(username, password, options)

اضافه کردن کاربر جدید در سامانه(کامل)

usersSoapClient.AddUserComplete(username, password, options)

اضافه کردن کاربر جدید در سامانه(WithLocation)

usersSoapClient.AddUserWithLocation(username, password, options)

بدست آوردن ID کاربر

usersSoapClient.AuthenticateUser(username, password)

تغییر اعتبار

usersSoapClient.ChangeUserCredit(username, password, amount, description, targetUsername, GetTax)

فراموشی رمز عبور

usersSoapClient.ForgotPassword(username, password, mobileNumber, emailAddress, targetUsername)

دریافت تعرفه پایه کاربر

usersSoapClient.GetUserBasePrice(username, password, targetUsername)

دریافت اعتبار کاربر

usersSoapClient.GetUserCredit(username, password, targetUsername)

دریافت مشخصات کاربر

usersSoapClient.GetUserDetails(username, password, targetUsername)

دریافت شماره های کاربر

usersSoapClient.GetUserNumbers(username, password)

دریافت تراکنش های کاربر

usersSoapClient.GetUserTransactions(username, password, targetUsername, creditType, dateFrom, dateTo, keyword)

دریافت اطلاعات کاربران

usersSoapClient.GetUsers(username, password)

دریافت اطلاعات فیلترینگ

usersSoapClient.HasFilter(username, password, text)

حذف کاربر

usersSoapClient.RemoveUser(username, password, targetUsername)

مشاهده استان ها

usersSoapClient.GetProvinces(username, password)

مشاهده کد شهرستان

usersSoapClient.GetCities(username, password, provinceId)

مشاهده تاریخ انقضای کاربر

usersSoapClient.GetExpireDate(username, password)
You can’t perform that action at this time.