# 批量查询所有座席的呼叫信息
#### 场景描述
批量查询所有座席的实时呼叫信息。
#### 接口方法
设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。
#### 内部封装接口
BMS接口：/ccbms/ws/monitor/queryagentCalls
#### 请求URL
https://ip:port/rest/cmsapp/v1/openapi/agentgroup/queryagentcalls
其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。
非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选 | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | Content-Type  | String | True | 固定填 application/json;charset=UTF-8。                                                                                           |
| 2  | Authorization | String | True | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 |
   
表2消息体参数说明 
| 序号 | 名称       | 参数类型  | 是否必选 | 说明                                                                                                                                                    |
|:---|:---|:---|:---|:---|
| 1  | ccId     | int   | True | 呼叫中心编号。 取值范围：1～65535                              |
| 2  | vdn      | int   | True | 虚拟呼叫中心编号。 取值范围：1～5000                              |
| 3  | agentIds | array | True | 座席工号的数组，数组最大长度为3000。 取值范围：101-59999和70000-999999 |
   
#### 响应消息
表3消息体参数说明 
| 序号 | 名称          | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| 1  | result      | String | 查询结果。取值如下： - 0：成功  - 其他：失败   失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 |
| 2  | resultCode  | string | 查询结果。取值如下： - "0100000"：成功  - 其他：失败  - 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。                   |
| 3  | resultDatas | array  | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 4  | resultDesc  | array  | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
 表4resultDesc/resultDatas对象参数说明 
| 序号  | 名称       | 参数类型  | 说明                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| 2.1 | agentId  | int   | 座席工号。                                                                                                                                                                                                                               |
| 2.2 | callList | array | 呼叫信息数组。 该对象的参数说明请参见[表5] |
   
 表5callList对象参数说明 
| 序号    | 名称           | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| 2.2.1 | callId       | string | 呼叫ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 2.2.2 | callStatus   | int    | 呼叫状态，[表6]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 2.2.3 | callInOut    | int    | 呼入与呼出的标记。 0：表示呼入，1：表示呼出                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 2.2.4 | mediaType    | int    | 媒体类型，[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0698.html#ZH-CN_TOPIC_0000002513233715__zh-cn_topic_0000002510109741_zh-cn_topic_0000001843009401_zh-cn_topic_0000001451970565_zh-cn_topic_0240433933_table13565990)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 2.2.5 | submediaType | string | 子媒体类型，取值范围： - -1：表示无子媒体类型。  - 其他子媒体类型请参见[呼叫子媒体类型说明](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0699.html#ZH-CN_TOPIC_0000002481113864)。   |
   
 表6呼叫状态 
| 编号 | 呼叫类型          | 描述          |
|:---|:---|:---|
| 0  | IDLE          | 呼叫对象空闲（无呼叫） |
| 1  | OCCUPY        | 呼叫对象被占用     |
| 2  | QUEUE         | 呼叫在技能队列排队   |
| 3  | PRIVATE_QUEUE | 呼叫在私有队列排队   |
| 4  | ALERTING      | 呼叫振铃等待应答    |
| 5  | TALK          | 呼叫各方在通话或交互中 |
| 6  | HOLD          | 呼叫保持        |
| 7  | SUSPEND       | 呼叫挂起        |
| 8  | MUTE          | 呼叫被静音       |
| 9  | TRITALK       | 三方通话        |
   
#### 样例报文
- 请求头：
  ```
  Content-Type: application/json;charset=UTF-8
  Authorization: ******************
  ```
  
- 请求参数：
  ```
  {
      "ccId":1,
      "vdn":170,
      "agentIds":[1031,1099]
  }
  ```
  

- 响应参数：
  ```
  {
      "result": "0",
      "resultCode": "0100000",
      "resultDatas": [
          {
              "agentId": 1034,
              "callList": []
          },
          {
              "agentId": 1099,
              "callList": [
                  {
                      "callId": "1605494261-1449",
                      "callStatus": 5,
                      "callInOut": 0,
                      "submediaType": "Email",
                      "mediaType": 5
                  }
              ]
          }
      ],
      "resultDesc": [
          {
              "agentId": 1034,
              "callList": []
          },
          {
              "agentId": 1099,
              "callList": [
                  {
                      "callId": "1605494261-1449",
                      "callStatus": 5,
                      "callInOut": 0,
                      "submediaType": "Email",
                      "mediaType": 5
                  }
              ]
          }
      ]
  }
  ```