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

Shell
curl -X POST 'https://api.sms-webservice.com/api/V3/SendTokenSingle' \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d @- <<JSON
{
  "ApiKey": "$PAYAM_RESAN_API_KEY",
  "TemplateKey": "verifycode",
  "Destination": 9121112222,
  "p1": "123456"
}
JSON

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

هر متد با پارامترهای ورودی، نمونه پاسخ و کد آماده در چهار زبان مستند شده است: ارسال یک متن به یک یا چند شماره، ارسال چند متن به چند گیرنده، ارسال با الگو (پترن)، فهرست الگوهای پنل، و استعلام وضعیت تحویل با شناسه پیام یا شناسه پیگیری خودتان.

اگر می‌خواهید پیش از نوشتن یک خط کد، متدها را زنده امتحان کنید، رابط Swagger همان سرویس را با کلید شما اجرا می‌کند و پاسخ خام را نشان می‌دهد.

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

وب سرویس پیامک این امکان را می‌دهد که از داخل کد سایت یا اپلیکیشن، پیامک بفرستید، دریافت کنید و وضعیت تحویل آن را پیگیری کنید، بدون اینکه نیازی به ورود دستی به پنل داشته باشید.

ارسال پیامک تکی، انبوه و الگویی

با یک درخواست ساده می توانید به یک یا چند شماره پیام بفرستید. در حالت الگویی، متن از پیش تأیید شده را با مقادیر متغیر پر می کنید تا پیام حتی به شماره های مسدود شده هم برسد.

سرویس OTP و اعتبارسنجی

کد یک‌بارمصرف را با اولویت بالا و تأخیر کم ارسال می کند. در صورت نرسیدن پیامک، امکان fallback به تماس صوتی هم وجود دارد تا فرآیند ورود یا تأیید شماره قطع نشود.

دریافت پیامک و گزارش وضعیت تحویل

پیامک های ورودی را می توانید از طریق webhook به صورت آنی دریافت کنید یا وضعیت پیام های ارسالی را استعلام بگیرید تا بدانید پیام واقعاً به گوشی رسیده یا نه.

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

ارسال پیامک از طریق پترن

در این روش ابتدا متن پیام را یک‌بار به‌صورت الگو تعریف و تأیید می‌کنید. بعد در هر درخواست فقط مقادیر متغیر (مثل کد تأیید یا نام کاربر) را ارسال می‌کنید. پیام‌های الگویی اولویت ارسال بالاتری دارند و حتی به شماره‌هایی که پیامک تبلیغاتی را مسدود کرده‌اند هم می‌رسند. برای OTP، اطلاع‌رسانی سفارش و پیام‌های سیستمی این روش معمولاً بهترین انتخاب است.

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

ثبت‌نام و فعال‌سازی سرویس

پس از ساخت حساب در سامانه، از منوی «API» سپس «کلید API» کلیک کنید و «درخواست فعال سازی» رو بزنید تا سرویس وب سرویس برای شما فعال شود. بعد از فعالسازی بر روی دکمه «ساخت کلید» کلیک کنید تا کلید برای شما ساخته شود.

انتخاب خط فرستنده

برای ارسال معمولی به یک خط فعال روی حساب نیاز دارید. اگر قرار است کد تایید یا پیام خدماتی بفرستید که باید به شماره‌های موجود در بلک‌لیست مخابرات هم برسد، باید از مسیر خط خدماتی و الگو استفاده کنید، نه خط تبلیغاتی.

ثبت الگو

در صورت نیاز. اگر متن پیام شما ثابت است و فقط متغیر دارد، از زیرمنوی «وب سرویس ارسال پترن» الگو را ثبت کنید. الگو پس از تایید، یک TemplateKey می‌گیرد که همان را در درخواست‌هایتان پاس می‌دهید.

اولین ارسال آزمایشی

با نمونه‌کد بخش قبل یک پیام به شماره‌ی خودتان بفرستید و پاسخ را بررسی کنید. اگر Success برابر true بود، شناسه‌ی برگشتی را بردارید و با StatusById وضعیت تحویلش را استعلام بگیرید. با همین یک چرخه، هم اتصال و هم پیگیری را یک‌جا تست کرده‌اید.

تنظیم دریافت پیامک

اگر می‌خواهید پاسخ کاربران را هم در سیستم خود داشته باشید، از زیرمنوی «دریافت از طریق وب سرویس» یک آدرس به سامانه معرفی کنید. به محض دریافت هر پیامک، سامانه آن آدرس را فراخوانی می‌کند و اطلاعات پیام را برایتان می‌فرستد.

پیامک api پیام رسان

افزونه‌ها و نرم‌افزارهای متصل

برای فروشگاه‌ساز و فرم‌ساز محبوب خودتان، افزونه آماده داریم: نصب می‌کنید، کلید API را می‌گذارید و پیامک‌ها از همان نرم‌افزار می‌روند، بدون یک خط کد.

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

