صف‌ها

فهرست صف، تماس‌های منتظر در صف و عضویت صف را مدیریت کنید. کلید 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 مهر زمانی یونیکس است. برای وصل کردن یک تماس منتظر مستقیماً به یک نماینده 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

پاسخ 200 OK / OK. خطاها: Queue_number value null or none, User value null or none 1001 (بدون داخلی).

تغییر بلافاصله اعمال می‌شود؛ تماس‌های جاری متأثر نمی‌شوند. برای استراحت نمایندگان از «مدیریت استراحت» پنل یا نقطه وضعیت نماینده استفاده کنید.

نماینده هوش مصنوعی

دستیار صوتی متصل به صف (حالت سرریز / ابتدا-دستیار) با API نیست، از پنل > صف‌ها > کارت «نماینده هوش مصنوعی» تنظیم می‌شود؛ دستیار عضو صف نیست، موازی گفتگو می‌کند. رجوع شود به دستیار صوتی.