呼叫中心外呼任务
重新分配外呼任务客户
仅支持已暂停的指定坐席类外呼任务。operateType=1 时按任务明细重新分配,operateType=2 时按源坐席迁出全部待呼客户;目标坐席和明细会在写入前进行校验。请求列表按原始数量校验上限后按首次出现顺序去重,目标坐席随后按 ID 升序轮询分配。返回的 reallocatedCount 是进入旧写入列表的明细数,不表示坐席 ID 一定发生变化。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳,单位秒 | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0=SHA1,1=SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| taskDetailIds | int64[] | 否 | operateType=1 时必填;按原始列表最多 1000 个,校验后按首次出现顺序去重 | [20001,20002] |
| operateType | int32 | 是 | 重新分配范围类型:1=按任务明细,2=按源坐席 | 1 |
| sourceStaffId | int64 | 否 | operateType=2 时必填;传企业内真实坐席 ID,不传任务坐席统计记录 ID | 30001 |
| taskId | int64 | 是 | 外呼任务 ID | 10001 |
| targetStaffIds | int64[] | 是 | 始终必填;按原始列表最多 100 个,校验后按首次出现顺序去重并按 ID 升序轮询分配 | [30001,30002] |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务状态码,200 表示业务成功 | 200 |
| data | object | ||
| └reallocatedCount | int32 | 进入重分配写入列表的任务明细数量;不表示坐席 ID 一定发生变化 | 2 |
| └taskId | int64 | 外呼任务 ID | 10001 |
| message | string | 响应消息;业务失败时为失败原因 | success |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求参数、任务状态或任务明细不合法 |
| 14009 | 请求过于频繁 |
| 14500 | 系统异常或处理超时 |
postEndpoint
/openapi/ipcc/calltask/reallocatecurl -X POST "https://qiyukf.com/openapi/ipcc/calltask/reallocate?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{ "taskDetailIds": [ 20001, 20002 ], "operateType": 1, "taskId": 10001, "targetStaffIds": [ 30001, 30002 ] }'{
"code": 200,
"data": {
"reallocatedCount": 2,
"taskId": 10001
},
"message": "success"
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求参数、任务状态或任务明细不合法"
}{
"code": 14009,
"message": "请求过于频繁"
}{
"code": 14500,
"message": "系统异常或处理超时"
}这篇文档有帮助吗?