# 创建呼叫中心

## 接口描述

创建一个呼叫中心。设备呼叫中心号码即进入排队，平台按呼叫策略将来电分配给空闲坐席。

中心号码在同一 SIP 域名内全局唯一：不能与已有的呼叫中心、设备分机、坐席分机号码重复。呼叫中心数量受公司配额限制。

通过 `voip_group_id` 指定所属对讲分组；不传或传 `0` 表示公司级默认分组。对讲分组的概念参见[遍历对讲分组](/voip/遍历对讲分组.md)。

## 请求说明
| 接口ID | 协议 | 方法 | PATH |
| --- | --- | --- | --- |
| 109 | HTTPS | POST | /openapi/v1/voip/call_centers |

### PATH参数

无

### 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 | 是 | 呼叫策略，取值见下表 |
| max_wait_time | int | 否 | 最大排队时间（秒），排队超时无人接听则自动中断 |
| agent_ids | array | 否 | 成员坐席ID列表（坐席分机的 `id`，参见[遍历坐席分机](/voip/遍历坐席分机.md)），也可创建后通过[修改呼叫中心](/voip/修改呼叫中心.md)调整。**成员坐席必须与本呼叫中心属于同一对讲分组**（含默认分组），跨分组坐席会被拒绝 |
| remark | string | 否 | 备注 |
| voip_group_id | int | 否 | 所属对讲分组ID；不传或传 `0` 表示公司级默认分组 |

*strategy 可选值：*

| 值 | 说明 |
| --- | --- |
| ring-all | 呼叫所有坐席，全部振铃，先接先通 |
| random | 随机呼叫坐席 |
| round-robin | 循环呼叫坐席（轮询） |
| top-down | 按固定顺序呼叫坐席 |
| longest-idle-agent | 呼叫空闲时间最长的坐席 |
| agent-with-least-talk-time | 呼叫通话时间最短的坐席 |
| agent-with-fewest-calls | 呼叫通话次数最少的坐席 |

> 建议成员坐席与本呼叫中心属于同一对讲分组（跨分组成员无法正常接听本呼叫中心的来电）；后续调整成员时接口会强制校验同分组。

### 请求示例

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

{
  "name": "小区A客服中心",
  "dial_id": "90001",
  "strategy": "longest-idle-agent",
  "max_wait_time": 60,
  "agent_ids": [501, 502],
  "remark": "",
  "voip_group_id": 12
}
```

## 返回说明

### 返回参数
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | int | 呼叫中心ID |
| dial_id | string | 中心号码 |
| name | string | 呼叫中心名称 |
| strategy | string | 呼叫策略 |
| enable | int | 启用状态（0:启用 / 1:停用） |
| max_wait_time | int | 最大排队时间（秒） |
| agent_ids | array | 成员坐席ID列表（无成员时为空数组） |
| voip_group_id | int | 所属对讲分组ID；`0` = 公司级默认分组（与修改接口的 `voip_group_id` 取值一致） |
| voip_group_name | string | 所属对讲分组名称；公司级默认分组时为 `-` |

**注：返回参数里可能还包含其他信息但未在上面的表格内列出，请勿使用！**

### 返回示例


```json
{
  "id": 7,
  "dial_id": "90001",
  "name": "小区A客服中心",
  "strategy": "longest-idle-agent",
  "enable": 0,
  "max_wait_time": 60,
  "agent_ids": [501, 502],
  "voip_group_id": 12,
  "voip_group_name": "小区A"
}
```