| Method | update.group_employees_numbers |
|---|---|
| Description | Changing the priority and availability of an employee number in an employee group |
| Available to | Agent, Client |
If the number is not transmitted in the list of numbers, then the data on the number is not updated.
Request parameters
| Name | Type | Required | Description | |
|---|---|---|---|---|
access_token |
string | yes | Authentication session key | |
id |
number | yes | Unique group identifier | |
user_id |
number | no | Unique user identifier of the agent client on behalf of which the request is made Is required for the agentTo obtain a list of client users, you must use the method "get.customer_users" |
|
| List of employee numbers in the group and their availability | ||||
phone_numbers |
array | yes |
List of city, mobile and sip numbers of employees who
included in the group, indicating their availability and priority
calling The priority of calling numbers is determined by the position
numbers in the list. Calling a specified list of numbers in a group
possible by internal group number (see parameter
"group_phone_number").
All numbers must be transmitted |
|
employee_phone_number_id |
number | yes | Unique identifier of the employee number in the group | |
available |
boolean | yes | Number availability in group | |
JSON request structure```json
{ "jsonrpc":"2.0", "id":"number", "method":"update.group_employees_numbers", "params":{ "access_token":"string", "id":"number", "user_id":"number", "phone_numbers":[ { "employee_phone_number_id":"number", "available":"boolean" } ] } }
### JSON response structure```json
{
"jsonrpc":"2.0",
"id":"number",
"result":{
}
}
List of returned errors
| Error text | Mnemonics | Code | Description |
|---|---|---|---|
| Invalid parameter value | invalid_parameter_value |
-32602 | If not all numbers in the phone_numbers array are transmitted |
See the section "List of errors for methods with the update verb"