الطوابير

أدِيروا قائمة الطوابير والمكالمات المنتظرة في الطابور وعضويات الطوابير. مفتاح API (النطاق call; Authorization: Bearer bt_… في الترويسة، انظروا أمان API), GET. الحد الأقصى للطلبات: 120 طلبًا في الدقيقة لكل مفتاح.

GETقائمة الطوابير

GET https://api.buluthat.com/api/queues.php
[
  { "number": 200, "name": "Satış" },
  { "number": 201, "name": "Teknik Destek" }
]

number هو رقم الطابور في السنترال ("رقم الطابور" في اللوحة)؛ وفي نقاط النهاية الأخرى queue_number يُستخدم كـ.

GETالمنتظرون في الطابور

GET https://api.buluthat.com/api/queues_pending.php
[
  {
    "queue_number": "200",
    "uuid": "a7713781-…",
    "call_uuid": "f776683e-1bde-4b58-bc43-128b99497bd9",
    "caller_id": "905320000000",
    "joined_at": "1758182219"
  }
]

joined_at هو طابع زمني Unix. لتوصيل مكالمة منتظرة مباشرة بموظف call_uuid مع نقل المكالمة متاح.

GETالأرقام الداخلية في الطابور

GET https://api.buluthat.com/api/queue_user_list.php?queue_number=200
[{ "user": 1000, "name": "Ayşe Kara" }, { "user": 1001, "name": "Mert Aydın" }]

GETإضافة رقم داخلي إلى الطابور / إزالته / ترتيبه

قائمة أعضاء الطابور بالكامل يستبدلها بالقائمة التي تعطونها؛ والترتيب هو ترتيب الرنين.

GET https://api.buluthat.com/api/queue_manage_users.php?queue_number=200&user_list=1000,1001,1002
المعلمةالوصف
queue_numberرقم الطابور
user_listالأرقام الداخلية مفصولة بفواصل؛ والقائمة الفارغة تُفرغ الطابور

الرد 200 OK / OK. الأخطاء: Queue_number value null or none, User value null or none 1001 (لا يوجد رقم داخلي).

يُطبَّق التغيير فورًا؛ ولا تتأثر المكالمات الجارية. لاستراحات الموظفين استخدموا "إدارة الاستراحات" في اللوحة أو نقطة نهاية حالة الموظف.

موظف الذكاء الاصطناعي

المساعد الصوتي المرتبط بالطابور (وضع الفيض / المساعد أولًا) لا يُضبط عبر API بل من بطاقة "موظف الذكاء الاصطناعي" في اللوحة > الطوابير؛ والمساعد ليس عضوًا في الطابور بل يتحدث بالتوازي. انظروا المساعد الصوتي.