$options = array(
'login' => 'yourusername',
'password' => 'yourpassword'
);
$client = new SoapClient('http://sms.dadenama.ir/webservice/?WSDL', $options);
try
{
$messageId = $client->send('09121111111', 'تست پیام کوتاه!');
sleep(3);
print ($client->deliveryStatus($messageId));
var_dump($client->accountInfo());
}
catch (SoapFault $sf)
{
print $sf->faultcode."\n";
print $sf->faultstring."\n";
}ورود به کنترل پنل |جستجوی دامنه | ورود به پنل SMS | شماره حساب ها | پشتیبانی | گفتگوی آنلاین | با ما تماس بگیرید : 32681691-031
تمامي كالاها و خدمات اين فروشگاه، حسب مورد داراي مجوزهاي لازم از مراجع مربوطه مي‌باشند و فعاليت‌هاي اين سايت تابع قوانين و مقررات جمهوري اسلامي ايران است.
API وب سرویس پیام کوتاه
مقدمه
این مستند بعنوان راهنمای استفاده از سرویس وب پیام کوتاه داده نما می باشد و مخاطب آن برنامه نویسانی هستند که آشنا به مفاهیم تکنولوژی SOAP بوده و نحوه ایجاد یک SOAP Client را با زبانی که مسلط به آن هستند بدانند. البته مثالهای کاربردی با زبان PHP در انتهای مستند ارائه شده است. داده نما خود را موظف به ارائه صحیح سرویس وب می داند و هیچ تعهدی برای نصب، پیکربندی و راه اندازی SOAP Client بر روی سرویس دهنده های دیگر ندارد و در صورت نیاز مشتری طبق قرارداد جداگانه قابل انجام است.
نحوه عضویت
جهت استفاده از این سرویس وب ابتدا باید درخواست خود را از طریق صفحه مربوطه در وب سایت داده نما تنظیم و ارسال کنید. بر اساس درخواست شما یک یا چند شماره به حساب شما تخصیص داده می شود که از میان آنها یکی بصورت شماره پیش فرض (Default) انتخاب می شود. با استفاده از شناسه کاربری و رمز عبوری که در فرم ثبت نام وارد می کنید، پس از شارژ اعتبار و فعالسازی حساب شما توسط مدیر سیستم، اجازه استفاده از سرویس وب را خواهید داشت که در ادامه به معرفی متدهای سرویس وب، پارامترهای ورودی و خروجی آنها، کدهای خطا و کدهای وضعیت پیام کوتاه می پردازیم.
تعاریف
کد پیگیری پیام کوتاه
برای هر پیام کوتاه که ارسال می کنید، یک کد پیگیری منحصر به فرد باز گردانده می شود که بوسیله آن می توانید از وضعیت تحویل (Delivery) پیام کوتاه اطلاع کسب کنید. در سرویس وب پیام کوتاه داده نما، این کد عددی بالای 1000 است.
کد پیغام خطا
در صورت بروز خطا مثلا عدم دسترسی به بانک اطلاعاتی، سوئیچ مخابرات و یا بروز خطا در اعتبارسنجی پارامترهای ارسال شده در فراخوانی عملیاتهای سرویس وب، یک آبجکت SoapFault بازگردانده می شود که دو خصیصه (Property) آن به نام faultcode و faultstring آن دارای مقدار است که به ترتیب کد خطا (برای نمایش خطاهای سفارشی شده توسط برنامه نویس) و دیگری توضیح قابل فهم خطا می باشد که در جدول یک شرح آنها آمده است. در حال حاضر کد خطا عددی بین 1 تا 20 است.
کد وضعیت تحویل پیام کوتاه
این کد وضعیت تحویل (Delivery) پیام کوتاه را در لحظه درخواست مشخص می کند که شرح آنها در جدول دو آمده است.
آدرس انتقال ترافیک (Traffic Relay)
وقتی پیام کوتاهی به هر یک از شماره های تخصیص یافته شما ارسال می شود، پس از تایید صحت شماره، اطلاعات پیام کوتاه که شامل شماره فرستنده، متن پیام، شماره شما و کد امنیتی می باشد به آدرس اینترنتی (URL) که مشخص کرده اید بصورت POST ارسال می شود. جهت اطمینان از اینکه درخواست از طرف سرویس دهنده داده نما ارسال شده می توانید از کد امنیتی همراه پیام استفاده کنید. بدین صورت که با فراخوانی عملیات verifyReceive از سرویس وب و ارسال کد امنیتی یک پاسخ از نوع منطقی (Boolean) دریافت می کنید که True به معنای صحت پیام و False به معنای عدم صحت پیام است. البته موارد دیگری نیز جهت اطمینان از صحت پیام وجود دارد که با بررسی بیشتر نوع درخواست ارسالی توسط سرویس دهنده داده نما قابل پیاده سازی توسط برنامه نویس می باشد.
آدرس سرویس وب
با مراجعه به آدرس http://www.dadenama.ir/webservice شرح مختصری در مورد عملیات پشتیبانی شده توسط سرویس وب پیام کوتاه داده نما و نوع پارامترهای ورودی و خروجی آنها مشاهده می کنید.
آدرس WSDL سرویس وب پیام کوتاه داده نما: http://sms.dadenama.ir/webservice/?WSDL
جهت ASP .NET :
آدرس WSDL سرویس وب پیام کوتاه داده نما: http://sms.dadenama.ir/webservice/v1/?WSDL
عملیاتها و پارامترها
متد send
جهت ارسال یک پیام کوتاه از این متد استفاده می شود. در جدول زیر پارامترهای ورودی این متد آورده شده است. مقدار بازگشتی این متد "کد پیگیری پیام کوتاه" می باشد که از نوع عدد صحیح و بزرگتر مساوی 1000 است. در صورت بروز هر گونه خطایی یک Fault بازگشت داده می شود که در بخش تعاریف به توضیح آن پرداختیم.
ورودی
| نام پارامتر | نوع پارامتر | اجباری/اختیاری | توضیح |
|---|---|---|---|
| to | String | اجباری | شماره گیرنده پیام کوتاه (مثال 09121111111) |
| msg | String | اجباری | متن پیام کوتاه (رشته کاراکتری با طول حداکثر 160 کاراکتر برای حروف لاتین و حداکثر 70 کاراکتر برای حروف فارسی) |
| from | String | اختیاری | شماره فرستنده پیام کوتاه (در صورت خالی گذاشتن این پارامتر پیام کوتاه از شماره پیش فرض حساب ارسال می شود) |
| time | Int | اختیاری | زمان بر حسب Unix Timestamp به وقت UTC (در صورتی که بخواهید پیام کوتاه در آینده ارسال شود) |
خروجی
| نوع پارامتر | توضیح |
|---|---|
| Int | کد پیگیری وضعیت تحویل پیام کوتاه |
متد deliveryStatus
جهت بررسی وضعیت تحویل یک پیام کوتاه از این متد استفاده می شود. تنها ورودی آن "کد پیگیری پیام کوتاه" است. مقدار بازگشتی این متد "کد وضعیت تحویل پیام کوتاه" می باشد که از نوع عدد صحیح بوده و شرح هر یک در جدول 2 آمده است.
ورودی
| نام پارامتر | نوع پارامتر | اجباری/اختیاری | توضیح |
|---|---|---|---|
| messageIdentifier | Int | اجباری | کد پیگیری پیام کوتاه |
خروجی
| نوع پارامتر | توضیح |
|---|---|
| Int | کد وضعیت تحویل پیام کوتاه |
متد verifyReceive
جهت بررسی صحت پیام کوتاه دریافتی از سرویس دهنده داده نما از این متد استفاده می شود. تنها ورودی آن "کد امنیتی پیام کوتاه" است که همراه با سایر اطلاعات پیام کوتاه به آدرس اینترنتی انتقال ترافیک شما ارسال می شود. مقدار بازگشتی این متد نوع Boolean می باشد که True به معنای صحت پیام دریافتی و False به معنای عدم صحت پیام دریافتی است.
ورودی
| نام پارامتر | نوع پارامتر | اجباری/اختیاری | توضیح |
|---|---|---|---|
| securityCode | String | اجباری | کد امنیتی پیام کوتاه |
خروجی
| نوع پارامتر | توضیح |
|---|---|
| Boolean | مقدار True صحت پیام دریافتی و مقدار False عدم صحت پیام دریافتی است |
متد accountInfo
برای دریافت اطلاعات حساب در داده نما از این متد استفاده می شود. این متد هیچ ورودی ندارد. خروجی آن یک آبجکت است که شرح خصیصه های (Property) آن در جدول زیر آمده است.
-
خروجی
نام خصیصه نوع خصیصه توضیح numbers Array of String آرایه ای از رشته کاراکترها که شماره های اختصاص یافته به حساب است receiveUrl String آدرس انتقال ترافیک جهت ارسال پیام کوتاه های ارسالی به شماره (های) اختصاص یافته sent Int تعداد کل پیام کوتاه های ارسالی received Int تعداد کل پیام کوتاه های دریافتی total Int تعداد اعتبار پیام کوتاه اختصاص یافته remaining Int تعداد اعتبار باقیمانده
متد changePassword
برای تغییر رمز عبور حساب از این متد استفاده می شود. ورودی آن رمز عبور جدید است و در صورت انجام صحیح عملیات هیچ خروجی تولید نمی شود. در صورت بروز هر گونه خطایی یک Fault بازگشت داده می شود و عملیات انجام نمی پذیرد.
ورودی
| نام پارامتر | نوع پارامتر | اجباری/اختیاری | توضیح |
|---|---|---|---|
| newPassword | String | اجباری | رمزعبور جدید |
متد changeTrafficRelay
برای تغییر آدرس اینترنتی انتقال ترافیک از این متد استفاده می شود. ورودی آن URL جدید است که باید بصورت کامل وارد شود نظیر (http://example.com/smsreceiver.php) و در صورت انجام صحیح عملیات هیچ خروجی تولید نمی شود. در صورت بروز هر گونه خطایی یک Fault بازگشت داده می شود و عملیات انجام نمی پذیرد.
-
ورودی
نام پارامتر نوع پارامتر اجباری/اختیاری توضیح newURL String اجباری آدرس انتقال ترافیک جدید
جدول 1 - شرح کدهای خطا
| کد خطا | توضیح خطا |
|---|---|
| 1 | نام کاربری یا رمز عبور صحیح نیست |
| 2 | اعتبار حساب کافی نیست |
| 3 | حساب کاربر فعال نیست |
| 4 | شماره گیرنده خالی است |
| 5 | شماره گیرنده معتبر نیست |
| 6 | شماره فرستنده معتبر نیست |
| 7 | هیچ شماره ای به حساب شما اختصاص نیافته است |
| 8 | متن پیام خالی است |
| 9 | متن پیام طولانی است |
| 10 | خطا در سرویس دهنده |
| 11 | خطا در برقراری ارتباط با سوئیچ مخابرات |
| 12 | شناسه پیام نامعتبر است |
| 13 | آدرس انتقال ترافیک معتبر نیست |
| 14 | رمز عبور خالی است |
| 15 | شما حق دسترسی به این ماژول را ندارید |
| 16 | این ماژول در حال حاضر قابل استفاده نیست |
| 17 | این ماژول برای شما غیرفعال شده است |
| 18 | مهلت استفاده از این ماژول خاتمه یافته است |
| 19 | مهلت استفاده از این شماره خاتمه یافته است |
| 20 | این شماره برای شما غیرفعال شده است |
جدول 2 - شرح کدهای وضعیت تحویل پیام کوتاه
| کد | توضیح |
|---|---|
| 0 | ارسال شده به مخابرات |
| 1 | رسیده به گوشی |
| 2 | نرسیده به گوشی |
| 4 | در صف ارسال |
| 8 | رسیده به مخابرات |
| 16 | نرسیده به مخابرات |
جهت استفاده با ASP :
ابتدا باید وب سرویس را از بخش References , Add Service References به برنامه خود اضافه کنید. بعد از آن با دستور using کلاس های وب سرویس را وارد برنامه خود کرده و بعد از می توانید از کد های وب سرویس استفاده کنید.
private void button1_Click(object sender, EventArgs e) { string user, pass; user = Usertxt.Text; pass = passtxt.Text; form2.user = user; int a = sms.send(user, pass, "09125957537", "test "+'\n'+"test", "10004821625634", 0); } بعد از اضافه کردن وب سرویس به references ها می توانید تمام توابع آن را ببینید . اما ص.رت توابع مانند زیر است: • int send( string , string , string , string , string , int ) Send one SMS. • int[] sendToMany( string , string , string[] , string , string , int ) Send one SMS to many. • int[] sendToAl
آدرس وب سرویس ویندوزی: http://sms.dadenama.ir/webservice/v1/?WSDL
نمونه کدها
در صورتی که از php5 استفاده می کنید به راحتی با فعالسازی افزودنی (Extension) به نام SOAP و استفاده از کلاس SoapClient سرویس وب پیام کوتاه داده نما را مصرف کنید.
نحوه ارسال یک پیام کوتاه، بررسی وضعیت تحویل پیام کوتاه و مشاهده اطلاعات حساب:
سفارش پنل پیامک
{mosforme 1}
ویژگی های پنل
* محیطی ساده و کاربرپسند و کاملا فارسی
* امکان ارسال و دریافت پیامک به صورت نا محدود و گزارش گیری دقیق
* قابلیت استفاده از چندین شماره به صورت همزمان در یک پنل
* امکان ذخیره سازی پیامک های ارسالی و دریافتی بدون محدودیت
* حذف اتوماتیک شماره های تکراری هنگام وارد کردن شماره درقسمت مخاطبین یا بارگزاری فایل
* امکان بارگزاری فایل اکسل و متنی (txt) برای مخاطبین
* گزارش ارسال (Delivery) دقیق برای تک تک پیام های ارسالی همراه با زمان دقیق ارسال
* امکان دریافت خروجي اکسل و یا متنی و یا پرینت پيامک هاي ارسال شده و دريافتي
* عدم محدودیت در حداقل شارژ اعتبار
* امکان پرداخت آنلاین و شارژ اتوماتیک سامانه توسط کارت های عضو شتاب
* قابلیت اتصال به سایر نرم افزارها ( توسط API ارسال و دریافت پیام کوتاه)
* امکان ارسال پیام با نام تجاری به جای شماره
* پشتیبانی واقعی 24 ساعته با سه روش ارتباطی: چت اختصاصی، تیکت و تلفن
* نظر سنجی و مسابقه
* پاسخگویی خودکار
* امکان ارسال پیامک منطقه ای از طریق کدپستی
* امکان ارسال انبوه و کشوری به تفکیک استان و شهرستان
سرویس ارسال پیام کوتاه
پنل ارسال پیام کوتاه یک نرم افزار اینترنتی جهت ارسال، دریافت و مدیریت پیام کوتاه از طریق سرورهای اپراتور مخابرات و تحت قوانین شرکت ارتباطات سیار می باشد ،كه كاربران اين سامانه بدون نياز به هيچگونه سخت افزار ( اعم از gsm modem) و تجهيزات جانبي و تنها با اتصال به شبكه اينترنت می توانند از تمامي امكانات سامانه جهت اطلاع رساني و سایر قابلیتهای ارائه شده بهرمند گردند. شما می توانید توسط این نرم افزار با سرعت بسیار بالا ( بیش از چند هزار پیامک در دقیقه ) پیام های کاری، اطلاع رسانی و تبلیغاتی خود را به دست مخاطبین مورد نظرتان برسانید.
پنل ارسال و دریافت پیامک دارای چه قسمتهایی است؟
این پنل دارای قسمتها و امکانات مختلف مانند : صندوق ارسال - صندوق دریافت - دسته بندی پیامها - نظر سنجی - دفترچه تلفن و... می باشد که از آنها برای ساماندهی پیامک ها استفاده میشود .
هزینه استفاده از این پنل به چه میزان است ؟
هزینه استفاده از پنل پیامک مبلغ 350،000 ریال به صورت سالیانه می باشد ، که شامل تمامی امکانات موجود در پنل به همراه یک خط اختصاصی 14 رقمی می شود .
هزینه ارسال و دریافت هر پیامک چگونه تعیین می شود ؟
هزینه هر پیامک بر اساس میزان شارژ پنل در یکی از تعرفه های موجود در جدول تعرفه شارژ پیامک قرار میگیرد. مثلا اگر شخصی پلن 1 جدول را انتخاب کند باید از مبلغ 1,000 تومان تا 200,000 ریال پنل خود را شارژ کند که در این صورت مبلغ هر پیامک فارسی 110 ريال محاسبه می شود.(6% مالیات بر ارزش افزوده ندارد.)
 |
 |
آشنایی با امکانات پنل
ارسال سريع:
ابزار ارسال سريع براي فرستادن آني پيامک به يک يا چند مخاطب به کار مي رود. در اين ابزار کاربر مي تواند مخاطبين پيام خود را از ميان گروه هاي درج شده در دفترچه تلفن انتخاب نمايد، شماره ها را از محيط ديگري کپي کند يا از طريق فايل( با فرمت اکسل يا فايل متني) بارگزاري نمايد.
در ارسال سریع امکان انتخاب ارسال پیامک به صورت فلش نیز وجود دارد. در ارسال به صورت فلش، پیامک به محض رسیدن به گوشی مخاطب بطور خودکار روی صفحه گوشی باز می شود و محتوای آن قابل مشاهده است. این نوع ارسال بیشتر برای پیام های اطلاع رسانی با حجم کمتر از یک صفحه کاربرد دارد.
ارسال زماندار:
ابزار ارسال زماندار، کارمند وقت شناس و دقيق کاربران سامانه است و وظيفه دارد پيام ها را در تاريخ و ساعت تعيين شده توسط کاربران ارسال نمايد.
در ارسال زماندار نیازی به روشن بودن رایانه و ورود کاربر به سامانه نیست و پیام ها در زمان مقرر شده به طور خودکار ارسال می شوند.
ارسال هدفمند و کشوری:
ابزار ارسال هدفمند برای ارسال پیامک به مشترکین همراه اول است. در این نوع شماره های فعال بر اساس شهر و نوع شماره (دائمی یا اعتباری) تفکیک شده اند و کاربر می تواند بر اساس این جزئیات اقدام به ارسال پیامک انبوه نماید. تفاوت این ابزار با ارسال انبوه در این است که شماره های مخاطبان کنترل شده و شماره های فعال هر شهر با تقریب بالایی صحت دارد.
ارسال رنجی:
ابزار ارسال رنجی براي ارسال پيامک به شماره هايي از يک پيش شماره خاص مثلاً 912 يا 913132 استفاده مي شود. اين ابزار مي تواند شماره ها را به تعداد دلخواه کاربر و به صورت تصادفي يا ترتيبي توليد نموده و پيامک را به آن ها ارسال کند. هر چند برای ارسال انبوه بهتر است از ابزار ارسال هدفمند استفاده شود اما گاهی اوقات برای مخاطب قراردادن یک رنج خاص بدون توجه به محل حضور مخاطبان، ارسال رنجی ابزار مناسبی است.
دريافت:
ابزار دریافت، پیام های ارسال شده به شماره مجازی سامانه را نمایش می دهد. دریافت پیامک به شماره اختصاصی نیاز دارد بنابراین شماره هایی که بین کاربران مختلف به اشتراک گذاشته می شوند فقط قابلیت ارسال دارند و از دریافت پیام کوتاه محروم خواهند بود.
دفترچه تلفن:
در دفترچه تلفن داده نما امکان دسته بندی مخاطبان در قالب گروه های مختلف فراهم است. تعداد گروه ها و مخاطبان قابل درج در هر گروه نا محدود است و هر مخاطب می تواند به طور همزمان در چند گروه عضو باشد.
همچنین برای ذخیره سازی گروهی اطلاعات مخاطبان، امکان وارد کردن اطلاعات آن ها از طریق فایل اکسل وجود دارد و اطلاعات موجود در دفترچه تلفن نیز در هر زمان قابل استخراج در قالب فایل اکسل و چاپ است.
پاسخگویی خودکار:
ابزار منشی برای پاسخگویی خودکار به پیام های دریافت شده در سامانه است. چنانچه کاربر از چندین شماره مجازی به طور همزمان استفاده کند منشی پیامکی می تواند به ازای هر یک از شماره های مجازی، تنظیمات متفاوتی در متن و زمان فعال بودن منشی داشته باشد.
انتقال دلیوری:
ابزار انتقال دليوري برای کاربران وب سرویس و http کاربرد دارد. این ابزار آخرين وضعيت پيام هاي ارسال شده را به URL هاي تعريف شده توسط کاربر ارسال ميکند. با اين روش کاربر بدون مراجعه به هاست ایران مي تواند گزارش وضعیت پيامک هاي ارسال شده را در وب سايت یا سرور خود داشته باشد.
نظرسنجي:
امکان تعریف بی نهایت نظرسنجی همزمان بدون محدودیت در تعداد گزینه ها، قابلیت تعریف زمان دقیق شروع و پایان فرآیند جمع آوری آراء، امکان تعریف پاسخ مجزا به ازای هر گزینه تعریف شده، نمایش نموداری نتایج، امکان قرعه کشی چندگانه میان شرکت کنندگان گوشه هایی از ویژگی های این ابزار پیشرفته هستند.
مسابقه:
ابزار برگزاری مسابقه پیامکی در داده نما ویژگی های بارز و ممتاز بسیاری دارد. امکان تعریف بی نهایت مسابقه همزمان بدون محدودیت در تعداد گزینه ها، قابلیت تعریف زمان دقیق شروع و پایان فرآیند پذیرش پاسخ ها، امکان تعریف پاسخ مجزا به ازای هر گزینه تعریف شده، نمایش نموداری نتایج و امکان قرعه کشی میان کسانی که پاسخ صحیح داده اند ویژگی های ممتاز کننده این ابزار هستند.
پاسخگوی هوشمند:
پاسخگوی هوشمند یکی دیگر از ابزارهای اختصاصی داده نما است.این ابزار می تواند بر اساس کلمات و کدها پاسخ های متناسب را ارسال کند و نقطه قوت آن در امکان وارد کردن مقادیر انبوه اطلاعات از طریق فایل اکسل و گزارش گیری وسیع است. یکی از کاربردهای این ابزار امکان ارائه سریال فعال سازی یکبار مصرف برای نرم افزارها و لوح های فشرده یا هر محصول دیگری است که با سریال و ثبت آن ارتباط دارد. همچنین پاسخگوی هوشمند می تواند به عنوان ابزاری برای اعلام قیمت محصولات یا مواردی به کار رود که نیاز به بروزرسانی مداوم و سریع عناوین متعدد دارند.
گزارش آماری :
گزارش آماری یکی از ابزارهای بسیار کاربردی در سامانه مدیریت پیام کوتاه است. کاربر با استفاده از این ابزار میتواند ریز گزارش ارسال ها بر اساس تاریخ و شماره مجازی را مشاهده کرده و گزارش هزینه های انجام شده در هر روز و ماه را مشاهده نماید.
اتصال سایر نرم افزارها به سامانه ( API ارسال و دریافت پیام کوتاه):
در داده نما وب سرویس ارسال و دریافت پیام کوتاه و ارسال پیامک از طریق درخواست های http به طور همزمان ارائه می شوند و به صورت پیش فرض برای تمامی کاربران سرویس ها قابل بهره برداری هستند. مستندات استفاده از وب سرویس و http برای ارسال پیامک در بخش درگاه پیام کوتاه قابل دانلود است.
| منوی مرکز آموزش |
|---|
| جستجو |
|---|