سامانه پیام کوتاه
💻 ویژه توسعه‌دهندگان

وب‌سرویس پیامک و API پیام کوتاه

سایت، اپلیکیشن یا نرم‌افزار خود را با چند خط کد به پنل پیامکی ASA وصل کنید. ارسال، دریافت، مدیریت پیامک و OTP از طریق REST و SOAP — با نمونه‌کد آماده برای ۵ زبان محبوب برنامه‌نویسی.

ثبت‌نام و دریافت کلید API راهنمای REST راهنمای SOAP راهنمای URL (PDF) ورود به پنل و ارسال تیکت
زیر ۵ ثانیهتحویل OTP
۹۹٫۹٪آپ‌تایم سرویس
۵ زباننمونه‌کد آماده
REST + SOAPپشتیبانی کامل

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

راهنمای کامل REST، SOAP و ارسال از طریق URL

📘

راهنمای وب‌سرویس REST

مستندات آنلاین متدهای REST، پارامترها و نمونه‌های فراخوانی API پیامک.

مشاهده مستندات REST ←
📗

راهنمای وب‌سرویس SOAP

مستندات سرویس SOAP برای اتصال سیستم‌های سازمانی و نرم‌افزارهای مبتنی بر WSDL.

مشاهده مستندات SOAP ←
📄

راهنمای وب‌سرویس URL

فایل PDF راهنمای ارسال پیامک از طریق URL — مناسب اتصال سریع و سیستم‌های ساده.

دانلود PDF مستندات URL ←

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

فقط کافی است username، password و شماره خط را جایگزین کنید

$curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api-payamak.com/api/v1/rest/sms/send", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "{\"from\":\"3000XXXX\",\"recipients\":\"09123456789\",\"message\":\"کد ورود: 5839\",\"type\":0}", CURLOPT_HTTPHEADER => [ "Content-Type: application/json", "password: YOUR_PASSWORD", "username: YOUR_USERNAME" ], ]); $response = curl_exec($curl); curl_close($curl); echo $response;
var client = new RestClient("https://api-payamak.com/api/v1/rest/sms/send"); var request = new RestRequest(Method.POST); request.AddHeader("username", "YOUR_USERNAME"); request.AddHeader("password", "YOUR_PASSWORD"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"from\":\"3000XXXX\",\n \"recipients\":\"09123456789\",\n \"message\":\"کد ورود: 5839\",\n \"type\":0\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request);
HttpResponse<String> response = Unirest.post("https://api-payamak.com/api/v1/rest/sms/send") .header("username", "YOUR_USERNAME") .header("password", "YOUR_PASSWORD") .header("Content-Type", "application/json") .body("{\n \"from\":\"3000XXXX\",\n \"recipients\":\"09123456789\",\n \"message\":\"کد ورود: 5839\",\n \"type\":0\n}") .asString();
import http.client conn = http.client.HTTPConnection("api-payamak.com") payload = "{\n \"from\":\"3000XXXX\",\n \"recipients\":\"09123456789\",\n \"message\":\"کد ورود: 5839\",\n \"type\":0\n}" headers = { 'username': "YOUR_USERNAME", 'password': "YOUR_PASSWORD", 'Content-Type': "application/json" } conn.request("POST", "/api/v1/rest/sms/send", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
const http = require("http"); const options = { method: "POST", hostname: "api-payamak.com", path: "/api/v1/rest/sms/send", headers: { username: "YOUR_USERNAME", password: "YOUR_PASSWORD", "Content-Type": "application/json" } }; const req = http.request(options, function (res) { const chunks = []; res.on("data", chunk => chunks.push(chunk)); res.on("end", () => console.log(Buffer.concat(chunks).toString())); }); req.write(JSON.stringify({ from: '3000XXXX', recipients: ['09123456789'], message: 'کد ورود: 5839', type: 0 })); req.end();

امکانات وب‌سرویس ASA SMS

هر چیزی که یک تیم فنی از یک API پیامکی می‌خواهد — همه‌جا در دسترس

🔑

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

ارسال کد یک‌بارمصرف (OTP) و ورود دو‌مرحله‌ای با تحویل زیر ۵ ثانیه، حتی روی شماره‌های بلک‌لیست تبلیغاتی (با پترن خدماتی).

📞

تماس صوتی و پیام صوتی

ارسال کد و پیام از طریق تماس تلفنی؛ مناسب حالتی که پیامک به گیرنده نمی‌رسد یا سرعت تحویل حیاتی است.

⚡

سرعت و انتخاب هوشمند خط

سیستم بر اساس پایداری و سرعت، بهترین سرشماره و مسیر ارسال را به‌صورت خودکار انتخاب می‌کند.

🛡️

امنیت با SSL و Basic Auth

پشتیبانی از Http Basic Authentication و لایه امن SSL برای فراخوانی امن وب‌سرویس در بستر HTTPS.

🔁

Callback دریافت و وضعیت

انتقال آنی پیامک‌های دریافتی به URL دلخواه (Receive Webhook) و ارسال وضعیت پیامک‌های ارسالی به Status Callback URL شما.

⏰

زمان‌بندی و ارسال متناظر

ارسال زمان‌دار، ارسال متناظر (هر شماره متن جدا) و مدیریت ارسال‌های زمان‌بندی‌شده از طریق API.

دسترسی‌های وب‌سرویس ASA

متدهای اصلی که با API در اختیار شما قرار می‌گیرد

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

  • ارسال پیامک تکی
  • ارسال پیامک انبوه و گروهی
  • ارسال متناظر (هر شماره متن جدا)
  • ارسال با خط اختصاصی
  • ارسال با پترن / الگو (خدماتی)
  • ارسال به بانک شماره

📥 دریافت و گزارش

  • دریافت پیامک‌های ورودی
  • وضعیت (Delivery) پیامک ارسالی
  • گزارش ارسال‌های انبوه
  • مشاهده مشخصات پیام
  • Receive Webhook (Callback دریافت)
  • Status Callback (وضعیت ارسال)

⏰ زمان‌بندی و صوتی

  • افزودن ارسال زمان‌دار
  • افزودن ارسال متناظر زمان‌دار
  • ارسال سررسید / یادآوری
  • مدیریت و حذف ارسال زمان‌دار
  • ارسال پیام صوتی از متن یا فایل
  • زمان‌بندی پیام صوتی

💰 حساب و اعتبار

  • دریافت میزان اعتبار
  • دریافت تعرفه ارسال
  • جزئیات کاربر
  • تراکنش‌های مالی

📇 دفترچه تلفن

  • افزودن گروه جدید
  • افزودن مخاطب جدید
  • ویرایش و حذف مخاطب
  • دریافت اطلاعات دفترچه تلفن
  • بررسی موجودی شماره

👥 مدیریت نمایندگی

  • افزودن / حذف کاربر
  • دریافت شناسه و اطلاعات کاربر
  • تغییر اعتبار / تعرفه کاربر
  • ثبت فیش واریزی
  • فراموشی رمز عبور

افزونه‌های آماده — بدون کدنویسی

اگر با CMS معروف کار می‌کنید، یکی از افزونه‌های ASA را نصب کنید و در چند دقیقه به پنل وصل شوید

🧩

WordPress

افزونه پیامک
🛒

WooCommerce

پیامک سفارش
🖥️

WHMCS

فاکتور و تیکت
📰

Joomla

خبرنامه پیامکی
🛍️

PrestaShop

وضعیت سفارش
📦

OpenCart

پیامک فروشگاه
📝

Gravity Forms

اعلان فرم
🏪

Dokan

تأیید فروشنده

وب‌سرویس ASA را رایگان تست کنید

ثبت‌نام در چند دقیقه، دریافت کلید API و ارسال اولین پیامک از طریق وب‌سرویس. پنل پایه بدون هزینه تمدید سالانه و مستندات کامل REST، SOAP و URL در اختیار شماست.

ثبت‌نام و دریافت API Key راهنمای REST راهنمای SOAP راهنمای URL (PDF)

❓ سوالات متداول وب‌سرویس و API

وب‌سرویس پیامک ASA دقیقاً چه کاری انجام می‌دهد؟
یک درگاه API است که سایت، نرم‌افزار یا اپلیکیشن شما را به سامانه پیامکی ASA وصل می‌کند تا از طریق کد بتوانید پیامک ارسال، دریافت، زمان‌بندی و مدیریت کنید. مناسب OTP، اطلاع‌رسانی سفارش، نوتیفیکیشن سیستم، تبلیغات و اتوماسیون.
از REST استفاده کنم یا SOAP؟
ASA هر دو را پشتیبانی می‌کند. اکثر پروژه‌های امروزی روی REST با JSON کار می‌کنند و سریع‌تر پیاده‌سازی می‌شود. اگر سیستم قدیمی یا سازمانی دارید که SOAP می‌طلبد، مستندات SOAP هم آماده است: راهنمای SOAP.
برای شروع چه چیزهایی لازم دارم؟
فقط ثبت‌نام در پنل ASA و دریافت نام کاربری، رمز عبور (یا API Key) و انتخاب یک خط ارسال. سپس یکی از نمونه‌کدهای بالا را در پروژه‌تان استفاده کنید. مستندات REST: اینجا.
OTP و پیامک‌های مهم به بلک‌لیست هم می‌رسد؟
با استفاده از وب‌سرویس پترن (الگوی خدماتی) در پنل ASA، پیامک‌های اطلاع‌رسانی و کد تأیید می‌توانند حتی به شماره‌هایی که پیامک تبلیغاتی را مسدود کرده‌اند، ارسال شوند.
Callback و Webhook دارد؟
بله. می‌توانید یک URL برای دریافت پیامک‌های ورودی (Receive Webhook) و یک URL برای دریافت وضعیت پیامک‌های ارسالی (Status Callback) تنظیم کنید تا سیستم شما Real-Time به‌روز شود و مصرف منابع سرور کاهش یابد.
محدودیت تعداد ارسال از وب‌سرویس وجود دارد؟
محدودیت سختی روی تعداد وجود ندارد و ارسال انبوه از طریق API پشتیبانی می‌شود. برای تیراژهای خیلی بالا (چند صد هزار در ماه)، تعرفه ویژه و راهکار اختصاصی ارائه می‌شود.
پشتیبانی فنی برای اتصال ارائه می‌کنید؟
بله. تیم فنی ASA از طریق تیکت پشتیبانی پنل کاربری و ایمیل info@asasms.com پاسخگوی برنامه‌نویسان است و در راه‌اندازی وب‌سرویس، Callback و پترن‌ها راهنمایی می‌کند.