提交工单满意度评价

按 ticketId 提交满意度评价。evaluationModel 必须与当前工单评价规则一致；evaluationValue 必须匹配模型：2 档为 1/100，3 档为 1/50/100，4 档为 1/25/75/100，5 档为 1/25/50/75/100。关联客户触发类型的评价规则不支持通过开放接口提交评价。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
ticketId	int64	是	工单 ID	123456
evaluationValue	int32	是	评价值，必须匹配 evaluationModel：2 档支持 1/100；3 档支持 1/50/100；4 档支持 1/25/75/100；5 档支持 1/25/50/75/100	100
evaluationModel	int32	是	评价模型：2、3、4、5；会与当前工单评价规则中的 evaluationModel 做一致性校验	5
tagList	string	否	评价标签列表字符串（JSON 字段名 tagList）	[{"id":1,"name":"响应快"}]
content	string	否	评价内容（JSON 字段名 content）	处理及时，问题已解决
way	int32	否	评价方式（JSON 字段名 way），缺失时默认 0	1
isSolved	int32	否	是否解决：0-未填写，1-解决，2-未解决；缺失时默认 0	1

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
data	boolean	布尔结果	true

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	time 缺失，或请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON
14106	ticketId、evaluationValue 或 evaluationModel 缺失/为 0；企业管理员不存在；工单已删除或不存在；评价规则不存在；evaluationModel 与规则不一致；evaluationValue 不匹配规则；或规则触发类型禁止坐席评价
14500	服务内部异常；请求字段类型不符合要求或服务处理失败

postEndpoint

/openapi/worksheet/satisfaction/clickEvaluation

curl -X POST "https://qiyukf.com/openapi/worksheet/satisfaction/clickEvaluation?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \  -H "Content-Type: application/json" \  -d '{    "ticketId": 123456,    "evaluationValue": 100,    "evaluationModel": 5  }'

{
  "code": 200,
  "data": true
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "time 缺失，或请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体不是合法 JSON"
}

{
  "code": 14106,
  "message": "ticketId、evaluationValue 或 evaluationModel 缺失/为 0；企业管理员不存在；工单已删除或不存在；评价规则不存在；evaluationModel 与规则不一致；evaluationValue 不匹配规则；或规则触发类型禁止坐席评价"
}

{
  "code": 14500,
  "message": "服务内部异常；请求字段类型不符合要求或服务处理失败"
}