工单系统
批量同步员工工单自动分配开关
批量设置坐席自动接单开关,用于三方排班系统同步接单状态。itemList 为空时报错;为空数组时直接返回空结果,不做任何修改。每项坐席 ID 会逐条校验并设置,无效 staffId 会在结果中单独标记失败。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| itemList | object[] | 否 | 坐席自动接单配置列表 | [{"staffId":10001,"open":1},{"staffId":10002,"open":0}] |
| └staffId | int64 | 否 | 坐席 ID | 10001 |
| └open | int32 | 否 | 自动接单开关:1-开启,0-关闭 | 1 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | object | 坐席处理结果,字段名为坐席 ID,字段值为处理结果描述 | {"10001":"true","10002":"true"} |
错误码
| 状态码 | 描述 |
|---|---|
| 14004 | itemList 为空;请求体 JSON 格式错误 |
| 14100 | 某坐席 ID 不存在或已停用(对应条目会标记失败) |
| 14500 | 服务内部异常 |
postEndpoint
/openapi/v2/ticket/batch/auto/accept/configcurl -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": "服务内部异常"
}这篇文档有帮助吗?