وب سرویس پیامک و API پیام کوتاه
const string username = “username“;
const string password = “password“;
const string from = “۵۰۰۰…”;
const string to = “۰۹۱۲۱۲۳۴۵۶۷۸“;
const string text = “کد تائید شما: ۱۲۳۴“;
const bool isFlash = false;
RestClient restClient = new RestClient
restClient.Send(to, from, text, isFlash);
$username = ‘username‘;
$password = ‘password‘;
$api = new yekpayamakApi($username,$password);
$sms = $api->sms();
$to = ‘۰۹۱۲۱۲۳۴۶۷۸‘;
$from = ‘۵۰۰۰…‘;
$text = ‘تست وب سرویس یک پیامک‘;
$response = $sms->send($to,$from,$text);
const username = ‘username‘;
const password = ‘password‘;
const api = new YekpayamakApi(username,password);
const sms = api.sms();
const to = ‘۰۹۱۲۳۴۵۶۷۸۹‘;
const from = ‘۵۰۰۰…’;
const text = ‘تست وب سرویس پیام کوتاه‘;
sms.send(to,from,text).then(res=>{
username = ‘username‘
password = ‘password‘
api = Api(username,password)
sms = api.sms()
to = ‘۰۹۱۲۳۴۵۶۷۸۹‘
_from = ‘۵۰۰۰…’
text = ‘تست api ارسال پیامک‘
response = sms.send(to,_from,text)
let username: String = “username“
let password: String = “password“
let from: String = “۵۰۰۰…”
var to: String = “۰۹۱۲۳۴۵۶۷۸۹“
var text: String = “تست API پیام کوتاه یک پیامک“
var isFlash: Bool = false
var restClient = RestClient(user: username, pass: password)
restClient.Send(to: to, from: from, msg: text, isFlash: isFlash)
نمونه کد های وب سرویس یک پیامک
با استفاده از مستندات آنلاین API و وب سرویس ارسال و دریافت پیامک و نمونه کدهای آن برای بیش از ۱۴ زبان برنامهنویسی، به سادگی نرمافزار یا وب سایت خود را به سامانه ارسال پیامک متصل کنید و در زمان دلخواه خود پیامک های هدفمند ارسال نمایید.
امکانات اصلی وب سرویس ارسال پیامک
وب سرویس پیامکی امکانات بسیار زیادی را در اختیار شما میگذارد، از سادهترین امکان وب سرویس ارسال پیامک تا مدیریت کاربران پنل نمایندگی را میتوانید با استفاده از وب سرویس ملی پیامک به همراه نمونه کدهای موجود مدیریت کنید.
ارسال پیامک بر اساس پترن (الگو)
شما با استفاده از وب سرویس پیامک پترن (الگو) میتوانید پیامکهای اطلاعرسانی خود را حتی به لیست سیاه مخابرات ارسال کنید و نیازی به تهیه خط خدماتی ندارید.
ارسال پیام صوتی
علاوهبر امکان بارگذاری فایل صوتی، میتوانید متن خود را بنویسید (+ ارسال متن از وب سرویس) تا سامانه ملی پیامک آن را خودکار به گفتار (سلیس) تبدیل کند.
بیمه شخص ثالث شما طی ۷ روز آینده منقضی می گردد. بیمیتو
ارسال ۱۰ صبح - منتظر ارسال
پیام جدید برای شما ارسال شده است ترنسیس(transis.me)
ارسال ۱۰ صبح - ارسال شده
بیمه شخص ثالث شما طی ۷ روز آینده منقضی می گردد. بیمیتو
ارسال ۱۰ صبح - ارسال شده
بیمه شخص ثالث شما طی ۷ روز آینده منقضی می گردد. بیمیتو
ارسال ۱۰ صبح - ارسال شده
بیمه شخص ثالث شما طی ۷ روز آینده منقضی می گردد. بیمیتو
ارسال ۱۰ صبح - ارسال شده
بیمه شخص ثالث شما طی ۷ روز آینده منقضی می گردد. بیمیتو
ارسال ۱۰ صبح - منتظر ارسال
بیمه شخص ثالث شما طی ۷ روز آینده منقضی می گردد. بیمیتو
ارسال ۱۰ صبح - منتظر ارسال
بیمه شخص ثالث شما طی ۷ روز آینده منقضی می گردد. بیمیتو
ارسال ۱۰ صبح - منتظر ارسال
وب سرویس ارسال پیامک
- ارسال پیامک تکی
- ارسال پیامک انبوه
- بررسی پیامک های دریافتی
- دریافت میزان اعتبار
- دریافت تعرفه ارسال
- بررسی پیامک های دریافتی
- ارسال پیامک پیشرفته
- ارسال پیامک با دامنه اختصاصی
وب سرویس دریافت پیامک
- مشاهده مشخصات پیام
- حذف پیام دریافتی
- بررسی پیامک های دریافتی
- پیامک های دریافتی کاربران
- انتقال ترافیک دریافتی
وب سرویس ارسال پیامک انبوه
- ارسال پیامک انبوه
- ارسال بانک شماره
- ارسال متناظر
- دریافت گزارش ارسال انبوه
- دریافت اطلاعات بانک شماره
- ارسال پیامک پیشرفته
- حذف ارسال
- به روز رسانی گزارش ارسال
وب سرویس دفترچه تلفن
- افزودن گروه جدید
- افزودن کاربر جدید
- بررسی موجودی شماره
- دریافت اطلاعات دفترچه تلفن
- دریافت اطلاعات گروه ها
- ویرایش مخاطب
- حذف مخاطب
- دریافت اطلاعات مناسبت های مخاطب
وب سرویس زمان بندی
- افزودن ارسال متناظر زماندار
- افزودن ارسال زماندار
- ارسال سر رسید
- مشاهده وضیعت ارسال زماندار
- حذف پیامک زماندار
وب سرویس دفترچه تلفن
- ارسال پیامک صوتی
- زمان بندی پیامک صوتی
- دریافت وضیعت ارسال
وب سرویس نمایندگی پیامک
- افزودن کاربر جدید
- افزودن گروه جدید
- فراموشی رمز عبور
- ثبت فیش واریزی
- تغییر اعتبار کاربر
- دریافت اعتبار کاربر
- دریافت تراکنش های مالی کاربر
- حذف کاربر
- تغییر تعرفه کاربر
وب سرویس تیکت (نمایندگی)
- ثبت تیکت جدید
- دریافت تیکت های کاربران
- دریافت تعداد تیکت های کاربران
- دریافت تیکت های ارسالی
- پاسخگویی به تیکت های دریافتی
- دریافت تعداد تیکت های ارسالی
مزایای وب سرویس یک پیامک
مزایایی که وبسرویس ملی پیامک را به ارائه دهنده بهترین وب سرویس ارسال پیامک تبدیل میکند.
تعرفه بسیار پایین
همیشه به روز
یک پیامک بیش از ۱۰ سال است که سرویس پیامکی خود را ارائه میدهد. در این مدت نقطه قوت خود را در خدمات پیامکی با ثبات برای تمامی کسب و کارها نشان داده است.
وب سرویس درخواستی
اگر سایت شخصی سازی شده دارید و یک وب سرویس مشخص نیاز دارید. تیم فنی برنامه نویس های ما برای نوشتن آن به شما کمک می کنند.
بازگشت هزینه پیامک
اگر به هر دلیلی اس ام اس شما به دست مشتری هدف نرسد، ما هزینه آن را به شما باز خواهیم گرداند و راههای دیگری برای ارسال جلوی پایتان قرار می دهیم.
پشتیبانی ۲۴ / ۷
یک پیامک، تمام روز های هفته، پاسخگوی سوالات و مشکلات شما (از طریق تلفن و تیکت) است؛ در جهت رفع مشکلات پیش آمده در تلاش هستیم.
ضمانت بازگشت وجه
یک پیامک به شما فرصت می دهد تا ۳۰ روز پنل اس ام اس را به صورت رایگان تست کنید. عدم رضایت شما به معنی بازگشت وجه است.
اتصال افزونههای پیامکی به نرمافزار شما
اگر از نرم افزارهای open source مانند وردپرس استفاده میکنید، با سرویس ارسال پیامک وردپرس، وب سایت خود را به پیامک مجهز کنید.
افزونه صبا
پیامک ووکامرس
پیامک گرویتی فرم
پیامک وردپرس sms
میهن پنل پرو
پیامک المنتور
افزونه پیامک کراسنو
پیامک اسپات پلیر
پنل کاربری ونوس
فکتوری (Factori)
پلاگین Digits
افزونه اروند پنل
فایل PDF مستندات وبسرویس
فایلهای PDF مستندات وب سرویس ارسال پیامک REST و SOAP به صورت آفلاین
ارسال
دریافت
پترن و الگو
دفترچه تلفن
ارسالهای زماندار
ارسال منطقه ای
مدیریت کاربران
وبسایت یا نرمافزار خود را به پیامک مجهز کنید.
به پنل اس ام اس یک پیامک متصل شوید و پیامکهایتان را ارسال، دریافت و مدیریت کنید.
وب سرویس پیامک چیست؟
وب سرویس پیامک یا API پیامک، ابزاری برنامه نویسی شده برای ارسال و دریافت پیامک به صورت خودکار از طریق نرم افزار، اپلیکیشن یا وب سایت است. به جای اینکه برای ارسال پیامک وارد پنل کاربری سامانه شوید، می توانید با چند خط کد ساده و اتصال به API، مستقیماً از داخل سیستم خود پیامک بفرستید.
این روش مخصوصاً برای ارسال پیام های سیستمی مانند کدهای تأیید، اعلان ها یا اطلاع رسانی های خودکار بسیار کاربرد دارد. در واقع وب سرویس پیامک یک درگاه ارتباطی بین نرم افزار شما و سامانه پیامکی است که تبادل اطلاعات را با سرعت بالا و بدون دخالت انسان انجام می دهد. این قابلیت نه تنها زمان شما را ذخیره می کند، بلکه دقت، امنیت و یکپارچگی را هم در فرآیند ارسال پیامک افزایش می دهد.
مزایای استفاده از API پیامک
استفاده از API پیامک، امکاناتی فراتر از ارسال دستی پیامک در اختیار شما قرار می دهد و می تواند نقش مهمی در بهینه سازی فرایندهای ارتباطی کسب و کارتان ایفا کند. در ادامه به مهم ترین مزایای استفاده از وب سرویس پیامک اشاره می کنیم:
- ارسال خودکار و هوشمند: با API پیامک می توانید پیام ها را بر اساس رویدادهای مختلف (مثل ثبت نام کاربر، خرید موفق یا تغییر وضعیت سفارش) به صورت کاملاً خودکار ارسال کنید. این کار، سرعت و دقت ارسال پیام ها را افزایش می دهد.
- کاهش خطای انسانی: با حذف فرایندهای دستی، احتمال بروز خطا در ارسال پیامک ها به حداقل می رسد.
- یکپارچه سازی با نرم افزارهای دیگر: API پیامک به راحتی در سیستم های مدیریت ارتباط با مشتری (CRM)، سایت فروشگاهی، اپلیکیشن های موبایل و سامانه های مدیریتی قابل ادغام است.
- امکان گزارش گیری دقیق: پس از ارسال پیامک، می توانید وضعیت تحویل، شماره مقصد، محتوای پیام و زمان دقیق ارسال را به صورت برنامه نویسی شده دریافت و تحلیل کنید.
- ارسال به تعداد بالا: API این امکان را فراهم می کند که هزاران پیامک را به صورت همزمان، سریع و پایدار به مخاطبان ارسال کنید.
- صرفه جویی در زمان و منابع انسانی: دیگر نیازی نیست فردی مسئول ارسال پیامک ها باشد. تمام فرایندها به صورت خودکار و هوشمند انجام می شود.
در مجموع، API پیامک نه تنها کارایی را بالا می برد، بلکه تجربه کاربری بهتری برای مشتریان شما ایجاد می کند؛ چون پیام ها دقیق، به موقع و مرتبط با نیاز آن ها ارسال می شوند.
نحوه دریافت API و کلید دسترسی
برای استفاده از وب سرویس پیامک، ابتدا باید در یک سامانه پیامکی معتبر ثبت نام کنید. پس از تایید اطلاعات و فعال سازی حساب کاربری، دسترسی به بخش API پیامک برای شما فعال می شود. در اینجا، معمولاً مراحل زیر را طی می کنید:
- ورود به پنل کاربری: بعد از ثبت نام و ورود، وارد قسمت تنظیمات وب سرویس یا بخشی با عنوان مشابه شوید.
- دریافت مستندات فنی (Documentation): در این قسمت راهنمای دقیق نحوه اتصال به API در زبان های مختلف برنامه نویسی در اختیار شما قرار می گیرد.
- ساخت یا دریافت API Key: برای هر درخواست به وب سرویس، باید یک کلید اختصاصی یا همان API Key داشته باشید. این کلید به نوعی مانند رمز عبور شما برای ارتباط با سامانه است.
- تنظیم دسترسی ها: برخی سامانه ها اجازه می دهند کلید را به IP خاص یا محدودیت های ارسال پیامک متصل کنید تا امنیت بیشتری داشته باشید.
- نکته مهم این است که کلید دسترسی را مانند اطلاعات محرمانه نگهداری کنید. انتشار آن در کدهای عمومی یا محیط های ناامن می تواند منجر به سوء استفاده و ارسال پیامک های غیرمجاز شود.
در بسیاری از پنل ها، همچنین می توانید چند کلید مختلف بسازید و برای هر پروژه یا نرم افزار از کلیدی جداگانه استفاده کنید. این کار، مدیریت امنیت را ساده تر و حرفه ای تر می کند.
انواع روش ارسال پیامک از طریق API
وب سرویس پیامک، بسته به نیاز شما، امکانات متنوعی برای ارسال پیامک فراهم می کند. این تنوع باعث می شود بتوانید دقیقاً بر اساس سناریوهای مختلف کسب و کار، پیام ها را با بهترین زمان و هدف، ارسال کنید. در ادامه، سه روش رایج ارسال پیامک از طریق API را بررسی می کنیم.
ارسال تکی (Single Send)
ارسال تکی پیامک یکی از پرکاربردترین روش ها در وب سرویس پیامک است. در این مدل، پیام به یک گیرنده خاص و مشخص ارسال می شود. این روش برای سناریوهایی طراحی شده که نیاز به ارسال پیام شخصی سازی شده یا محرمانه دارند. رایج ترین کاربرد آن در ارسال کد تایید (OTP)، رمز عبور یکبار مصرف، پیام های هشدار سیستمی یا اطلاع رسانی های اختصاصی است.
مزیت اصلی این روش، سرعت بالا و واکنش سریع سیستم نسبت به فعالیت کاربر است. به طور مثال، به محض کلیک کاربر روی درخواست رمز عبور جدید، API فعال می شود و پیام در همان لحظه ارسال خواهد شد. همین زمان بندی دقیق، تجربه کاربری حرفه ای تری ایجاد می کند.
همچنین می توانید با شخصی سازی متن پیام (مثلاً درج نام کاربر)، حس ارتباط انسانی و توجه را در تعاملات خود تقویت کنید.
ارسال گروهی (Bulk Send)
در ارسال گروهی، یک پیام واحد به تعداد زیادی از شماره ها به صورت همزمان فرستاده می شود. این روش، ایده آل برای اطلاع رسانی های انبوه، ارسال پیام های تبلیغاتی یا اطلاعیه های عمومی است. شما می توانید فهرستی از شماره های مشتریان، کاربران ثبت نام شده یا حتی مخاطبان هدف در یک کمپین خاص را از طریق API به سامانه ارسال کرده و تنها با یک درخواست، پیام را به تمام آن ها منتقل کنید.
یکی از مزایای مهم این روش، صرفه جویی در زمان و پوشش گسترده ی مخاطبان است. فرض کنید بخواهید درباره یک جشنواره تخفیف یا تغییر ساعت کاری به هزاران نفر اطلاع دهید؛ این کار با ارسال گروهی و بدون دخالت انسانی، در عرض چند ثانیه انجام می شود.
برخی API ها حتی امکان شخصی سازی در ارسال گروهی را فراهم می کنند. یعنی می توانید در کنار متن یکسان، نام یا اطلاعات خاص هر کاربر را در پیام قرار دهید. این ترکیب از مقیاس بالا و شخصی سازی هوشمند، یکی از ارزشمندترین قابلیت های API پیامک محسوب می شود.
ارسال زمان بندی شده (Scheduled Send)
در برخی مواقع، زمان ارسال پیام به اندازه محتوای آن اهمیت دارد. ارسال پیامک در زمان نادرست می تواند باعث نادیده گرفته شدن یا حتی نارضایتی مخاطب شود. اینجاست که قابلیت ارسال زمان بندی شده از طریق API پیامک اهمیت پیدا می کند.
با استفاده از این ویژگی، شما می توانید یک زمان مشخص در آینده را برای ارسال پیام تعیین کنید. به عنوان مثال:
- ارسال پیام یادآوری قرار ملاقات یک روز قبل از جلسه
- ارسال پیامک تبریک تولد راس ساعت ۸ صبح
- اطلاع رسانی درباره پایان مهلت پرداخت در ساعات کاری
همه این موارد با تعریف پارامتر زمان (timestamp) در درخواست API قابل انجام هستند. برخی سیستم ها حتی امکان برنامه ریزی روزانه یا هفتگی پیامک ها را نیز فراهم می کنند.
این روش نه تنها به شما کمک می کند تا ارتباط حرفه ای تری با مشتریان داشته باشید، بلکه مدیریت بهتر زمان و منابع را نیز به همراه دارد. می توانید پیامک ها را در زمان خلوت سامانه ها یا با هماهنگی کمپین های بازاریابی دیجیتال زمان بندی کنید تا بازدهی بیشتری داشته باشند.
نکات امنیتی در استفاده از وب سرویس پیامک
هنگامی که از وب سرویس پیامک برای ارسال خودکار پیام ها استفاده می کنید، توجه به مسائل امنیتی اهمیت زیادی پیدا می کند. چرا که در این حالت، اطلاعات کاربران، محتوای پیام ها و حتی اعتبار مالی پنل شما درگیر است و هرگونه بی دقتی می تواند به سوءاستفاده و زیان مالی منجر شود. در ادامه، برخی از مهم ترین نکات امنیتی برای جلوگیری از چنین مشکلاتی آورده شده است:
- محافظت از API Key: کلید دسترسی به API همانند رمز عبور شماست و اگر در اختیار افراد ناشناس قرار گیرد، امکان سوءاستفاده مالی و ارسال پیامک از طرف شما فراهم می شود. برای جلوگیری از این خطر، API Key را در فایل های امن مانند .env نگهداری کنید، هرگز آن را در فضاهای عمومی منتشر نکنید و در صورت امکان، دسترسی را به IP های خاص محدود کنید.
- استفاده از HTTPS: همیشه از پروتکل امن HTTPS برای ارسال درخواست ها به وب سرویس پیامک استفاده کنید. این کار باعث رمزنگاری اطلاعات در حین انتقال می شود و از حملاتی مانند شنود (Man-in-the-Middle) جلوگیری می کند. استفاده از HTTP ساده می تواند منجر به افشای اطلاعات مهمی مانند کلید دسترسی شود.
- اعتبارسنجی داده های ورودی: قبل از ارسال پیامک، حتماً شماره موبایل و محتوای پیام را بررسی و اعتبارسنجی کنید. این مرحله از ارسال پیام به شماره های اشتباه، محتوای نامناسب یا حتی بلاک شدن پنل پیامکی جلوگیری می کند. اگر API شما به سایر سیستم ها یا کاربران متصل است، این اعتبارسنجی باید سمت سرور انجام شود.
- مانیتورینگ مداوم: فعالیت های API را به طور منظم بررسی کنید. استفاده از لاگ ها، آمار ارسال و گزارش های خطا به شما کمک می کند فعالیت های مشکوک مانند ارسال حجم بالای پیامک از IP ناشناس را به سرعت شناسایی کرده و جلوی خسارت را بگیرید. اگر پنل شما قابلیت هشدار خودکار دارد، حتماً آن را فعال کنید.
- مدیریت سطح دسترسی کاربران: اگر چند نفر از اعضای تیم به API دسترسی دارند، برای هر فرد یک API Key جداگانه تعریف کنید و سطح دسترسی ها را تفکیک نمایید. این کار باعث می شود در صورت بروز مشکل، بتوانید دسترسی یک فرد خاص را بدون اختلال در کل سیستم، غیرفعال کنید.
این نکات امنیتی به شما کمک می کند تا از بروز مشکلات احتمالی جلوگیری کنید و تجربه ای امن و مطمئن از وب سرویس پیامک داشته باشید. رعایت این اصول می تواند امنیت سیستم شما را بالا برده و از سوءاستفاده های احتمالی جلوگیری کند.
سوالات متداول
برای استفاده از وب سرویس کدام یک از پنل ها را باید خریداری کنم؟
برای استفاده از وبسرویس، باید یکی از پنل های موجود را خریداری نمایید و امکان وب سرویس بر روی پنل پایه فعال نیست. لازم به ذکر است استفاده از api ارسال پیامک رایگان بوده و شامل پرداخت هزینه جداگانه نمیباشد.
در صورت نارضایتی از خدمات، بازگشت وجه امکان پذیر است؟
بله، تا ۳۰ روز پس از خرید، بازگشت وجه پرداختی امکان پذیر است.
آیا امکان ارسال پیامک به افراد لیست سیاه مخابرات وجود دارد؟
بله، شما با استفاده از قابلیت ارسال پیامک از طریق پترن(الگو) قادر خواهید بود پیامک های پیشفرض خود را پس از تایید کارشناسان یک پیامک پیامک، به لیست سیاه مخابرات ارسال نمائید و برای دریافت اطلاعات بیشتر با کارشناسان تماس بگیرید.
بلاگ یک پیامک