启动外呼任务

使用企业级 appKey 同步启动指定外呼任务；业务 code=200 表示任务主表、坐席统计和待办状态均已完成启动写入。已启动任务再次启动按幂等成功处理；任务不存在、已删除、已完成或正在分配/编辑时拒绝操作。该操作不修改任务配置、名单或执行进度。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳，单位秒
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0=SHA1，1=SHA256

请求体

名称	类型	必填	描述	示例值
taskId	int64	是	外呼任务 ID	100001

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示业务成功	200
data	object
└taskId	int64	外呼任务 ID	100001
└status	int32	任务状态：0=启动，1=暂停	1
message	string	响应消息；业务失败时为失败原因	success

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求参数或内容不合法，或企业未开通呼叫中心
14009	请求过于频繁
14500	系统异常或处理超时
18001	任务不存在、已删除或不属于当前企业
18005	任务已完成或目标状态不合法
18006	任务正在分配或编辑，请稍后操作

postEndpoint

/openapi/ipcc/calltask/start

curl -X POST "https://qiyukf.com/openapi/ipcc/calltask/start?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "taskId": 100001  }'

{
  "code": 200,
  "data": {
    "taskId": 100001,
    "status": 1
  },
  "message": "success"
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求参数或内容不合法，或企业未开通呼叫中心"
}

{
  "code": 14009,
  "message": "请求过于频繁"
}

{
  "code": 14500,
  "message": "系统异常或处理超时"
}

{
  "code": 18001,
  "message": "任务不存在、已删除或不属于当前企业"
}

{
  "code": 18005,
  "message": "任务已完成或目标状态不合法"
}

{
  "code": 18006,
  "message": "任务正在分配或编辑，请稍后操作"
}