列

列の一覧、列で待機中の通話、列のメンバーを管理します。APIキー（スコープ call; Authorization: Bearer bt_… ヘッダーで、参照： APIセキュリティ), GET。レート制限：キーごとに1分あたり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

レスポンス 200 OK / OK。エラー： Queue_number value null or none, User value null or none 1001 （内線なし）。

変更は即座に反映され、進行中の通話には影響しません。担当者の休憩は、パネルの「休憩管理」または担当者ステータスのエンドポイントをご利用ください。

AI担当者

列に紐づく音声アシスタント（あふれ / アシスタント優先モード）は、APIではなくパネル > 列 > 「AI担当者」カードで設定します。アシスタントは列のメンバーではなく、並行して応対します。参照： 音声アシスタント.