API آمارد پیامک تخصصی ترین API پیامکی است که از این 3 طریق میتوانید با آن ارتباط برقرار کنید
RESTful
soap
RPC
ایجاد اطمینان برای مخاطبان در فروشگاه‌های اینترنتی امری بسیار ضروری و رقابتی محسوب میشود. ارسال پیامک در پروسه خرید میتواند تا حد زیادی خلایی که در اثر فاصله بین مشتری و فروشنده در فروش اینترنتی پدید آمده را جبران کند و حس اعتماد را در مشتری نگه دارد. اینگونه پیامک‌ها با امکاناتی مثل “ثبت نام آنلاین” ، “ارسال کد فعالسازی” و “وضعیت گیری سفارش‌ها” از طریق وب سرویس آمارد پیامک ارسال می‌شوند. برای مشاهده لیست کامل متدها در وب سرویس آمارد پیامک به صفحه مستندات مراجعه کنید.
پیامک‌هایی که پس از تراکنش‌های مالی از سمت بانک ارسال می‌شوند یکی از امکانات کاربردی وب سرویس پیامک می‌باشد. با فعالسازی سامانه آمارد پیامک و اتصال از طریق API به سیستم‌های مالی و حسابداری خود به راحتی میتوانید پیامک‌های سیستمی‌ارسال کنید. ارسال پیامک‌هایی مبنی بر صدور فاکتور، سر رسید چک‌ها، یادآوری بدهی‌ها و قراردادها با استفاده از وب سرویس پیامک ممکن میشود. “ارسال دوره ای و زمان دار” ، “ارسال به دفترچه تلفن” و “ارسال به بانک‌ها” از دسترسی‌های وب سرویس آمارد پیامک هستند که برای این کار به شما کمک میکنند. نمونه کدها و مستندات وب سرویس را میتوانید از صفحه مستندات دریافت کنید.
سرعت انتقال هشدار یا بروز یک رخداد امنیتی بسیار اهمیت دارد و تاخیر در اطلاع یافتن از اتفاقات غیر مترقبه، میتواند باعث خسارت شود. با اتصال به وب سرویس آماراد پیامک از آنتی ویروس‌ها و فایروال‌ها و همچنین تمام نرم افزارهای امنیتی در زمان‌های تعیین شده خصوصا بروز مشکلات، پیامک دریافت خواهید کرد. این ویژگی میتواند برای سیستم‌های امنیتی مثل دزدگیر ماشین یا درب فروشگاه نیز کاربردی باشد و وضعیت موجود را پیامک کند. تمام دسترسی‌های لازم وب سرویس پیامک به شما داده میشود و در صفحه مستندات وب سرویس قابل مشاهده است.
پیامک یک ابزار کاربردی در مدیریت ارتباط با مشتریان به شمار میرود و به همین دلیل امکان اتصال وب سرویس پیامک به سیستم‌های CRM از طریق API تخصصی آمارد پیامک فراهم شده است. با اتصال نرم افزار CRM خود به سامانه آمارد پیامک میتوانید به گروه‌های مختلف مشتریان خود پیامک‌هایی در قالب تبریک، خبرنامه، تخفیف و … ارسال کنید. با این کار نیازی به انتقال داده‌های خود به سامانه پیامک ندارید و پیامک‌ها با دسترسی‌هایی که از وب سرویس آمارد پیامک به شما داده میشود مثل “ارسال به دفترچه تلفن” به طور مستقیم و اتوماتیک از سامانه CRM ارسال خواهد شد.
یکی از ابزارهای کارآمد و به روز در بازاریابی دیجیتال، ریتارگتینگ با استفاده از پیامک است. به این صورت که فروشگاه‌های اینترنتی میتوانند با استفاده از lead یا سرنخ‌هایی که از کاربران در وب سایت خود دریافت کرده اند، پیشنهاد‌های ویژه خود را برای آنها پیامک کنند. حتما برای شما هم پیش آمده که از وب سایتی دیدن کرده اید و در آن ثبت نام کرده اید اما خرید انجام نداده اید. با استفاده از وب سرویس پیامک میتوانید به این دسته از مخاطبان خود پیامکی حاوی کد تخفیف از محصول مورد نظر آنها ارسال کنید و آنها را ریتارگت کنید. برای این کار نیاز به دسترسی “دفترچه تلفن” از طریق API آمارد پیامک دارید که آمارد پیامک این دسترسی را علاوه بر دسترسی‌های دیگر از طریق وب سرویس پیامک در اختیار شما می‌گذارد.
کاربرد وب سرویس پیامک در CMS ها
استفاده از CMS های محبوبی مثل جوملا و وردپرس برای مدیریت محتوای انواع سایت ها رایج است، به همین دلیل سامانه پیامک آمارد پیامک این امکان را قرار داده که بتوانید CMS خود را به وب سرویس پیامک آمارد پیامک متصل نمایید و سایت خود را مجهز به ارسال و دریافت پیامک کنید. این امکان در قسمت های متفاوتی مثل خبرنامه پیامکی، ارسال تخفیف ها، مسابقات و نظرسنجی، باشگاه مشتریان و … کارایی داشته و باعث حفظ ارتباط شما با مشتریانتان میشود. جهت استفاده از وب سرویس آماراد پیامک و آشنایی با نمونه کدهای آن به این صفحه مراجعه کنید.
اپلیکیشن ها
دستگاه های حضور و غیاب
با مجهز شدن سیستم های حضور و غیاب به وب سرویس پیامک، کارمندان و مدیران می توانند از ساعت ورود و خروج و همچنین میزان تاخیر به صورت پیامک آگاهی کسب کنند. این اطلاع رسانی میتواند به این صورت تنظیم شود که اگر در ماه بیشتر از ساعت تعیین شده تاخیر وجود داشته باشه پیامک اطلاع رسانی آن برای مدیر مجموعه ارسال شود. همچنین در مدارس در صورت تاخیر یا غیبت دانش آموزان برای والدین آنها پیامک ارسال شود. برای این کار متدهایی در آمارد پیامک در نظر گرفته شده است که برنامه نویسان شما میتوانند با دانش خود به آن دست پیدا کنند.
استفاده از وب سرویس پیامک میتوانید وب سایت یا اپلیکیشن خود را به سامانه پیامک متصل کنید و پیامک ها را مستقیما از طریق وبسایت خود مدیریت کنید. مستندات و نمونه کدهای برنامه نویسی در این صفحه به شما کمک میکنند که وب سرویس ارسال سریع پیامک را پیاده سازی کنید. در صورتی که از سایت ساز ها برای طراحی سایت خود استفاده کرده باشید، افزونه ها و ماژول های پیامکی سازگار با انواع سیستم مدیریت محتوا، برای شما مهیا شده است.
Send
برای ارسال پیامک
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
شماره ارسال کننده | Char | From |
متن پیام | Char | Message |
شماره دریافت کننده | Char | TO |
Credit
برای دریافت اعتبار به کار می رود
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Credit | Char | Op |
Delivery
برای گزارش از وضعیت ارسال به کار میرود.
delivery : نمونه خروجی برای گرفتن دلیوری پیام های ارسالی
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Delivery | Char | Op |
کد بالک | Int | Uniqid |
[“+98910000098:notsync”,”+989210000616:notsync
“,”+989212000943:notsync”,”+989360000994:notsync”]
در حال ارسال :Notsync
ارسال شده :Send
رسیده به مخابرات :Pending
نرسیده به گوشی : Failed
بلک لیست :Discarded
رسیده به گوشی : Delivered
The username or password is incorrect : خطاها
اشتباه بودن نام کاربری یا رمز عبور
بدین معنی است که کد بالک ارسالی اشتباه است :Null
Booksend
برای ارسال از دفترچه استفاده می شود
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Checkmessage | Char | Op |
کد بالک | Int | Messageid |
statusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
statusMessag
پایان یافته:Finish
عدم برقراری با اپراتور: NoContactWithTheOperator
در حال ارتباط :Interacting
عدم احراز هویت :NoAuthentication
فعال :Active
عدم ارسال پیامک :NoSendSMS
انصراف :Cancel
validMessage
تایید شده: Approve
رد شده: Cancel
منتظر تایید: Notconfirm
Booklist
برای گزارش از وضعیت ارسال به کار می رود.
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Booklist | Char | Op |
StatusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Booksend
برای ارسال از دفترچه استفاده می شود
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
شماره ارسال کننده | Char | From |
متن پیام | Char | Message |
Json از لیست دفترچه ها | Char | bookid |
Booksend | Char | Op |
statusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Inboxlist
برای دریافت پیام خوانده به کار می رود
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Inboxlist | Char | Op |
StatusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Accesslist
برای دریافت بسته های در دسترس استفاده می شود
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | char | uname |
پسورد | char | pass |
accesslist | char | Op |
statusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Newuser
برای ساخت کاربر جدید مورد استفاده قرار میگیرد
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
نام کاربری کاربر | Char | User-name |
پسورد کاربر | Char | User-pass |
نام | Char | name |
نام شرکت | Char | company |
کد ملی | Char | national-id |
شماره شناسنامه | Char | certificate-id |
Id سطح دسترسی | Char | access-id |
تلفن | Char | Tell |
موبایل | Char | mobile |
کدپستی | Char | postalcode |
ایمیل | Char | email |
آدرس | Char | address |
newuser | Char | Op |
statusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
postalcodecount
برای گرفتن تعداد شماره ها در یک کدپستی می باشد
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
postalcodecount | Char | Op |
tci برای همراه اول /
mtn برای ایرانسل | Char | type |
0 -برای مرد و زن .
1 – برای مرد.
2 -برای زن | itn | gender |
کد پستی | char | postalcode |
Postalcodearea
برای گرفتن محله های تهران استفاده می شود.
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Postalcoderarea | Char | Op |
statusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Postalcodesen
برای گرفتن تعداد شماره ها در یک کدپستی می باشد.
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
شماره ارسال کننده | Char | From |
متن پیام جهت ارسال | Char | Massage |
Tci برای همراه اول /
Mtn برای ایرانسل | Char | type |
0 -برای مرد وزن.
1 -برای مرد.
2 -برای زن | Int | Gender |
کدپستی | Char | Postalcode |
Postalcodesend | Char | Op |
statusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Jobslist
برای گرفتن لیست شغل هاست.
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Jobslist | Char | Op |
statusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Jobstrenlist
برای گرفتن لیست گرایش ها به کار می رود.
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
Checkmessage | Char | Op |
کد بالک | Int | Messageid |
StatusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Jobscount
برای گرفتن تعداد شماره مشاغل استفاده می گردد.
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | char | Uname |
پسورد | char | Pass |
Json لیست از گرایش ها | char | Trendid |
jobscount | Int | Op |
StatusMess
پایان یافته :Finish
عدم برقراری با اپراتور :NoContactWithTheOperator
:Interacting
Jobssend
برای ارسال مشاغل به کار میرود.
پارامترهای ورودی | ||
|---|---|---|
نام کاربری | Char | Uname |
پسورد | Char | Pass |
شماره ارسال کننده | Char | From |
پیام | Int | Message |
Json لیست از گرایش ها | Char | Trendid |
Jobssend | Char | Op |
Id شغل | Int | Jobsid |
StatusMess
پایان یافته :Finish
عدم برقراری با اپراتور : NoContactWithTheOperator
:Interacting
کاربر میبایست یک سرور http آماده کند که قادر به پاسخگویی درخواست از نوع POST با پارامترهای ذکر شده در عکس ضمیمه باشد.
* تمام وضعیت‌های ممکن برای پیام در تصویر ضمیمه وجود دارد (چهار حالت ممکنه).
* سرور کاربر میبایستی در حداکثر زمان ۱۵ ثانیه درخواست سرور ما را پاسخگو باشد، در غیر اینصورت پیام reject میشود.
* محتویات پیام ارسالی از سمت ما در قالب json می باشد، لذا سرور مربوط به کاربر میبایستی یک json-api باشد.
* فرمت تاریخ موجود از استاندارد RFC3339 استفاده نموده و timezone آن UTC می‌باشد.
* فرمت شماره گیرنده و فرستنده، به صورتی که در عکس ضمیمه دیده می شود باید باشد (با کد کشور و کاراکتر +).
* آدرسی که از سمت کاربر ارائه می شود نباید redirect داشته باشد و میبایست نقطه‌ی نهایی api ارائه شود (اگر سرور https باشد، آدرس را با پروتکل https ارائه دهید).
* برای حفظ امنیت سرور کاربر، توصیه میگردد درخواست‌ها به این وب سرویس، به آدرسی که متعاقبا از سمت مدیانا ارائه می شود محدود گردد.
PHP WSDL Sample : php.wsdl.example.v1.1.zip
C# Sample : asp.example.v1.2.zip
Node js pattern sample : node_js_sample.zip
Pdf Document : pdf.doc
Restful Sample : Restful.example.v2.0.zip
نمونه کد VB.net برای ارسال پترن دانلود
نام کاربری = UserName کلمه عبور = Password پیام متن = Message شماره خط = From شماره موبایل کاربر = To url برای استفاده در نرم افزار حسابداری هلو :http://ippanel.com/service/holo
