在线机器人机器人会话
提交会话满意度评价
提交会话满意度评价。
请求字段限制:
- sessionId:必填,会话 ID
- evaluation:必填,评价分值,1-100
- evaluationResolved:选填,解决状态:0-未选择,1-已解决,2-未解决
- remarks:选填,评价备注
- tagList:选填,评价标签,多个标签按现有协议传入
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | 1c088a89de51d0af457616605f28390f |
| time | int64 | 是 | 请求时间戳(秒);与服务器时间误差超过 10 分钟会鉴权失败 | 1511832531 |
| checksum | string | 是 | 请求签名校验和 | f570a5eb049eb803b086e45829b07e48 |
| checksumAlgorithm | int32 | 否 | 签名算法:0-SHA-1,1-SHA-256;不传默认为 0(SHA-1) | 0 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| sessionId | int64 | 是 | 会话 ID | 1000000001 |
| evaluation | int32 | 是 | 评价分值,1-100 | 100 |
| evaluationResolved | int32 | 否 | 解决状态:0-未选择,1-已解决,2-未解决 | 1 |
| remarks | string | 否 | 评价备注 | 问题已解决 |
| tagList | string | 否 | 评价标签,多个标签按现有协议传入 | 服务好,响应快 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务状态码,200 表示成功 | 200 |
| message | string | 响应消息 | success |
| data | object | ||
| └sessionId | int64 | 会话 ID | |
| └userId | int64 | 访客对应七鱼用户账号 ID | |
| └robotId | int64 | 机器人 ID | |
| └evaluationThanks | object | ||
| └msgType | string | 消息类型 | |
| └msgBody | object | 消息内容 | |
| total | int32 | 分页总数,分页接口返回 | 100 |
| requestId | string | 链路请求 ID | 0a1b2c3d4e5f |
| result | object | 部分历史接口使用 result 字段承载业务数据 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 缺失或不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体不是合法 JSON 对象,或参数缺失、格式非法 |
| 14009 | 频控限制:接口调用超过限流阈值 |
| 14500 | 服务内部错误 |
| 14501 | 数据查询范围超出限制 |
| 14515 | 当前 AppKey 无接口或资源访问权限 |
postEndpoint
/openapi/robot/session/evaluationcurl -X POST "https://qiyukf.com/openapi/robot/session/evaluation?appKey=1c088a89de51d0af457616605f28390f&time=1511832531&checksum=f570a5eb049eb803b086e45829b07e48" \ -H "Content-Type: application/json" \ -d '{ "evaluation": 100, "evaluationResolved": 1, "sessionId": 1000000001, "remarks": "问题已解决" }'{
"code": 200,
"data": {},
"message": "success"
}{
"code": 14001,
"message": "AppKey not exists"
}{
"code": 14002,
"message": "Bad checksum"
}{
"code": 14003,
"message": "Bad time"
}{
"code": 14004,
"message": "body内容json解析错误"
}{
"code": 14009,
"message": "单位时间内请求过于频繁"
}{
"code": 14500,
"message": "Internal error"
}{
"code": 14501,
"message": "Data limit exceeded"
}{
"code": 14515,
"message": "未开通机器人服务"
}这篇文档有帮助吗?
创建机器人会话
创建机器人会话。 接口级参数规则:uid、productId、fromType 必填;robotId 不传时使用默认机器人。 请求字段限制: - uid:必填,访客在调用方系统里的唯一标识 - productId:必填,当前咨询应用唯一标识,如 Android 包名、iOS bundleId、微信公众号 appId - fromType:必填,当前访客咨询来源渠道 - robotId:选填,机器人 ID,存在多个机器人时指定 - welcomeTemplateId:选填,欢迎语模板 ID,不传则按来源渠道匹配默认模板 - questionTemplateId:选填,常见问题模板 ID,不传则按来源渠道、应用、页面匹配模板 - fromPage:选填,当前访客咨询来源页面
输入联想
输入联想。 请求字段限制: - robotId:选填,机器人 ID,为空时取默认机器人 - content:必填,当前访客输入内容