# 查询满意度调查结果（satisfaction/query）
#### 场景描述
根据callId和评价时间查询满意度调查结果。
使用该接口之前请了解如何配置满意度流程，请参考配置满意度调查。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/cc-management/v1/satisfaction/query，例如域名是service.besclouds.com
#### 请求说明
表1请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                            |
|:---|:---|:---|:---|:---|
| 1  | X-APP-Key     | string | False | appKey字段，用户标识，请联系运营人员获取appKey                                 |
| 2  | Authorization | string | True  | 鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格） |
   
表2请求体参数 
| 序号  | 名称          | 参数类型   | 是否必选 | 说明                        |
|:---|:---|:---|:---|:---|
| 1   | requestBody | object | True | 请求入参                      |
| 1.1 | callId      | string | True | 通话标识callId                |
| 1.2 | beginTime   | number | True | 评价开始时间，毫秒级别Timestamp时间戳类型 |
| 1.3 | endTime     | number | True | 评价结束时间，毫秒级别Timestamp时间戳类型 |
   
#### 响应说明
- **响应状态码: 200**
  表3响应体参数 
  | 序号    | 名称                      | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
  |:---|:---|:---|:---|:---|
  | 1     | schema                  | object | True  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | 1.1   | returnCode              | string | True  | 结果返回码，0表示查询成功，-1表示查询失败，description表示失败具体原因                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | 1.2   | description             | string | True  | 结果返回描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | 1.3   | satisfactionEvaluations | object | True  | 满意度评价                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
  | 1.3.1 | evaluationValue         | string | False | 满意度评价，为满意度等级配置的字典key值。 "1"表示"很不满意"， "2"表示"不满意"， "3"表示"一般"， "4"表示"满意"， "5"表示"很满意" "-1"表示"超时未回复"，指用户收到满意度评价后，评价超时， "-2"表示"评价错误"指用户回复的满意度，不在满意度配置的按键值中。 |
  | 1.3.2 | channel                 | string | False | 渠道： audio表示音频渠道，MSG表示短信，WEB表示网页文字交谈渠道                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
  | 1.3.3 | npsScore                | String | False | NPS分值。 NPS为推荐类的评分，即愿意推荐我们的产品/服务给朋友或同事吗？ 取值范围1\~9                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | 1.3.4 | evaluationTime          | number | False | 评价时间，毫秒级别Timestamp时间戳类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
  | 1.3.5 | fcrValue                | String | False | 客户对于首次解决率（First Call Resolution）的满意程度，即询问客户此次服务是否解决了问题。 - 1：是  - 2：否                                                                                                                                                                                      |
  | 1.3.6 | evaluateObject          | String | False | 被评价的对象 - Agent：座席  - Bot：机器人                                                                                                                                                                                                                              |
     
  
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数。
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径。
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
请求头:
```
Content-Type:application/json
Authorization:Bearer XXXXXXXXXXXXXXXXXXXXXXX
X-APP-Key:XXXXXXXXXXXXXXXXXXXXXXX
```
请求参数:
```
{
     "callId": "1647265024-xxxx",
     "beginTime": 1647265028000,
     "endTime": 1647265029000
 }
```
响应参数:
```
{
    "returnCode": "0",
    "satisfactionEvaluations": {
        "channel": "audio",
        "evaluationValue": "5",
        "npsScore":"8",
        "evaluationTime": 1647265028000,
        "fcrValue":"1",
        "evaluateObject":"Agent"
    },
    "description": " query Success"
}
```