AI智能外呼创建呼叫任务
更新时间:2026-09-11 17:01:34
AI智能外呼创建呼叫任务
| 名称 | 说明 |
|---|---|
| 接口名称 | AI智能外呼创建呼叫任务 |
| 协议 | HTTPS POST |
| URL | https://api.253.com/open/voice/v2/ai_call/createTask |
| 编码格式 | UTF-8 |
| Content-Type | application/json |
| 返回类型 | application/json |
请求头参数
请求头参数以及生成规则,可参考文档中的通用请求头:通用请求头
请求参数
请求参数 Body 以 application/json(JSON Body)方式提交
| 参数名 | 参数类型 | 是否必传 | 说明 |
|---|---|---|---|
| templateId | String | 是 | 模版Id |
| mobilesJson | String | 是 | 被叫号码和变量,手机号字段key固定为 客户手机号码,例如 [{"客户手机号码":"18912345678","name":"张三"},{"客户手机号码":"18911112222","name":"李四"}](json格式的数组,单次最大10000),如果需要带短信变量,短信中的变量和传的变量数量和顺序需要一致, 例如:[{"客户手机号码":"18912345678","name":"张三","smsVar":["张三","男"]},{"客户手机号码":"18911112222","name":"李四","smsVar":["李四","女"]}] |
| displayNum | String | 是 | 主叫号码 |
| billUrl | String | 否 | 话单推送回调地址 |
| transData | String | 否 | 透传数据(话单推送回调时返回,最大长度250) |
| taskName | String | 否 | 任务名称(最大长度50) |
| sendType | Integer | 否 | 任务发送类型:1定时任务,2即时任务, 不传为即时任务 |
| taskStartTime | String | 否 | 任务开始时间,yyyyMMddHHmmss,eg:20200902170000 |
| maxRecallCount | Integer | 否 | 最大重拨次数,只能0-1,0不重拨,默认值1 重拨1次 |
| recallInterval | Integer | 否 | 重拨间隔时长(分钟),只能1-1440,默认值60,最大重拨次数大于0时必传 |
| noConnected | string | 否 | 重播策略:被叫无法接通,true:重拨; false:不重拨, 默认值:true |
| noAnswer | string | 否 | 重播策略:被叫无人接听,true:重拨; false:不重拨, 默认值:true |
| smsHangupStatus | String | 否 | 挂机短信开启标识:0关闭,1开启 |
| smsSendType | int | 否 | 挂机短信发送方式:0接通后发送,1全部群发,2未接通发送,3按接通时长发送,默认0 |
| smsSendLimit | int | 否 | 当挂机短信方式为3时必填,单位秒,输入时间规则为大于等于x后发送挂机短信(整数输入大于等于1) |
| smsTemplateId | String | 否 | 挂机短信模板id |
| fmsStatus | String | 否 | 闪信开启标识:0关闭,1开启 |
| fmsTemplateId | String | 否 | 闪信模板id |
请求示例
{
"templateId": "15038",
"mobilesJson": "[{\"客户手机号码\":\"18912345678\",\"name\":\"张三\"},{\"客户手机号码\":\"18911112222\",\"name\":\"李四\"}]",
"displayNum": "02112345678",
"taskName": "测试任务",
"sendType": 2,
"maxRecallCount": 1,
"recallInterval": 60
}返回参数
| 参数名 | 数据类型 | 参数说明 |
|---|---|---|
| code | String | 响应码,000000:成功,其他失败 |
| msg | String | 响应消息 |
| requestId | String | 请求ID,由网关生成,用于问题排查 |
| data | Object | 响应数据,失败时为 null |
| data>>taskId | string | 呼叫的任务id |
返回数据示例(成功)
{
"code": "000000",
"msg": "success",
"requestId": "017839319530001xxxxx",
"data": {
"taskId": "AICALL931******64224"
}
}返回数据示例(失败)
{
"code": "301001",
"msg": "系统异常",
"requestId": "017839319530001xxxxx",
"data": null
}这篇文档对您有帮助吗?