اگر سایت شما وردپرسی است، برای بیشتر کارها لازم نیست خودتان با وب سرویس کد بزنید. افزونه رایگان پیام رسان کار احراز هویت سایت را کامل می‌کند: ورود و ثبت‌نام با کد پیامکی، فرم ساز اختصاصی، تأیید شماره خریدار در ووکامرس، کپچا و پروفایل کاربری؛ همه با ظاهری که خودتان تعیین می‌کنید.

ورود و ثبت‌نام با شماره موبایل

ارسال با الگو (پترن)

فرم‌ساز اختصاصی

تأیید شماره در ووکامرس

کپچا و ضدربات

گزارش ارسال‌ها

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

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

  • نرم افزارهای حسابداری
  • نرم افزارهای اموزشی
  • وب سایت های اینترنتی
  • فروشگاه اینترنتی
  • نرم افزار مدیریت مطب
  • و …

در عمل تفاوتی ندارند و هر دو به یک چیز اشاره می‌کنند: رابطی که نرم‌افزار شما را به سامانه‌ی پیامکی وصل می‌کند. «وب سرویس» اصطلاح رایج‌تر در بازار ایران است و «API» اصطلاح فنی‌تر و بین‌المللی. وب سرویس پیام رسان بر پایه‌ی REST نوشته شده و با درخواست HTTP ساده کار می‌کند.

ارسال از طریق URL فقط قابلیت ارسال دارد. با وب سرویس علاوه بر ارسال، می‌توانید پیامک‌های دریافتی را بخوانید و وضعیت تحویل پیام‌های ارسالی را استعلام بگیرید. اگر سیستم شما نیاز دارد بداند پیام رسیده یا نه، وب سرویس تنها گزینه است.

هیچ زبان خاصی لازم نیست. چون سرویس بر پایه‌ی REST است، هر زبانی که بتواند درخواست HTTP بفرستد کافی است. نمونه‌کد آماده برای PHP، سی‌شارپ، جاوا و پایتون در مستندات موجود است و برای بقیه‌ی زبان‌ها هم همان ساختار درخواست تکرار می‌شود.

با متد Send تا ۹۹ شماره در قالب یک آرایه. اگر می‌خواهید به هر گیرنده متن جداگانه‌ای بفرستید، متد SendMultiple این کار را در گروه‌های ۱۰۰تایی انجام می‌دهد و اجازه می‌دهد برای هر شماره، متن و شماره‌ی فرستنده‌ی مجزا تعیین کنید.

هنگام ارسال، سرویس یک شناسه در فیلد Result.id برمی‌گرداند. این شناسه را ذخیره کنید و بعداً با متد StatusById وضعیت تحویل همان پیام را استعلام بگیرید. در یک درخواست می‌توانید وضعیت چند پیام را هم‌زمان بپرسید.

چون این سرویس خطاهای کاربردی را داخل بدنه‌ی پاسخ برمی‌گرداند، نه با کد وضعیت HTTP. حتی وقتی کلید API اشتباه باشد یا سقف ارسال روزانه پر شده باشد، باز هم ۲۰۰ می‌گیرید و فقط فیلد Success برابر false است. همیشه Success را بررسی کنید و در صورت خطا، ErrorCode را بخوانید.

یعنی فرمت شماره‌ی گیرنده پذیرفته نشده است. شماره باید طبق مستندات همان متد نرمال شود؛ شماره‌ای که کاربر در فرم وارد می‌کند معمولاً با صفر شروع می‌شود یا فرمت بین‌المللی دارد. پیش از فراخوانی سرویس، شماره را نرمال کنید و شماره‌های نامعتبر را همان‌جا رد کنید.

به احتمال زیاد خطای ۱۰ می‌گیرید: آی‌پی درخواست‌دهنده در فهرست آی‌پی‌های معتبر نیست. پس از هر مهاجرت سرور یا تغییر آی‌پی، باید آی‌پی جدید را در پنل ثبت کنید. این خطا بی‌صدا اتفاق می‌افتد چون هیچ چیزی در کد شما عوض نشده است.

متد AccountInfo فقط ApiKey می‌گیرد، پیامکی نمی‌فرستد و مقدار اعتبار و فهرست خطوط فعال را برمی‌گرداند. می‌توانید آن را روی یک کران دوره‌ای بگذارید تا پیش از خالی شدن حساب خبردار شوید به‌جای اینکه از تیکت کاربران بفهمید.

خیر. افزونه‌های آماده برای وردپرس، ووکامرس، دیجیتس، گرویتی فرم، پرستاشاپ و اپن‌کارت موجود است و برای سناریوهای کد تایید، نسخه‌ی مخصوص پترن هم ارائه شده. کافی است کلید API را در تنظیمات افزونه وارد کنید.

این مقاله مفید بود ؟

به این مقاله امتیاز دهید

میانگین رتبه 0 / 5. تعداد رای : 0

هنوز کسی به این مطلب رای نداده ؛ شما اولین نفر باشید !

ثبت نام ورود