logo
logo
请输入关键词搜索产品或者文档
中国

中国站

创蓝云智

国际站

Innopaas

AI智能外呼创建呼叫任务

更新时间:2026-09-11 17:01:34

AI智能外呼创建呼叫任务

名称说明
接口名称AI智能外呼创建呼叫任务
协议HTTPS POST
URLhttps://api.253.com/open/voice/v2/ai_call/createTask
编码格式UTF-8
Content-Typeapplication/json
返回类型application/json

请求头参数

请求头参数以及生成规则,可参考文档中的通用请求头:通用请求头

请求参数

请求参数 Body 以 application/json(JSON Body)方式提交

参数名参数类型是否必传说明
templateIdString模版Id
mobilesJsonString被叫号码和变量,手机号字段key固定为 客户手机号码,例如 [{"客户手机号码":"18912345678","name":"张三"},{"客户手机号码":"18911112222","name":"李四"}](json格式的数组,单次最大10000),如果需要带短信变量,短信中的变量和传的变量数量和顺序需要一致, 例如:[{"客户手机号码":"18912345678","name":"张三","smsVar":["张三","男"]},{"客户手机号码":"18911112222","name":"李四","smsVar":["李四","女"]}]
displayNumString主叫号码
billUrlString话单推送回调地址
transDataString透传数据(话单推送回调时返回,最大长度250)
taskNameString任务名称(最大长度50)
sendTypeInteger任务发送类型:1定时任务,2即时任务, 不传为即时任务
taskStartTimeString任务开始时间,yyyyMMddHHmmss,eg:20200902170000
maxRecallCountInteger最大重拨次数,只能0-1,0不重拨,默认值1 重拨1次
recallIntervalInteger重拨间隔时长(分钟),只能1-1440,默认值60,最大重拨次数大于0时必传
noConnectedstring重播策略:被叫无法接通,true:重拨; false:不重拨, 默认值:true
noAnswerstring重播策略:被叫无人接听,true:重拨; false:不重拨, 默认值:true
smsHangupStatusString挂机短信开启标识:0关闭,1开启
smsSendTypeint挂机短信发送方式:0接通后发送,1全部群发,2未接通发送,3按接通时长发送,默认0
smsSendLimitint当挂机短信方式为3时必填,单位秒,输入时间规则为大于等于x后发送挂机短信(整数输入大于等于1)
smsTemplateIdString挂机短信模板id
fmsStatusString闪信开启标识:0关闭,1开启
fmsTemplateIdString闪信模板id

请求示例

{
  "templateId": "15038",
  "mobilesJson": "[{\"客户手机号码\":\"18912345678\",\"name\":\"张三\"},{\"客户手机号码\":\"18911112222\",\"name\":\"李四\"}]",
  "displayNum": "02112345678",
  "taskName": "测试任务",
  "sendType": 2,
  "maxRecallCount": 1,
  "recallInterval": 60
}

返回参数

参数名数据类型参数说明
codeString响应码,000000:成功,其他失败
msgString响应消息
requestIdString请求ID,由网关生成,用于问题排查
dataObject响应数据,失败时为 null
data>>taskIdstring呼叫的任务id

返回数据示例(成功)

{
  "code": "000000",
  "msg": "success",
  "requestId": "017839319530001xxxxx",
  "data": {
    "taskId": "AICALL931******64224"
  }
}

返回数据示例(失败)

{
  "code": "301001",
  "msg": "系统异常",
  "requestId": "017839319530001xxxxx",
  "data": null
}
24小时热线 400-9669-253