# 外呼活动ACD检测设置
#### 场景描述
此接口可以设置外呼活动ACD检测相关参数。
#### 使用说明
无。
#### 接口方法
该接口支持POST方法。
#### 接口URL
https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/acd/update
其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。
表1URL中携带的参数说明 
| 序号 | 参数名   | 参数类型 | 是否必选 | 说明                                                                                                           |
|:---|:---|:---|:---|:---|
| 1  | vdnId | int  | True | 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。 |
   
#### 请求说明
表2请求消息体参数说明 
| 序号 | 参数名      | 参数类型  | 是否必选 | 说明                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | taskList | Array | True | 待修改活动列表，具体见[表4 taskList参数说明] |
   
 表3taskList参数说明 
| 序号 | 参数名                  | 参数类型   | 是否必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|:---|
| 1  | taskId               | String | True | 外呼活动id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 2  | detectResProMode     | int    | True | 非人工应答处理方式 0：释放 1：接通                                                                                                                                                                                                                                                                                                                              |
| 3  | detectTimeOutProMode | int    | True | 等待超时处理方式 0：释放 1：接通                                                                                                                                                                                                                                                                                                                                |
| 4  | toneDetect           | String | True | ACD检测方式 0：不开启 1：接通前检测 2：接通前后都检测 说明： toneDetect不开启时，detectResProMode、detectTimeOutProMode、waitDetectResTime不是必选。 |
| 5  | waitDetectResTime    | int    | True | 等待检测时长，单位秒。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
#### 响应说明
表4消息体参数说明 
| 序号 | 参数名        | 参数类型   | 说明                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| 1  | resultCode | String | 原因码。0200000表示成功，其他表示失败。 具体见下[表5]       |
| 2  | resultDesc | String | 描述。                                                                                                                                                                                                  |
| 3  | returnCode | String | 原因码。0200000表示成功，其他表示失败。 具体见[表5 错误原因码说明]。 |
| 4  | returnDesc | String | 描述。                                                                                                                                                                                                  |
   
#### 错误结果码
 表5错误原因码说明 
| 序号 | 错误码      | 说明                       |
|:---|:---|:---|
| 1  | 0200001  | 参数异常，异常详情在resultDesc中描述。 |
| 2  | 02000001 | 参数值为空                    |
| 3  | 02000002 | 参数包含非法字符                 |
| 4  | 02000007 | 参数值大小不正确                 |
| 5  | 02000013 | 未启用任务级ACD检测              |
   
#### 报文样例
- 该接口的请求消息体举例如下：
  ```
  {
      "taskList": [
          {
              "taskId": "1504171899",
              "detectResProMode": 1,
              "detectTimeOutProMode": 0,
              "toneDetect": "2",
              "waitDetectResTime": 3
          },
          {
              "taskId": "1306407658",
              "detectResProMode": 1,
              "detectTimeOutProMode": 1,
              "toneDetect": "2",
              "waitDetectResTime": 1
          }
      ]
  }
  ```
  
- 该接口的响应消息体举例如下：
  ```
  {
  "returnCode": "0200000",
  "resultCode": "0200000",
  "resultDesc": "update success",
  "returnDesc": "update success"
  }
  ```