国内语音消息

日期	版本	修订内容摘要
2023-09-01	v1.0.0	更新接口文档

1.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	https://api.253.com/open/notify/batch-voice-notify

1.2 请求参数

数据提交方式：x-www-form-urlencoded

参数名	参数类型	是否必传	说明
appId	String	是	请在官网登录后获取，详情请看,功能介绍->接口详情
appKey	String	是	请在官网登录后获取，详情请看,功能介绍->接口详情
mobile	String	是	被叫号码，模版无变量多个则以英文半角分号“;”分割；模板带变量，多个号码以英文分号“;”分割，号码和变量以英文逗号“,”隔开，多个变量以竖线“\|”隔开，如 130XXXXXXXX,123\|456;186XXXXXXXX,321\|654 （批量号码上限10000个）。如果带短信变量，则用“#”隔开,多个短信变量以竖线“\|”隔开，如，130XXXXXXXX#123\|456;186XXXXXXXX#321\|654，如果语音变量和短信变量都有，则：130XXXXXXXX,123\|456#321\|654;150XXXXXXXX,123\|456#321\|654
templateId	String	是	文字模版 Id，官网控制台创建后产生，且已审核通过
billUrl	String	否	话单推送回调地址（最大长度250）
transData	String	否	透传数据(话单推送回调时返回最大长度50)
displayNum	String	否	主叫号码，由运营提供，未提供的则不需要传
isNotifyFileId	String	否	模版类型，0:TTS模版，1:录音文件模版，默认为0
smsHangupStatus	String	否	挂机短信开启标识 0：关闭，1：开启，默认：关闭
smsTemplateId	String	否	挂机短信模板id
smsSendType	String	否	挂机短信发送方式：0:接通后发送，1:全部群发，2:未接通发送，3:按接通时长发送，默认:0
smsSendLimit	String	否	当挂机短信方式为3时必填，单位秒，输入时间规则为大于等于x后发送挂机短信（整数输入大于等于1）
sendType	String	否	任务发送类型 1-定时任务2-即时任务,不传为即时任务
taskStartTime	String	否	任务开始时间，yyyyMMddHHmmss，eg:20200902170000
taskEndTime	String	否	任务结束时间，yyyyMMddHHmmss，eg:20200902235959
taskName	String	否	任务名称
maxRecallCount	String	否	最大重拨次数，只能0或1，0不重拨，默认：1 重拨1次
recallInterval	String	否	重拨间隔时长（分钟），只能1-2880，默认值60，最大重拨次数大于0时必传(注意：recallInterval的“llI”分别是小写的LL和大写的i
noConnected	String	否	重拨策略：被叫无法接通,true:重拨;false:不重拨,默认值:true
noAnswer	String	否	重拨策略：被叫无人接听,true:重拨;false:不重拨,默认值:true
fmsStatus	String	否	闪信状态：0：关闭，1：开启
fmsTemplateId	String	否	闪信模版Id

1.3 返回参数

参数名	数据类型	参数说明
code	string	响应code码。200000：成功，其他失败。详见code码
message	string	响应code码解释
data	Object	返回对象
callId	string	呼叫唯一标识Id

1.4 返回数据示例（成功）

{
  "message": "请求成功",
  "data": {
    "callId": "YYYX931******64224"
  },
  "code": "200000"
}

1.5 返回数据示例（失败）

{
  "message": "系统异常",
  "code": "500000"
}

产品中心

热门搜索

中国站

国际站

国内语音消息

国内语音消息