保存客户提交的满意度评价结果 (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	满意度评价信息

表3 satisficationInfo参数结构
序号	名称	参数类型	是否必选	说明
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

表4 RspMsg参数结构
序号	名称	参数类型	说明
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"
}

响应参数: