Queues API

Attributes

Name	Type	Description	Required
id	String	Queue ID.	N
name	String	Queue name.	Y
description	String	Queue description.	N
channel	String	A name of the channel this queue belongs to.	Y
phoneNumber	String	Phone number this queue is assigned to.	Y*
internal	Boolean	A flag showing if this queue is an internal queue or it has an external phone number assigned.	Y*

*Note: external phone number can be only assigned to external queues, i.e. if you specify "phoneNumber" attribute when creating a queue, it is not allowed to set "internal" flag to "true". Conversely, if you set "internal" flag to "true", you are not allowed to set "phoneNumber" attribute - queue number will be generated automatically in the following format: "0XXXX", where XXXX is any number from 4000 to 9999.

Subresouces

Attribute	Type	Description
settings	Object	Settings object for this queue.
routingTemplate	Object	The entire routing template object this queue is associated with.

Operations

List

This operation retrieves all available queues for a contact center.

Method

GET

Request mapping

.../api/v2/queues?fields={fields}&[resolveUris={resolveUris}]

Permissions

Contact Center Admin

Request parameters

Name	Required	Description
fields	Y	A comma-separated collection of object fields (or a "*" for all fields) we want to get.
resolveUris	N	A comma-separated collection of object URIs (or a "*" for all URI's) to be resolved.

Example

Request:

GET .../api/v2/queues?fields=*

Response:

{
	"statusCode":0,
	"queues":[{
		"id":"...",
		"name":"...",
		"channel":"voice",
		...
	},{
		"id":"...",
		"name":"...",
		"channel":"voice",
		...
	},{

	...

	{
		"id":"...",
		"name":"...",
		"channel":"voice",
		...
	}]
}

List URI's

This operation retrieves URI's for all available queues for a contact center.

Method

GET

Request mapping

.../api/v2/queues

Permissions

Contact Center Admin

Example

Request:

GET .../api/v2/queues

Response:

{
	"statusCode":0,
	"uris":[
		"http://.../api/v2/queues/<queue1_id>",
		...
		"http://.../api/v2/queues/<queueN_id>"
	]
}

Read

Reads an existing queue from the current contact center.

Method

GET

Request mapping

.../api/v2/queues/{id}?[fields={fields}]&[resolveUris={resolveUris}]

Permissions

Contact Center Admin

Request parameters

Name	Required	Description
id	Y	An ID of the queue we are interested in.
fields	N	A comma-separated collection of object fields (or a "*" for all fields) we want to get.
resolveUris	N	A comma-separated collection of object URIs (or a "*" for all URI's) to be resolved.

Example

Request:

GET .../api/v2/queues/<queue_id>?resolveUris=true

Response:

{
	"statusCode":0,
	"queue":{
		"id":"...",
		"name":"...",
		"description":"...",
		"channel":"voice",
		"internal":true,
		"phoneNumberDetails": {...},
		"phoneNumber":"03445"
	}
}