SMS · API SMS

API SMS: SMS با یک درخواست از نرم‌افزار شما.

از CRM، ERP، زیرساخت تجارت الکترونیک یا برنامه خودتان SMS بفرستید، وضعیت تحویل را پرس‌وجو کنید، پیام‌های ورودی و اعلان‌های انصراف را دریافت کنید. REST و JSON؛ احراز هویت با کلید Bearer، رویدادها با Webhook امضاشده با HMAC.

همین حالا درخواست دهید مستندات API SMS

# SMS انبوه شخصی‌سازی‌شده curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # پاسخ {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # رویداد تحویل (Webhook، امضا شده با HMAC) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}

چه چیزهایی هست

ویژگی‌ها

ارسال با یک درخواست

عملیات send: یک شماره، فهرست یا متن‌های متفاوت شخصی‌سازی‌شده؛ جایگزین‌ها از فیلدهای گیرنده پر می‌شود.

گزارش تحویل

با status وضعیت هر پیام را با شماره ارسال یا مرجع خودتان (custom_ref) پرس‌وجو کنید.

Webhook امضاشده

رویدادهای تحویل، SMS ورودی و انصراف با X-Buluthat-Signature (HMAC-SHA256) امضا و به نشانی شما ارسال می‌شود؛ در صورت ناموفق بودن با عقب‌نشینی دوباره تلاش می‌شود.

پرس‌وجوی اعتبار و سرشناسه

با balance اعتبار SMS / OTP باقی‌مانده و تاریخ انقضا، با headers سرشناسه‌های تأییدشده شما.

ارسال برنامه‌ریزی‌شده و لغو

با send_at تا 90 روز بعد؛ با cancel پیام‌های ارسال‌نشده لغو و اعتبار بازگردانده می‌شود.

لیست سیاه

با blacklist_add / blacklist_remove فهرست انصراف خودتان را همگام کنید.

نقاط OTP

با otp_send، otp_verify و otp_status کد تأیید را بدون نگه داشتن جدول جداگانه مدیریت کنید.

İYS و تنظیم سرعت

با is_commercial پیام تجاری از کنترل İYS می‌گذرد؛ با rate_per_minute تعداد ارسال در دقیقه را محدود می‌کنید.

درخواست

ارسال SMS را در 4 گام شروع کنید

مدارکتان را از پنل بارگذاری می‌کنید؛ تأیید سرشناسه را ما پیگیری می‌کنیم.

درخواست بدهید

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

مدارک را بارگذاری کنید

اطلاعات شرکت، برگ مالیاتی، هویت مدیر، امضاهای مجاز و تعهدنامه را از پنل ارسال کنید.

تأیید سرشناسه

اگر مدارک کامل باشد سرشناسه SMS شما (3-11 نویسه) ظرف 1-3 روز کاری تأیید می‌شود.

ارسال کنید

از پنل با Excel یا دفترچه تلفن ارسال انبوه کنید یا با API SMS به نرم‌افزارتان وصل کنید.

همین حالا درخواست دهید قیمت SMS

پرسش‌های متداول

درباره API SMS

در صفحه API SMS در بخش توسعه‌دهندگان؛ با نمونه درخواست، پاسخ و کدهای خطا.

در پنل از صفحه SMS انبوه > API و تنظیمات می‌سازید؛ نشانی Webhook را هم از همان صفحه وارد می‌کنید.

شماره تکراری در همان درخواست یک‌بار ارسال می‌شود؛ اگر حفاظت از تکرار فعال باشد همان متن به همان شماره در همان روز دوباره ارسال نمی‌شود.

SMS

با هم قوی‌تر

SMS انبوه، کد تأیید، SMS ورودی و API — با سرشناسه تأییدشده شما.