Search Specific Queues
Search specific queues from the queue list.
Request URL
GET {base_url}/{api_path}/queue/search?access_token={access_token}
Request parameters
Parameter | Required | Type | Description |
---|---|---|---|
page | No | Integer | Define which page is displayed. |
page_size | No | Integer | Define how many records per page. |
sort_by | No | String | Define the sorting field. Valid value:
|
order_by | No | String | Define the display order. Valid value:
|
search_value | No | String | Search keyword. |
Response parameters
Parameter | Type | Description |
---|---|---|
errcode | Integer | Returned error code.
Note: You can check the error code and
error message in Error Code and Error Message.
|
errmsg | String | Returned message.
|
total_number | Integer | The total number of searched queues. |
queue_list | Array <Queue_List> | The detailed information of each queue. |
- Queue_List
-
Parameter Type Description id Integer The unique ID of the queue. number String Queue number. name String Queue name. ring_strategy String The ring strategy of the queue. ring_all
: Ring all available agents simultaneously until someone answers.least_recent
: Ring the available agent that was least recently called.fewest_calls
: Ring the available agent with the fewest completed calls.random
: Ring the agents randomly.rrmemory
: Round robin with memory.linear
: Ring the available agent in specific order based on the type of agents in the queue.
dynamic_agent_list Array <Dynamic_Agent_List> Information of dynamic agents. static_agent_list Array <Static_Agent_List> Information of static agents. manager_list Array <Manager_List> Information of queue managers.
- Dynamic_Agent_List
-
Parameter Type Description text String The name of the dynamic agent. text2 String The extension number of the dynamic agent. value String The extension ID of the dynamic agent. type String The type of the dynamic agent. extension
- Static_Agent_List
-
Parameter Type Description text String The name of the static agent. text2 String The extension number of the static agent. value String The extension ID of the static agent. type String The type of the static agent. extension
- Manager_List
-
Parameter Type Description text String The name of the queue manager. text2 String The extension number of the queue manager. value String The extension ID of the queue manager. type String The type of the queue manager. extension
Examples
Request example
Search for the queue with the number "6402".
GET /openapi/v1.0/queue/search?access_token=6lqF0qYlAOjWxa64DalBZwJ7mynMRKeD&search_value=6402 HTTP/1.1
Host: yeastardocs.example.yeastarcloud.com
HTTP/1.1 200 OK
{
"errcode": 0,
"errmsg": "SUCCESS",
"total_number": 1,
"queue_list": [
{
"id": 3,
"number": "6402",
"name": "Tech-support",
"ring_strategy": "ring_all",
"dynamic_agent_list": [
{
"text": "Leo Ball",
"text2": "1000",
"value": "73",
"type": "extension"
},
{
"text": "Phillip Huff",
"text2": "1001",
"value": "85",
"type": "extension"
}
],
"static_agent_list": [
{
"text": "Madison Cooper",
"text2": "1004",
"value": "96",
"type": "extension"
},
{
"text": "Kevin Connor",
"text2": "1005",
"value": "97",
"type": "extension"
},
{
"text": "Kristin Hale",
"text2": "1006",
"value": "92",
"type": "extension"
}
],
"manager_list": [
{
"text": "Leo Ball",
"text2": "1000",
"value": "73",
"type": "extension"
}
]
}
]
}