# 遍历呼叫中心

## 接口描述

按照一定条件遍历当前账号（AccessKey 所属公司）的呼叫中心列表。

呼叫中心负责坐席调度，设备来电按呼叫策略分配给空闲坐席。列表按公司维度返回，包含公司级（默认分组）与各对讲分组下的呼叫中心；可通过 `wheres` 的 `voip_group_id` 筛选指定对讲分组下的呼叫中心（`0` 筛选公司级默认分组）。

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

### PATH参数

无

### URL参数
| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| page | int | 否 | 页码，默认 1 |
| size | int | 否 | 每页条数，默认 10000 |
| wheres | string | 否 | 参见[WHERES参数](/WHERES参数.md) |
| accesskey_id | string | 是 | 参见[签名认证](/签名认证.md) |
| expires | int | 是 | 参见[签名认证](/签名认证.md) |
| signature | string | 是 | 参见[签名认证](/签名认证.md) |

*wheres允许填入的k：*

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | int | 呼叫中心ID |
| enable | int | 启用状态（0:启用 / 1:停用） |
| dial_id | string | 中心号码 |
| name | string | 呼叫中心名称 |
| voip_group_id | int | 所属对讲分组ID |

### 请求示例

```
GET https://open.vzicloud.com/openapi/v1/voip/call_centers?page=1&size=10&accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
```

## 返回说明


### 返回参数
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| page | int | 当前页码 |
| size | int | 当前分页大小 |
| total | int | 符合条件的呼叫中心总数 |
| items | array | 呼叫中心列表 |
| items[].id | int | 呼叫中心ID |
| items[].dial_id | string | 中心号码（设备呼叫此号码即进入排队） |
| items[].name | string | 呼叫中心名称 |
| items[].strategy | string | 呼叫策略，取值参见[创建呼叫中心](/voip/创建呼叫中心.md) |
| items[].enable | int | 启用状态（0:启用 / 1:停用） |
| items[].max_wait_time | int | 最大排队时间（秒） |
| items[].agent_ids | array | 成员坐席ID列表 |
| items[].voip_group_id | int | 所属对讲分组ID；`0` = 公司级默认分组（与修改接口的 `voip_group_id` 取值一致） |
| items[].voip_group_name | string | 所属对讲分组名称；公司级默认分组时为 `-` |

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

### 返回示例


```json
{
  "page": 1,
  "size": 10,
  "total": 1,
  "items": [
    {
      "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"
    }
  ]
}
```