Queues

Manage the queue list, calls waiting in the queue and queue memberships. API key (scope call; Authorization: Bearer bt_… in the header, see API Security), GET. Rate limit: 120 requests per minute per key.

GETQueue list

GET https://api.buluthat.com/api/queues.php

[
  { "number": 200, "name": "Satış" },
  { "number": 201, "name": "Teknik Destek" }
]

number is the PBX number of the queue ("queue number" in the panel); in other endpoints queue_number is used as.

GETWaiting in the queue

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 It is a Unix timestamp. To connect a waiting call directly to an agent call_uuid with Transfer call is available.

GETExtensions in the queue

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" }]

GETAdd / remove / order extensions in the queue

The queue's member list entirely replaces with the list you give; the order is the ring order.

GET https://api.buluthat.com/api/queue_manage_users.php?queue_number=200&user_list=1000,1001,1002

Response 200 OK / OK. Errors: Queue_number value null or none, User value null or none 1001 (no extension).

The change is applied instantly; ongoing calls are not affected. For agent breaks use the panel's "Break Management" or the agent status endpoint.

AI agent

The voice assistant tied to the queue (overflow / assistant-first mode) is set not via API but in the panel > Queues > "AI Agent" card; the assistant is not a queue member and handles calls in parallel. See Voice Assistant.