国际语音消息

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

1.1 协议说明

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

1.2 请求参数

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

参数名	参数类型	是否必传	说明
appId	String	是	请在官网登录后获取，详情请看,功能介绍->接口详情
appKey	String	是	请在官网登录后获取，详情请看,功能介绍->接口详情
mobile	String	是	被叫号码，模版无变量多个则以英文半角分号“;”分割；模板带变量，多个号码以英文分号“;”分割，号码和变量以英文逗号“,”隔开，多个变量以竖线“\|”隔开，如 86130XXXXXXXX,123\|456;86186XXXXXXXX,321\|654; 注意:号码需要自带国家码前缀，否者会被视为无效号码，单次最大1000个号码
countryCode	String	是	国家码，国家的简称，例如，中国:CN
templateId	String	是	语音模版Id，官网控制台创建后产生，且已审核通过
billUrl	String	否	话单推送回调地址（最大长度250）
transData	String	否	透传数据(话单推送回调时返回最大长度50)
displayNum	String	否	主叫号码，由运营提供，未提供的则不需要传
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	否	任务开始时间，最长8天，yyyyMMddHHmmss，eg:20200902170000
taskEndTime	String	否	任务结束时间，yyyyMMddHHmmss，eg:20200902235959
taskName	String	否	任务名称
maxRecallCount	String	否	最大重拨次数，只能0-3，默认：1 重拨1次
recallInterval	String	否	重拨间隔时长（分钟），默认值60，重播最长时间跨度3天，最大重拨次数大于0时必传
noConnected	String	否	重拨策略：被叫无法接通,true:重拨;false:不重拨,默认值:true
noAnswer	String	否	重拨策略：被叫无人接听,true:重拨;false:不重拨,默认值:true
ttsVoice	String	否	播放语种，例如，美国：en-US，如果不传，则按国家对应的语言播放，参考附录：播放语种 (如果是录音模版，则不需要传此参数)

请求示例：

{
	"appId": "*****",
	"appKey": "*****,
	"mobile": "86176***5202,张同学|111;86186***5203,王同学|222",
    "countryCode":"CN",
	"templateId": "123",
	"allowedCallTime": "",
	"billUrl": "http://****/voice/test/test3",
	"transData": "12****44",
	"smsHangupStatus": "1",
	"smsTemplateId": "4123***1",
    "smsSendType": "0",
    "smsSendLimit": "0",
	"displayNum": "",
	"sendType": "1",
	"taskStartTime": "20230909151800",
	"taskEndTime": "20230909231800",
	"taskName": "示例任务测试",
	"maxRecallCount": "3",
	"recallInterval": "3",
	"noConnected": "true",
	"noAnswer": "true",
   "ttsVoice": "en-US",
    
}

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"
}

产品中心

热门搜索

中国站

国际站

国际语音消息

国际语音消息