SMS · SMS API

SMS API: رسالة SMS من برنامجكم بطلب واحد.

أرسلوا SMS من CRM أو ERP أو منصة التجارة الإلكترونية أو تطبيقكم، واستعلموا عن حالة التسليم، وتلقّوا الرسائل الواردة وإشعارات الرفض. REST وJSON؛ المصادقة بمفتاح Bearer، والأحداث عبر Webhook موقّع بـ HMAC.

قدّموا طلبكم الآن توثيق SMS API

# رسائل 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 أو الدليل، أو اربطوا برنامجكم بـ SMS API.

قدّموا طلبكم الآن أسعار SMS

الأسئلة الشائعة

حول SMS API

في صفحة SMS API ضمن قسم المطورين؛ مع أمثلة للطلبات والردود ورموز الأخطاء.

تنشئونه في اللوحة من شاشة SMS الجماعي > API والإعدادات؛ وتدخلون عنوان Webhook من الشاشة نفسها.

يُرسَل الرقم المكرر في الطلب نفسه مرة واحدة؛ وإن كانت حماية التكرار مفعّلة فلا تُرسَل الرسالة نفسها إلى الرقم نفسه مرة ثانية في اليوم نفسه.

SMS

أقوى معًا

SMS الجماعي ورمز التحقق وSMS الوارد وAPI — بعنوانكم المعتمد.