# 更新预约呼叫结果
#### 前置条件
- 已经申请了开发者账号。
 
#### 场景描述
通过该接口更新预约外呼任务。
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
自动预约外呼会自动更新预约呼叫结果，不需要调用该接口进行更新。
#### 接口方法
该接口仅支持POST方法。
#### 接口URL
https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/appoint/updateResult
其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。
表1URL中携带的参数说明 
| 序号 | 参数名   | 参数类型 | 是否必选 | 说明                                                                                                                                      |
|:---|:---|:---|:---|:---|
| 1  | vdnId | int  | True | 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。 |
   
#### 请求说明
表2请求消息头参数 
| 序号 | 名称            | 参数类型   | 是否必选 | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|
| 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)。 |
   
表3请求消息体参数说明 
| 序号 | 参数名           | 参数类型      | 是否必选  | 说明                                        |
|:---|:---|:---|:---|:---|
| 1  | appointId     | String    | True  | 预约id                                      |
| 2  | userAccount   | String    | False | 非op独立部署填写，需要设置的座席业务帐号。只支持预约手动外呼。          |
| 3  | workNo        | String    | False | op独立部署填写，需要设置的座席工号。只支持预约手动外呼。             |
| 4  | callerNo      | String    | False | 主叫号码。                                     |
| 5  | failCode      | String    | False | 失败的原因码。来源于CTI平台，结果码00000为呼叫成功，其他结果码为呼叫失败。 |
| 6  | callId        | String    | False | 通话记录ID，用于与CTI平台的话单等通话数据关联。                |
| 7  | busiResult    | String    | False | 业务结果id                                    |
| 8  | busiSubStatus | String    | False | 子业务结果id                                   |
| 9  | beginTime     | TimeStamp | False | 呼叫开始时间，使用UTC时间。                           |
| 10 | endTime       | TimeStamp | False | 呼叫结束时间，使用UTC时间。                           |
   
#### 响应说明
表4消息体参数说明 
| 序号 | 参数名        | 参数类型   | 说明                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| 1  | resultCode | String | 原因码。0200000表示成功，其他表示失败。 具体见[表5]。 |
| 2  | resultDesc | String | 描述。                                                                                                                                                                                                                                                    |
| 3  | returnCode | String | 原因码。0200000表示成功，其他表示失败。 具体见[表5]。 |
| 4  | returnDesc | String | 描述。                                                                                                                                                                                                                                                    |
   
#### 触发事件
无
#### 错误结果码
 表5错误原因码说明 
| 序号 | 错误码      | 说明                       |
|:---|:---|:---|
| 1  | 0200001  | 参数异常，异常详情在resultDesc中描述。 |
| 2  | 0200006  | 数据库操作异常。                 |
| 3  | 02000001 | 参数值为空                    |
| 4  | 02000002 | 参数包含非法字符                 |
| 5  | 02000003 | 参数长度不能大于规定长度             |
| 6  | 04000004 | 预约活动不存在                  |
   
#### 报文样例
- 该接口的请求消息体举例如下：
  ```
  {
      "appointId": "174738152455111432454674595509",
      "failCode": "00000",
      "callId" :"1747316188-341779",
      "busiResult":"17549503",
      "busiSubStatus":"17124429",
      "beginTime": 1747220297000,
      "endTime":1747220365000
  }
  ```
  
- 该接口的响应消息体举例如下：
  ```
  {
      "returnCode": "0200000",
      "resultCode": "0200000",
      "resultDesc": "update success",
      "returnDesc": "update success"
  }
  ```