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

获取呼叫会话的服务小记记录

按会话 ID 查询通话所属客服可查看的服务小记模板,以及该会话已填写的服务小记记录;可查看范围由管理后台服务小记字段模板的客服组配置决定。

请求参数

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

请求体

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

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示业务成功200
messageobject
└sessionInfoobject
└resolvedStatusint32会话解决状态
└categoryobject
└pathIdsstring分类 ID 路径
└pathstring分类名称路径
└namestring分类名称
└rankint32同级分类排序值
└updateTimeint64分类更新时间,毫秒时间戳
└idint64分类 ID
└parentIdint64父分类 ID
└remarksstring会话备注已处理
└selectedTemplateIdint64当前会话已选择的服务小记模板 ID20001
└historyFieldValuesobject[]当前会话已填写的服务小记字段值
└fieldNamestring字段名称问题描述
└assignTypeint32分配字段类型
└fieldValuestring字段值客户咨询配送进度
└fieldIdint64自定义字段 ID30001
└templatesobject[]当前客服可查看的服务小记模板列表
└isDefaultint32是否为默认模板1
└assignFieldsobject[]模板分配的服务小记字段
└systemint32字段来源:0=自定义字段,1=系统默认字段0
└namestring字段名称问题描述
└staffNamestring字段关联的客服名称
└valueEditableint32字段值是否可编辑
└descriptionstring字段描述
└assignTypeint32分配字段类型
└idint64模板字段记录 ID
└typeint32字段类型:0=文本,1=下拉菜单,2=多选,3=时间控件0
└requiredint32是否必填1
└fieldIdint64自定义字段 ID30001
└namestring模板名称售后回访模板
└idint64模板 ID20001

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14009请求过于频繁
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/customfield/session/template
POST
/openapi/ipcc/customfield/session/template
curl -X POST "https://qiyukf.com/openapi/ipcc/customfield/session/template?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "sessionId": 10000001  }'
{
  "code": 200,
  "message": {
    "sessionInfo": {
      "resolvedStatus": 1,
      "remarks": "已处理"
    },
    "selectedTemplateId": 20001,
    "historyFieldValues": [
      {
        "fieldName": "问题描述",
        "fieldValue": "客户咨询配送进度",
        "fieldId": 30001
      }
    ],
    "templates": [
      {
        "isDefault": 1,
        "assignFields": [
          {
            "name": "问题描述",
            "type": 0,
            "required": 1,
            "fieldId": 30001
          }
        ],
        "name": "售后回访模板",
        "id": 20001
      }
    ]
  }
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求参数或内容不合法"
}
{
  "code": 14009,
  "message": "请求过于频繁"
}
{
  "code": 14500,
  "message": "系统异常或处理超时"
}

这篇文档有帮助吗?