# 修改呼叫中心

## 接口描述

修改呼叫中心的基本信息与成员坐席。所有字段均可选，只更新传入的字段。

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

**成员同分组校验**：传入 `agent_ids` 时，列表中与本呼叫中心不在同一对讲分组的坐席会被拒绝（成员关系是按组校验的，跨分组成员无法正常接听本呼叫中心的来电），错误信息中会列出违规坐席。更换分组的请求不适用此校验，跨组成员会被自动移出（见 `voip_group_id` 参数说明）。

## 请求说明
| 接口ID | 协议 | 方法 | PATH |
| --- | --- | --- | --- |
| 110 | HTTPS | PUT | /openapi/v1/voip/call_centers/: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中，如下：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| name | string | 否 | 呼叫中心名称 |
| dial_id | string | 否 | 中心号码，5-20 位，只能包含字母、数字及 `_.-` |
| strategy | string | 否 | 呼叫策略，取值参见[创建呼叫中心](/voip/创建呼叫中心.md) |
| max_wait_time | int | 否 | 最大排队时间（秒） |
| enable | int | 否 | 启用状态（0:启用 / 1:停用） |
| agent_ids | array | 否 | 成员坐席ID列表；传入时**整体替换**现有成员（传空数组表示清空成员） |
| voip_group_id | int | 否 | 更换对讲分组：不传=不变，`0`=默认分组（公司级），正整数=目标分组ID（**不接受 `null`**，公司级一律用 `0`；遍历/创建响应的 `voip_group_id` 已统一输出 `0`，可直接作为本参数回传）。传入值与当前分组一致时无任何变更（幂等）。**关联自动解除**：不在目标分组内的成员坐席会被自动移出本呼叫中心（目标分组内的成员保留，成员允许为空）；设备上指向本呼叫中心的默认呼叫号码若不在目标分组，会被自动清空（设备 SIP 配置自动重新下发） |

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

### 请求示例

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

{
  "strategy": "ring-all",
  "max_wait_time": 90,
  "agent_ids": [501, 503]
}
```

## 返回说明

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