سرویس پیامک (SMS)

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

پوشش جهانی

این سرویس محدودیتی در اپراتور مقصد ندارد و پیام‌های شما را به تمام شماره‌های معتبر جهانی (با پیش‌شماره صحیح) تحویل می‌دهد.

ساختار درخواست

برای استفاده از این سرویس، در متد /send باید مقدار پارامتر action را برابر با sms قرار دهید.

آبجکت بدنه

در این سرویس، تنها پارامتر مورد نیاز در payload، متن پیام شماست:

پارامتر	نوع	اجباری	توضیحات
message	string	✅	کد ارسالی شما برای احراز هویت کاربر

فرمت شماره‌های بین‌الملل

برای ارسال موفق به خارج از کشور، شماره موبایل در فیلد destination باید حتماً با کد کشور (بدون 00 یا +) شروع شود.

• مثال ترکیه: 905xxxxxxxxx
• مثال عراق: 9647xxxxxxxxx

نمونه ساختار بدنه

ارسال پیامک (داخلی یا خارجی)

ساختار ارسال برای شماره‌های ایران و خارج از ایران یکسان است، تنها تفاوت در شماره مقصد (destination) است.

SMS Request Structure

{
  "token": "YOUR_ACCESS_TOKEN",
  "destination": "905321234567",
  "action": "sms",
  "payload": {
    "code": "12345"
  }
}

نکات مهم

1. محاسبه هزینه: هزینه پیامک‌های بین‌المللی بر اساس نرخ مقصد (کشور مربوطه) محاسبه شده و از کیف پول شما کسر می‌گردد.