اجعلوا سنترالكم جزءًا من برنامجكم.
مفتاح API واحد، وHTTP عادي، وردود JSON. كل شيء REST من النقر للاتصال والتحكم بالمكالمات إلى حملات الاتصال الآلي ومهام المساعد الصوتي ورمز التحقق الصوتي؛ وتعود النتائج عبر Webhook موقّع بـ HMAC.
طلبكم الأول في 2 دقائق
احصلوا على مفتاحكم من تبويب API في اللوحة > الاتصال الآلي (أو من إعدادات السنترال)؛ وأرسلوه بترويسة Bearer أو X-Api-Key أو ?key=.
- المفتاح مرتبط بحساب عميلكم؛ ولا يمكنه الوصول إلى بيانات عميل آخر.
- عمليات القراءة GET، والعمليات التي تغيّر البيانات POST؛ والمحتوى JSON أو form.
- رد الخطأ دائمًا
{"ok":false,"error":"…","code":"…"}هي بالصيغة. - حد المعدل: 120 طلبًا في الدقيقة لكل مفتاح؛ وعند التجاوز 429.
ترويسات API
في كل عنوان: عنوان نقطة النهاية والمعلمات ومثال للطلب والرد.
نظرة عامة
المصادقة وصيغة الطلب ورموز الأخطاء وحدود المعدل
قراءةأمان API
المفاتيح والنطاقات وعناوين IP المسموحة وتوقيع الطلبات بـ HMAC وتجديد المفتاح وسجل الطلبات
قراءةإدارة المكالمات
النقر للاتصال والإنهاء والنقل وكتم الصوت
قراءةالطوابير
قائمة الطوابير والمنتظرون وإضافة/إزالة الأعضاء
قراءةحالات الموظفين
حالات الأرقام الداخلية وعضويات الطوابير
قراءةالقائمة السوداء
عرض الأرقام المحظورة وإضافتها وحذفها
قراءةالملفات الصوتية
قائمة المقاطع الصوتية والرفع والتحديث والحذف
قراءةالاتصال الآلي
إنشاء الحملات وإضافة الأرقام والحصول على النتائج وWebhook
قراءةالمساعد الصوتي
المحادثات والملاحظات والمواعيد ومهام الاتصال والتضمين
قراءةالتحقق الصوتي (OTP)
إرسال الرمز والتحقق والحالة وWebhook
قراءةSMS API
SMS الجماعي / المخصص، OTP SMS، تقرير التسليم، SMS الوارد، القائمة السوداء
قراءةWebhook
التحقق من التوقيع وسياسة إعادة المحاولة ومخططات الأحداث
قراءةتضمين (CRM iframe)
في شاشات المركز وبرنامج الهاتف الويب الخاص بك: الرمز، الرابط الموقّع، أحداث JavaScript
قراءةلتصلكم النتائج دون أن تسألوا.
نتيجة الاتصال الآلي وملخص محادثة المساعد الصوتي وحالة رمز التحقق — يُرسَل كل حدث بصيغة JSON بـ POST إلى عنوانكم؛ وترويسة X-Buluthat-Signature هي توقيع HMAC-SHA256. وتُعاد محاولة التسليم الفاشل بفواصل 1 د ← 6 ساعات.
جسر Byfix CRM
يجد المساعد الصوتي العميل في CRM ويفتح سجل الخدمة ويدوّن الملاحظة؛ وتُبدأ "اتصل بالمساعد" من CRM. جاهز، بمفتاح واحد.
التفاصيلعميل PHP
فئة PHP جاهزة لرمز التحقق الصوتي؛ بسطرين أرسل/تحقق. أما نقاط النهاية الأخرى فهي HTTP عادية فتُستدعى من أي لغة.
مثالشاشة مباشرة قابلة للتضمين
النص المباشر لمحادثة المساعد داخل CRM بإطار iframe؛ برمز موقّع محدد المدة، دون حاجة إلى جلسة لوحة.
embed_url