文档首页/ 云客服/ API参考/ 网页客户端接入/ 提交客户满意度评价结果 (saveSatisfaction)
更新时间：2024-08-02 GMT+08:00
查看PDF
分享

提交客户满意度评价结果 (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”。

响应说明

  • 响应状态码: 200
    表4 RspMsg参数结构

    序号

    名称

    参数类型

    是否必选

    说明

    1.1

    resultCode

    string

    True

    响应返回码

    • 0：成功
    • 13：呼叫信息获取失败，或提交满意度结果失败。

    1.2

    resultDesc

    string

    False

    响应返回描述

    • 如果响应码为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"
}

    响应参数:

    {
	"resultCode": "0"
}
父主题： 网页客户端接入