مركز المطورين

اجعلوا سنترالكم جزءًا من برنامجكم.

مفتاح API واحد، وHTTP عادي، وردود JSON. كل شيء REST من النقر للاتصال والتحكم بالمكالمات إلى حملات الاتصال الآلي ومهام المساعد الصوتي ورمز التحقق الصوتي؛ وتعود النتائج عبر Webhook موقّع بـ HMAC.

بداية سريعة

طلبكم الأول في 2 دقائق

احصلوا على مفتاحكم من تبويب API في اللوحة > الاتصال الآلي (أو من إعدادات السنترال)؛ وأرسلوه بترويسة Bearer أو X-Api-Key أو ?key=.

  • المفتاح مرتبط بحساب عميلكم؛ ولا يمكنه الوصول إلى بيانات عميل آخر.
  • عمليات القراءة GET، والعمليات التي تغيّر البيانات POST؛ والمحتوى JSON أو form.
  • رد الخطأ دائمًا {"ok":false,"error":"…","code":"…"} هي بالصيغة.
  • حد المعدل: 120 طلبًا في الدقيقة لكل مفتاح؛ وعند التجاوز 429.
# النقر للاتصال: يرن الرقم الداخلي 1001 أولًا، وعند الرد يُتصل بالوجهة curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # إنشاء حملة curl -X POST "https://api.buluthat.com/api/autocall.php?action=create_campaign" \ -H "Authorization: Bearer bt_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"name":"Ödeme hatırlatma","campaign_type":"ivr", "tts_template":"Merhaba {sayin}, {tutar} tutarındaki ödemeniz…", "digit_labels":{"1":"Ödedim","2":"Yetkili"}}' # إرسال رمز تحقق صوتي curl -X POST "https://api.buluthat.com/api/voice_otp.php?action=send" \ -H "X-Api-Key: bt_xxxxxxxx" -d "phone=905321234567" → {"ok":true,"id":8812,"code":"472915","expires_in":300}
التوثيق

ترويسات API

في كل عنوان: عنوان نقطة النهاية والمعلمات ومثال للطلب والرد.

نظرة عامة

المصادقة وصيغة الطلب ورموز الأخطاء وحدود المعدل

قراءة
أمان API

المفاتيح والنطاقات وعناوين IP المسموحة وتوقيع الطلبات بـ HMAC وتجديد المفتاح وسجل الطلبات

قراءة
إدارة المكالمات

النقر للاتصال والإنهاء والنقل وكتم الصوت

قراءة
الطوابير

قائمة الطوابير والمنتظرون وإضافة/إزالة الأعضاء

قراءة
حالات الموظفين

حالات الأرقام الداخلية وعضويات الطوابير

قراءة
القائمة السوداء

عرض الأرقام المحظورة وإضافتها وحذفها

قراءة
الملفات الصوتية

قائمة المقاطع الصوتية والرفع والتحديث والحذف

قراءة
الاتصال الآلي

إنشاء الحملات وإضافة الأرقام والحصول على النتائج وWebhook

قراءة
المساعد الصوتي

المحادثات والملاحظات والمواعيد ومهام الاتصال والتضمين

قراءة
التحقق الصوتي (OTP)

إرسال الرمز والتحقق والحالة وWebhook

قراءة
SMS API

SMS الجماعي / المخصص، OTP SMS، تقرير التسليم، SMS الوارد، القائمة السوداء

قراءة
Webhook

التحقق من التوقيع وسياسة إعادة المحاولة ومخططات الأحداث

قراءة
تضمين (CRM iframe)

في شاشات المركز وبرنامج الهاتف الويب الخاص بك: الرمز، الرابط الموقّع، أحداث JavaScript

قراءة
Webhook

لتصلكم النتائج دون أن تسألوا.

نتيجة الاتصال الآلي وملخص محادثة المساعد الصوتي وحالة رمز التحقق — يُرسَل كل حدث بصيغة JSON بـ POST إلى عنوانكم؛ وترويسة X-Buluthat-Signature هي توقيع HMAC-SHA256. وتُعاد محاولة التسليم الفاشل بفواصل 1 د ← 6 ساعات.

توثيق Webhook
// PHP: التحقق من التوقيع $raw = file_get_contents('php://input'); $sig = $_SERVER['HTTP_X_BULUTHAT_SIGNATURE'] ?? ''; $calc = hash_hmac('sha256', $raw, $secret); if (!hash_equals($calc, $sig)) { http_response_code(401); exit; } $event = json_decode($raw, true); // $event['event'] = 'call_finished' | 'session_ended' | 'otp_result' …
جسر Byfix CRM

يجد المساعد الصوتي العميل في CRM ويفتح سجل الخدمة ويدوّن الملاحظة؛ وتُبدأ "اتصل بالمساعد" من CRM. جاهز، بمفتاح واحد.

التفاصيل
عميل PHP

فئة PHP جاهزة لرمز التحقق الصوتي؛ بسطرين أرسل/تحقق. أما نقاط النهاية الأخرى فهي HTTP عادية فتُستدعى من أي لغة.

مثال
شاشة مباشرة قابلة للتضمين

النص المباشر لمحادثة المساعد داخل CRM بإطار iframe؛ برمز موقّع محدد المدة، دون حاجة إلى جلسة لوحة.

embed_url