> For the complete documentation index, see [llms.txt](https://docs.innopaas.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.innopaas.com/api-reference/voice-api/voice-api/yu-yin-xiao-xi.md).

# 语音消息

## 语音消息发送

**请求接口地址**

```
POST  https://api.tig253.com/open/int-voice/batch-notify
```

**请求参数**

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

<table><thead><tr><th width="152.68359375">参数名</th><th width="157.19140625">参数类型</th><th width="136.21875">是否必传</th><th>说明</th></tr></thead><tbody><tr><td>appId</td><td>String</td><td>是</td><td>请在官网登录后获取 ，详情请看,功能介绍->接口详情</td></tr><tr><td>appKey</td><td>String</td><td>是</td><td>请在官网登录后获取 ，详情请看,功能介绍->接口详情</td></tr><tr><td>mobile</td><td>String</td><td>是</td><td>被叫号码，模版无变量多个则以英文半角分号“;”分割；模板带变量，多个号码以英文分号“;”分割，号码和变量以英文逗号“,”隔开， 多个变量以竖线“|”隔开，如 86130XXXXXXXX,123|456;86186XXXXXXXX,321|654; 注意:号码需要自带国家码前缀，否者会被视为无效号码，单次最大1000个号码</td></tr><tr><td>countryCode</td><td>String</td><td>是</td><td><a href="https://doc.chuanglan.com/document/WS0DSOFIJD79SA1L#countryCode">国家码</a>，国家的简称，例如，中国:CN</td></tr><tr><td>templateId</td><td>String</td><td>是</td><td>语音模版Id，官网控制台创建后产生，且已审核通过</td></tr><tr><td>billUrl</td><td>String</td><td>否</td><td>话单推送回调地址 （最大长度250）</td></tr><tr><td>transData</td><td>String</td><td>否</td><td>透传数据(话单推送回调时返回 最大长度50)</td></tr><tr><td>displayNum</td><td>String</td><td>否</td><td>主叫号码，由运营提供，未提供的则不需要传</td></tr><tr><td>smsHangupStatus</td><td>String</td><td>否</td><td>挂机短信开启标识 0：关闭，1：开启，默认：关闭</td></tr><tr><td>smsTemplateId</td><td>String</td><td>否</td><td>挂机短信模板id</td></tr><tr><td>smsSendType</td><td>String</td><td>否</td><td>挂机短信发送方式：0:接通后发送，1:全部群发，2:未接通发送，3:按接通时长发送，默认:0</td></tr><tr><td>smsSendLimit</td><td>String</td><td>否</td><td>当挂机短信方式为3时必填，单位秒，输入时间规则为大于等于x后发送挂机短信（整数输入大于等于1）</td></tr><tr><td>sendType</td><td>String</td><td>否</td><td>任务发送类型 1-定时任务2-即时任务,不传为即时任务</td></tr><tr><td>taskStartTime</td><td>String</td><td>否</td><td>任务开始时间，最长8天，yyyyMMddHHmmss，eg:20200902170000</td></tr><tr><td>taskEndTime</td><td>String</td><td>否</td><td>任务结束时间，yyyyMMddHHmmss，eg:20200902235959</td></tr><tr><td>taskName</td><td>String</td><td>否</td><td>任务名称</td></tr><tr><td>maxRecallCount</td><td>String</td><td>否</td><td>最大重拨次数，只能0-3，默认：1 重拨1次</td></tr><tr><td>recallInterval</td><td>String</td><td>否</td><td>重拨间隔时长（分钟），默认值60，重播最长时间跨度3天，最大重拨次数大于0时必传</td></tr><tr><td>noConnected</td><td>String</td><td>否</td><td>重拨策略：被叫无法接通,true:重拨;false:不重拨,默认值:true</td></tr><tr><td>noAnswer</td><td>String</td><td>否</td><td>重拨策略：被叫无人接听,true:重拨;false:不重拨,默认值:true</td></tr><tr><td>ttsVoice</td><td>String</td><td>否</td><td>播放语种， 例如，美国：en-US，如果不传，则按国家对应的语言播放，参考附录：<a href="https://doc.chuanglan.com/document/WS0DSOFIJD79SA1L#tts">播放语种</a> (如果是录音模版，则不需要传此参数)</td></tr></tbody></table>

**请求示例**

```json
{
	"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",
    
}
```

**返回参数**

<table><thead><tr><th width="175.74609375">数名</th><th width="173.4375">数据类型</th><th>参数说明</th></tr></thead><tbody><tr><td>code</td><td>string</td><td>响应code码。200000：成功，其他失败。<a href="https://doc.chuanglan.com/document/VN6NTZI2E7HPJEWJ">详见code码</a></td></tr><tr><td>message</td><td>string</td><td>响应code码解释</td></tr><tr><td>data</td><td>Object</td><td>返回对象</td></tr><tr><td>callId</td><td>string</td><td>呼叫唯一标识Id</td></tr></tbody></table>

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