# 修改坐席分机

## 接口描述

修改坐席分机的基本信息与坐席参数。所有字段均可选，只更新传入的字段。

> 更换所属对讲分组已合并到本接口：传入 `voip_group_id` 参数即可（关联处理规则见请求参数说明）。

## 请求说明
| 接口ID | 协议 | 方法 | PATH |
| --- | --- | --- | --- |
| 102 | HTTPS | PUT | /openapi/v1/voip/agents/:id |

### PATH参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| id | int | 是 | 需要修改的坐席分机ID，可通过[遍历坐席分机](/voip/遍历坐席分机.md)获取 |

### URL参数
| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| accesskey_id | string | 是 | 参见[签名认证](/签名认证.md) |
| expires | int | 是 | 参见[签名认证](/签名认证.md) |
| signature | string | 是 | 参见[签名认证](/签名认证.md) |

### HTTP请求头
| 名称 | 必填 | 说明 |
| --- | --- | --- |
| Content-Type | 是 | `application/json` |

### 请求参数

请求参数以Json格式放置于Body中，如下：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| dial_id | string | 否 | 分机号，5-20 位，只能包含字母、数字及 `_.-`；修改后坐席需用新分机号重新登录 |
| password | string | 否 | 分机密码；修改后坐席需用新密码重新登录/注册 |
| display_name | string | 否 | 坐席显示名称 |
| remark | string | 否 | 备注 |
| voip_group_id | int | 否 | 更换对讲分组：不传=不变，`0`=默认分组（公司级），正整数=目标分组ID（**不接受 `null`**，公司级一律用 `0`；遍历/创建响应的 `voip_group_id` 已统一输出 `0`，可直接作为本参数回传）。传入值与当前分组一致时无任何变更（幂等）。更换分组时在线坐席会被强制下线，需重新登录。**关联自动解除**：坐席所在的其他分组呼叫中心会自动移出该坐席；其他分组设备上指向该坐席的默认呼叫号码会被自动清空（设备 SIP 配置自动重新下发）；已在目标分组内的关联不受影响 |
| enable | int | 否 | 启用状态（0:启用 / 1:停用） |
| agent_call_timeout | int | 否 | 坐席振铃时长（秒） |
| agent_wrap_up_time | int | 否 | 通话完毕后，再次接收呼叫的间隔（秒） |
| agent_reject_delay_time | int | 否 | 坐席拒绝后，再次接听呼叫的间隔（秒） |
| agent_busy_delay_time | int | 否 | 坐席忙时，再次接听呼叫的间隔（秒） |
| agent_no_answer_delay_time | int | 否 | 坐席无应答时，再次接听呼叫的间隔（秒） |

> Body 中所有字段均未传入时不做任何修改，直接返回成功。

### 请求示例

```
PUT https://open.vzicloud.com/openapi/v1/voip/agents/501?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json

{
  "display_name": "客服-张三丰",
  "agent_call_timeout": 30
}
```

## 返回说明

成功，则响应的HTTP状态码为200  
失败，则响应的HTTP状态码为非200，具体参考[错误码](/错误码.md)