七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
工单系统

批量同步员工工单自动分配开关

批量设置坐席自动接单开关,用于三方排班系统同步接单状态。itemList 为空时报错;为空数组时直接返回空结果,不做任何修改。每项坐席 ID 会逐条校验并设置,无效 staffId 会在结果中单独标记失败。

请求参数

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

请求体

名称类型必填描述示例值
itemListobject[]否坐席自动接单配置列表[{"staffId":10001,"open":1},{"staffId":10002,"open":0}]
└staffIdint64否坐席 ID10001
└openint32否自动接单开关:1-开启,0-关闭1

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messageobject坐席处理结果,字段名为坐席 ID,字段值为处理结果描述{"10001":"true","10002":"true"}

错误码

状态码描述
14004itemList 为空;请求体 JSON 格式错误
14100某坐席 ID 不存在或已停用(对应条目会标记失败)
14500服务内部异常
postEndpoint
/openapi/v2/ticket/batch/auto/accept/config
POST
/openapi/v2/ticket/batch/auto/accept/config
curl -X POST "https://qiyukf.com/openapi/v2/ticket/batch/auto/accept/config?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "code": 200,
  "message": {
    "10001": "true",
    "10002": "true"
  }
}
{
  "code": 14004,
  "message": "itemList 为空;请求体 JSON 格式错误"
}
{
  "code": 14100,
  "message": "某坐席 ID 不存在或已停用(对应条目会标记失败)"
}
{
  "code": 14500,
  "message": "服务内部异常"
}

这篇文档有帮助吗?