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

重新分配外呼任务客户

仅支持已暂停的指定坐席类外呼任务。operateType=1 时按任务明细重新分配,operateType=2 时按源坐席迁出全部待呼客户;目标坐席和明细会在写入前进行校验。请求列表按原始数量校验上限后按首次出现顺序去重,目标坐席随后按 ID 升序轮询分配。返回的 reallocatedCount 是进入旧写入列表的明细数,不表示坐席 ID 一定发生变化。

请求参数

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

请求体

名称类型必填描述示例值
taskDetailIdsint64[]否operateType=1 时必填;按原始列表最多 1000 个,校验后按首次出现顺序去重[20001,20002]
operateTypeint32是重新分配范围类型:1=按任务明细,2=按源坐席1
sourceStaffIdint64否operateType=2 时必填;传企业内真实坐席 ID,不传任务坐席统计记录 ID30001
taskIdint64是外呼任务 ID10001
targetStaffIdsint64[]是始终必填;按原始列表最多 100 个,校验后按首次出现顺序去重并按 ID 升序轮询分配[30001,30002]

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示业务成功200
dataobject
└reallocatedCountint32进入重分配写入列表的任务明细数量;不表示坐席 ID 一定发生变化2
└taskIdint64外呼任务 ID10001
messagestring响应消息;业务失败时为失败原因success

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数、任务状态或任务明细不合法
14009请求过于频繁
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/calltask/reallocate
POST
/openapi/ipcc/calltask/reallocate
curl -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": "系统异常或处理超时"
}

这篇文档有帮助吗?