ارسال تضمین‌شده (SOS) — تحویل با failover چندارائه‌دهنده

ارسال پیامک با تضمین تحویل بالاتر: در صورت قطعی یک ارائه‌دهنده، سامانه خودکار به ارائه‌دهندهٔ بعدی سوییچ می‌کند.

POST /api/v1/sms/sos

برخلاف ارسال معمولی که با اعتبار پنل خودتان و از طریق یک ارائه‌دهندهٔ پیامک انجام می‌شود، «ارسال تضمین‌شده (SOS)» از زیرساخت پلتفرم و زنجیره‌ای از چند ارائه‌دهنده استفاده می‌کند: اگر ارائه‌دهندهٔ اول در دسترس نباشد، پیام بدون هیچ کاری از سمت شما، از طریق ارائه‌دهندهٔ بعدی ارسال می‌شود.

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

هزینهٔ هر گیرنده از کیف پول شما کسر می‌شود؛ اگر بخشی از گیرندگان با وجود تلاش هر ارائه‌دهنده تحویل نشوند، هزینهٔ همان بخش بازگردانده می‌شود.

در داشبورد از مسیر «ارسال پیامک ← ارسال تضمین‌شده (SOS)» و از طریق API عمومی با endpoint زیر در دسترس است (نیازمند فعال بودن قابلیت sms.sos روی حساب و دسترسی کلید API).

پارامترها

نام نوع الزامی توضیح
group_ids integer[] خیر شناسهٔ گروه‌های دفترچه تلفن که گیرندگان از آن خوانده می‌شوند. مثال: [3, 7]
numbers string[] خیر شماره‌های موبایل اضافی (۰۹xxxxxxxxx). مثال: ["09121234567"]
message string بله متن پیام (حداکثر ۶۰۰ کاراکتر). مثال: کد ورود شما: 48213
from string خیر سرشمارهٔ فرستنده؛ در صورت نبود، سرشمارهٔ پیش‌فرض حساب. مثال: 5000XXXX