创建呼叫任务。
接口说明
在创建呼叫任务之前，请先使用智能体进行拨测以确认效果符合您的要求。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| TaskName |
string |
是 |
任务名称，同一个账号下不允许重复。 |
测试任务 |
| AgentId |
string |
否 |
已上线的智能体编码。 |
1180************** |
| VirtualNumber |
string |
否 |
呼出使用的服务实例。 |
032712122***** |
| StartType |
string |
是 |
启动方式。取值：
|
SCHEDULE |
| MissCallRetry |
boolean |
否 |
是否开启重试。取值：
|
false |
| CallRetryReason |
array |
否 |
失败重试原因列表。 |
|
|
string |
否 |
具体重试原因。取值：
|
CALL_REJECTED |
|
| CallRetryTimes |
integer |
否 |
重试次数，最大不能超过 3 次。 |
2 |
| CallRetryInterval |
integer |
否 |
重试间隔，单位：分钟，最大不能超过 720 分钟。 |
32 |
| CallTime |
array |
是 |
可呼叫时间段列表。 |
|
|
string |
否 |
呼叫时间段，格式如下：
说明
|
{"startTime":"09:00:00","endTime":"10:00:00"} |
|
| CallableTime |
array |
否 |
||
|
string |
否 |
|||
| CallDay |
array |
是 |
可呼叫日列表。 |
|
|
string |
否 |
可呼叫日。取值：
|
MONDAY |
|
| TaskStartTime |
integer |
否 |
任务预设的启动时间，时间戳，单位毫秒。StarType 字段为 SCHEDULE 时该字段有效且必填，任务将在该字段设置的时间进行自动启动。 |
12313123133 |
| TaskCps |
integer |
否 |
任务并发，最大不超过 500。 |
75 |
| Source |
integer |
否 |
创建来源：取值
|
0 |
| ApplicationCode |
string |
否 |
应用 code，创建来源为引擎创建时使用 |
025****C98 |
| PhoneType |
integer |
否 |
号码类型（创建来源为引擎创建时使用）
|
0 |
| LineEncoding |
string |
否 |
线路编码 |
JILIANG_***_***_NET |
| LinePhoneNum |
string |
否 |
自带线路号码 |
152****3120 |
| CallExpireType |
integer |
否 |
外呼有效期类型： 0：长期有效； 1：导入后一段时间内有效； 2：截止指定时间有效； |
0 |
| CallExpireMinutes |
integer |
否 |
外呼明细过期时长（分钟） |
10 |
| CallExpireDate |
string |
否 |
外呼明细过期日期（具体截止时间） |
2026-07-30 20:00:20 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
访问被拒绝的详细原因。 |
None |
| Message |
string |
状态码描述。 |
成功 |
| RequestId |
string |
请求 ID。 |
8C93B345-F702-5449-BA7E-7D110D4BF798 |
| Data |
integer |
任务 ID。 |
1213123123***** |
| Code |
string |
请求状态码。 |
OK |
| Success |
boolean |
调用接口是否成功。取值：
|
true |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "None",
"Message": "成功",
"RequestId": "8C93B345-F702-5449-BA7E-7D110D4BF798",
"Data": 0,
"Code": "OK",
"Success": true
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。