七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
呼叫中心智能服务记录

会话智能咨询分类

触发大模型推荐会话咨询分类,只返回匹配度最高的分类;同一通话只触发一次,后续返回上次结果,频率限制每分钟 120 次。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳,单位秒
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0=SHA1,1=SHA256

请求体

名称类型必填描述示例值
sessionIdint64是呼叫会话 ID10000001

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示业务成功200
dataobject
└namestring分类名称售后问题
└idint64分类 ID30001
└parentsobject[]父级分类路径
└namestring分类名称售后问题
└idint64分类 ID30001
└parentsobject[]父级分类路径
messagestring响应消息;业务失败时为失败原因success

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14009请求过于频繁
14202咨询分类标注通话过少,无法进行智能分类
14203消息内容过少,无法进行智能分类
14204未推荐出有效咨询分类
14205算法超时
14500系统异常或处理超时
14501呼叫智能分类功能未开启
14515企业无智能分类功能
postEndpoint
/openapi/ipcc/intelligent/predictCategory
POST
/openapi/ipcc/intelligent/predictCategory
curl -X POST "https://qiyukf.com/openapi/ipcc/intelligent/predictCategory?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "sessionId": 10000001  }'
{
  "code": 200,
  "data": {
    "name": "售后问题",
    "id": 30001,
    "parents": [
      {
        "name": "售后问题",
        "id": 30001,
        "parents": []
      }
    ]
  },
  "message": "success"
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求参数或内容不合法"
}
{
  "code": 14009,
  "message": "请求过于频繁"
}
{
  "code": 14202,
  "message": "咨询分类标注通话过少,无法进行智能分类"
}
{
  "code": 14203,
  "message": "消息内容过少,无法进行智能分类"
}
{
  "code": 14204,
  "message": "未推荐出有效咨询分类"
}
{
  "code": 14205,
  "message": "算法超时"
}
{
  "code": 14500,
  "message": "系统异常或处理超时"
}
{
  "code": 14501,
  "message": "呼叫智能分类功能未开启"
}
{
  "code": 14515,
  "message": "企业无智能分类功能"
}

这篇文档有帮助吗?