七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
在线机器人机器人配置

查询机器人转人工配置

查询机器人转人工配置。

请求字段限制:

  • robotId:选填,机器人 ID,不传时按服务端默认机器人处理

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey1c088a89de51d0af457616605f28390f
timeint64是请求时间戳(秒);与服务器时间误差超过 10 分钟会鉴权失败1511832531
checksumstring是请求签名校验和f570a5eb049eb803b086e45829b07e48
checksumAlgorithmint32否签名算法:0-SHA-1,1-SHA-256;不传默认为 0(SHA-1)0

请求体

名称类型必填描述示例值
robotIdint64否机器人 ID,不传时按服务端默认机器人处理123456

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示成功200
messagestring响应消息success
dataobject
└statusint32转人工配置状态
└entranceTipsstring转人工入口提示文案
└entranceGuidestring转人工入口引导文案
└transferListobject[]可转接机器人列表
└robotIdint64机器人 ID
└robotNamestring机器人对外名称
└realNamestring机器人对内名称
└bizNamestring机器人对应业务名称
└statusint32机器人状态
└portraitUrlstring机器人头像地址
└groupIdint64转人工分流组 ID
└groupNamestring转人工分流组名称
totalint32分页总数,分页接口返回100
requestIdstring链路请求 ID0a1b2c3d4e5f
resultobject部分历史接口使用 result 字段承载业务数据

错误码

状态码描述
14001AppKey 缺失或不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求体不是合法 JSON 对象,或参数缺失、格式非法
14009频控限制:接口调用超过限流阈值
14500服务内部错误
14501数据查询范围超出限制
14515当前 AppKey 无接口或资源访问权限
postEndpoint
/openapi/robot/transfer/config
POST
/openapi/robot/transfer/config
curl -X POST "https://qiyukf.com/openapi/robot/transfer/config?appKey=1c088a89de51d0af457616605f28390f&time=1511832531&checksum=f570a5eb049eb803b086e45829b07e48" \  -H "Content-Type: application/json" \  -d '{    "robotId": 123456  }'
{
  "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": "未开通机器人服务"
}

这篇文档有帮助吗?

查询问答回溯记录列表

查询问答回溯记录列表。 接口级参数规则:robotId、startTime、endTime 必填;keyword 最长 50 个字符;page 不传默认 1;pageSize 不传默认 50,最大 50;查询时间不能晚于当天、不可早于近 180 天,且跨度不能超过 30 天。 请求字段限制: - robotId:必填,机器人 ID,必须属于当前 appKey 对应企业 - keyword:选填,搜索关键词,可搜索问题或会话 ID,最长 50 个字符 - scenario:选填,数组 - evaluation:选填,数组 - transType:选填,数组 - resolved:选填,数组 - startTime:必填,查询开始时间,毫秒时间戳;不可早于近 180 天 - endTime:必填,查询结束时间,毫秒时间戳;不能晚于当天,且与 startTime 间隔不能超过 30 天 - page:选填,页码,从 1 开始;不传默认 1,最小值 1,默认值:1 - pageSize:选填,每页条数;不传默认 50,最大 50,最小值 1,最大值 50,默认值:50

提交机器人会话评价

提交机器人会话评价。 接口级参数规则:sessionId、evaluation 必填;evaluation 范围 1-100;evaluationResolved 范围 0-2;remarks 默认最长 200,tagList 默认最长 500。 请求字段限制: - sessionId:必填,会话 ID,必须属于当前 appKey 对应企业 - evaluation:必填,评价分值,范围 1-100,最小值 1,最大值 100 - evaluationResolved:选填,解决状态:0-未选择,1-已解决,2-未解决,可选值:0/1/2 - remarks:选填,评价备注,长度不能超过服务端配置,默认 200 - tagList:选填,评价标签,多个标签按现有协议传入,长度不能超过服务端配置,默认 500