Getting a list of virtual number groups
Method | get.virtual_number_groups |
---|---|
Description | Getting a list of virtual number groups |
Who has access | Agent, Customer |
Parameters of a request
Title | Type | Required | Description |
---|---|---|---|
access_token |
string | yes | Authentication session key |
user_id |
number | no | Unique ID of an agent's customer user who makes request Is required for agentTo access a list of customer users, use the method "get.customer_users" |
limit |
number | no | Returning entries count. Refer to "Paging" |
offset |
number | no | Offset that defines from which number to return the entries "limit" . Default value is "0". Refer to "Paging" |
filter |
object | no | Refer to "Filters" |
fields |
array | no | Refer to "Viewing returning data" |
sort |
array | no | Refer to "Data sorting" |
Parameters of a reply
Title | Type | Valid values | Filtering | Sorting | Description |
---|---|---|---|---|---|
id |
number | yes | yes | Virtual number group unique ID | |
name |
string | yes | yes | Virtual number group name | |
number |
string | yes | yes | Virtual number group unique identifier (number): g1,g2,g3,... |
|
Employees | |||||
employees |
array | ||||
id |
number | Employee ID See method get.employees |
|||
full_name |
string | Employee full name | |||
Employee groups | |||||
employee_groups |
array | ||||
id |
number | Group ID See method get.group_employees |
|||
name |
string | Group name | |||
Virtual phones | |||||
virtual_phones |
array | ||||
id |
number | Virtual phone ID. See method get.virtual_numbers |
|||
number |
string | Virtual phone number |
JSON request structure
{
"jsonrpc":"2.0",
"id":"number",
"method":"get.virtual_number_groups",
"params":{
"access_token":"string",
"user_id":"number",
"offset":"number",
"limit":"number",
"filter":{
},
"sort":[
{
"field":"string",
"order":"string"
}
],
"fields":[
"string"
]
}
}
JSON reply structure
{
"jsonrpc": "2.0",
"id": "number",
"result": {
"metadata": {
},
"data": [
{
"id": "number",
"name": "string",
"number": "string",
"employees": [
{
"id": "number",
"full_name": "string"
}
],
"virtual_phones": [
{
"id": "number",
"number": "string"
}
],
"employee_groups": [
{
"id": "number",
"name": "string"
}
]
}
]
}
}
List of returning errors
Refer to the section "List of errors for the methods with the verb get"