# 查询租户下外呼任务列表接口
#### 场景描述
查询租户下外呼任务列表接口，返回任务信息。
注意：该接口需要配套部署isales服务模块。
#### 接口方法
设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。
#### 请求URL
https://ip:port/rest/cmsapp/v1/openapi/fromisales/querytasks
其中，公有云环境请联系管理员获取，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消息体参数说明 
| 参数名           | 数据类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| ccId          | int    | False | 呼叫中心编号，取值范围：1～65535 - 集成环境，默认值为系统管理员登录AICC系统后，通过"配置中心 \> 系统管理 \> CMS系统配置"查看的呼叫中心编号。若该配置为空，取值数据库t_cms_sysparam表中的sys_key="default_cc_id",sys_type="cms_system_config"对应的数据。  - 独立部署环境，默认值为系统管理员登录AICC系统后，通过"配置中心 \> 系统管理 \> 参数配置"查看"默认呼叫中心标识"的值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| vdn           | int    | True  | 虚拟呼叫中心编号。取值范围：1～5000                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| limit         | int    | False | 分页大小。不选默认10，最大查询100条                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| offset        | int    | False | 分页起始位。不选默认0                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| statusVersion | string | False | 任务状态版本。控制接口返回的任务状态取值范围。 - 当statusVersion的值为V1或者不传时，接口返回的任务状态字段为：   1：草稿 2：执行中、呼叫完成、未开始 3：暂停 4：已过期 当statusVersion的值为V2时，接口返回的任务状态字段为： 1：草稿 2：执行中 3：暂停 4：已过期 7：呼叫完成 8：未开始 |
   
#### 响应消息
表3消息体参数说明 
| 参数名        | 数据类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| resultCode | string | 查询结果。取值如下： - "0100000"：成功  - 其他：失败   失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 |
| resultDesc | array  | 查询成功后，返回结果信息的对象数组。 响应消息体参数请参考[表4]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   
 表4响应消息体参数说明 
| 参数名   | 数据类型      | 说明    |
|:---|:---|:---|
| count | int       | 任务总数。 |
| tasks | JSONArray | 任务列表。 |
   
tasks对象参数说明请参考[表5]
 表5tasks对象参数说明 
| 参数名       | 数据类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| taskId    | String | 任务Id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| taskName  | String | 任务名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| taskType  | String | 任务类型。 1：智能外呼 2：预测外呼 3：自动外呼 4：人工外呼 5：预览外呼                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| beginDate | String | 开始时间，CC-iSales前台用户写入的时间，值为时间戳。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| endDate   | String | 结束时间，CC-iSales前台用户写入的时间，值为时间戳。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| status    | String | 任务状态。 - 当参数statusVersion的值为V1或者不传时，接口返回的任务状态字段为：   1：草稿 2：执行中、呼叫完成、未开始 3：暂停 4：已过期 - 当参数statusVersion的值为V2时，接口返回的任务状态字段为：   1：草稿 2：执行中 3：暂停 4：已过期 7：呼叫完成 8：未开始 |
   
#### 样例报文
- 请求头：
  ```
  Content-Type: application/json;charset=UTF-8
  Authorization: ******************
  ```
  
- 请求参数：
  ```
  {
      "ccId": "1",
      "vdn":34,
      "limit":10,
      "offset":0
  }
  ```
  
- 响应参数：
  ```
  {
      "resultCode": "0100000",
      "resultDesc": {
          "count": 14,
          "tasks": [
              {
                  "beginDate": "1735357466000",
                  "taskType": "4",
                  "endDate": "1735443866000",
                  "taskName": "1",
                  "taskId": "1088825198",
                  "status": "1"
              },
              {
                  "beginDate": "1734629077000",
                  "taskType": "4",
                  "endDate": "1734715477000",
                  "taskName": "2",
                  "taskId": "1312452402",
                  "status": "1"
              }
  .......
          ]
      }
  }
  ```