批量发送TTS语音消息（使用模板）
POST
https://api.laaffic.com/v3/voice/sendIvr
通过指定语言和指定语言文本批量发送TTS语音消息。后台配置模板后，呼叫时仅需要传递被叫号码集合和模板ID进行呼叫。
请求参数
| 参数 | 说明 | 是否必填 | 类型 |
|---|---|---|---|
| appId | 语音应用id | 是 | String |
| recallPush | 重呼话单推送方式：默认0（重呼仅推送最后一次呼叫结果）,1（重呼的每次呼叫结果均推送） | 否 | Int |
| numberList | 号码集合 | 是 | Array |
| callee | 被叫号码，国码+手机号组成的7-18位数字 | 是 | String |
| dimensionId | 模板ID，具体数值需联系商务获取 | 是 | Integer |
| text1 | 1、text1-text10为预设的被叫信息变量，可在呼叫时动态替换呼叫模板内TTS里的NULL-NULL占位符。2、被叫信息变量总计有10个，您不必10个参数全部使用可按需使用，单个被叫信息变量并无字符长度限制，但您需要保证您使用的所有text变量加起来不超过300字符长度。 3、当您使用text变量后，我方会在【语音状态报告主动推送】calledInfo字段进行推送回给您，举例请求："text1":"Tom"、"text2":"12$"，回执推送格式"calledInfo":"{"text1":"Tom","text2":"12$"}" | 否 | String |
| text2 | 被叫信息变量2 | 否 | String |
| text3 | 被叫信息变量3 | 否 | String |
| text4 | 被叫信息变量4 | 否 | String |
| text5 | 被叫信息变量5 | 否 | String |
| text6 | 被叫信息变量6 | 否 | String |
| text7 | 被叫信息变量7 | 否 | String |
| text8 | 被叫信息变量8 | 否 | String |
| text9 | 被叫信息变量9 | 否 | String |
| text10 | 被叫信息变量10 | 否 | String |
请求示例
Request URL:
https://api.laaffic.com/v3/voice/sendIvr
Request Method:
POST
Request Headers:
Content-Type: application/json;charset=UTF-8
Sign: 05d7a50893e22a5c4bb3216ae3396c7c
Timestamp: 1630468800
Api-Key: bDqJFiq9
Request Body:
{
"appId":"4luaKsL2",
"numberList":[
{
"callee":"8613800000000",
"dimensionId":12,
"text1":"tom",
"text2":"12$"
},
{
"callee":"9113800000001",
"dimensionId":12,
"text1":"Olivia",
"text2":"13$"
}
]
}响应参数
| 参数 | 说明 | 类型 |
|---|---|---|
| status | 状态码，0成功，其他失败参见接口响应码 | String |
| reason | 失败原因说明 | String |
| data | 提交结果集合（顺序与提交时顺序一致） | JSONArray |
| voiceId | 记录唯一id | String |
| callee | 被叫号码 | String |
| terminationCode | 状态码0成功 其他失败 | String |
| terminationReason | 状态码描述 | String |
响应示例
{
"status": "0",
"reason": "success",
"data": [
{
"voiceId": "2203031134011000001",
"callee": "8613800000000",
"terminationCode": "0",
"terminationReason": "success"
},
{
"voiceId": "2203031134011000002",
"callee": "9113800000001",
"terminationCode": "101502",
"terminationReason": "Failed to get rates"
}
]
}响应状态码
| status | 状态说明 |
|---|---|
| 0 | 成功 |
| -1 | 账号认证异常 |
| -2 | ip限制 |
| -10 | 余额不足 |
| -16 | 时间戳过期 |
| -18 | 系统异常 |
| -22 | 参数异常 |
| -26 | 获取费率失败 |
此页面的内容有帮助吗？
对接有疑问？联络我们的技术支援
LAAFFIC API 专属 TG 技术对接频道，即时回应您的需求
