# 保存客户提交的满意度评价结果 (saveSatisfaction)
#### 场景描述
在用户与座席交谈结束后，若当前渠道开启了满意度评价，调用该接口保存用户对座席的满意度评价结果。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/ccmessaging/saveSatisfaction，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称                | 参数类型   | 是否必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|:---|
| 1  | ccmessaging-token | string | True | - applyToken接口返回的token值。  - 会话过程中接口Response Header中返回的ccmessaging-token的值。   |
| 2  | x-app-key         | string | True | appKey字段，用户标识，在API Fabric上配置                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 3  | Authorization     | string | True | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
表2请求体参数 
| 序号 | 名称            | 参数类型                                                                                                                          | 是否必选 | 说明      |
|:---|:---|:---|:---|:---|
| 1  | satisfication | [satisficationInfo] | True | 满意度评价信息 |
   
 表3satisficationInfo参数结构 
| 序号  | 名称              | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|:---|
| 1.1 | channel         | string | True  | 渠道类型，当前固定为WEB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.2 | userId          | string | True  | 用户ID。取值范围：1到24位字符串。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.3 | evaluation      | string | True  | 满意度等级（1-5）。默认值为： - 1：很不满意  - 2：不满意  - 3：一般  - 4：满意  - 5：很满意   可调用查询满意度调查配置接口查询"配置中心 \> 工作台配置 \> 满意度调查 \> 满意度等级"中的设置的满意度等级或使用上述默认值。 满意度等级与按键数字保持一致。 |
| 1.4 | comment         | string | True  | 满意度评价语信息，小于512字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 1.5 | channelConfigId | string | True  | 渠道ID，即在AICC侧配置的WEB渠道的"配置ID"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.6 | npsScore        | String | False | NPS（推荐评分），范围0-9。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 1.7 | fcrValue        | String | False | 问题是否已解决，取值范围： - 1：是  - 2：否                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
#### 响应说明
- **响应状态码: 200**
  表4RspMsg参数结构 
  | 序号  | 名称         | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
  |:---|:---|:---|:---|
  | 1.1 | resultCode | string | 响应返回码 - 0：成功  - 13：呼叫信息获取失败，或提交满意度结果失败。                                                                                                                                                                                                                                                                                                         |
  | 1.2 | resultDesc | string | 响应返回描述 - 如果响应码为0，返回可能是"Save satisfaction success!" 有时也会返回"Exception appeared!"   - 如果响应码为13，则返回"The callIdString obtained failed!"或"Save satisfaction failed"。   |
     
  
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数。
  
- **响应状态码: 401**
  未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
- 场景描述：保存客户提交的满意度评价结果 请求参数:
  ```
  {
  "channel": "WEB",
  "userId": "XXXXXXXX",
  "evaluation": "5",
  "comment": "满意",
  "channelConfigId": "XXXXXXXXX",
  "npsScore": "9",
  "fcrValue": "1"
  }
  ```
  ```
  ```
  响应参数:
  ```
  {
  "resultCode": "0"
  }
  ```