创建外呼任务

创建手动或自动外呼任务，并返回新建任务 ID；客户号码最多 2000 条，seatType 用于指定客服、客服组、客户关系或自定义数量分配。

请求参数

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

请求体

名称	类型	必填	描述	示例值
seatIds	string	否	坐席 ID 列表，多个用英文逗号分隔	1001,1002
amount	object[]	否	指定坐席任务数量；seatType=3 时使用
└count	int64	是	分配号码数量	20
└seatId	int64	是	坐席 ID	1001
repeatStatus	int32[]	否	自动外呼重复呼叫状态条件
customTemplateId	int64	否	服务小记模板 ID	20001
forecastRate	double	否	自动外呼倍率；自动外呼时使用，不传默认 1.0	1
description	string	否	任务描述	回访近期咨询客户
customerInfo	object[]	否	外呼客户号码列表
└name	string	否	客户姓名	张三
└fromTaskDetailId	int64	否	来源任务明细 ID	90001
└value	string	是	客户号码；企业开启外呼号码加密时传密文	13800000000
└remarks	string	否	备注	VIP客户
└staffId	int64	否	指定分配客服 ID	1001
forecastType	int32	否	外呼任务类型：0=手动外呼，1=自动外呼；不传默认 0	0
seatType	int32	否	坐席分配类型：1=指定客服，2=客户关系分配，3=指定客服及数量	1
repeatSwitch	int32	否	自动外呼重复呼叫开关：0=关闭，1=开启	0
name	string	是	任务名称	6月客户回访
repeatInterval	int32	否	自动外呼重复呼叫间隔，单位分钟	30
forecastDids	string	否	自动外呼可使用 DID 号码，多个用英文逗号分隔	057112345678
startTime	int64	是	任务开始时间，毫秒时间戳	1719763200000
endTime	int64	是	任务结束时间，毫秒时间戳	1719849599000
hideNumber	int32	否	是否隐藏号码：0=不隐藏，1=隐藏	0
repeatNum	int32	否	自动外呼重复呼叫次数	2

返回参数

名称	类型	描述	示例值
code	int32	业务状态码，200 表示业务成功	200
data	object
└id	int64	业务 ID	100001
message	string	响应消息；业务失败时为失败原因	success

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求参数或内容不合法
14009	请求过于频繁
14500	系统异常或处理超时

postEndpoint

/openapi/ipcc/calltask/add

curl -X POST "https://qiyukf.com/openapi/ipcc/calltask/add?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "seatIds": "1001,1002",    "seatType": 1,    "name": "6月客户回访",    "description": "回访近期咨询客户",    "customerInfo": [      {        "name": "张三",        "value": "13800000000",        "remarks": "VIP客户"      }    ],    "startTime": 1719763200000,    "endTime": 1719849599000,    "hideNumber": 0,    "forecastType": 0  }'

{
  "code": 200,
  "data": {
    "id": 100001
  },
  "message": "success"
}

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

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

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

{
  "code": 14004,
  "message": "请求参数或内容不合法"
}

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

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