批量群发与变量模板的价值 当业务需要向成百上千个号码发起语音通知时,逐条调用接口既慢又容易出错。互亿无线语音通知支持批量群发,并允许在播报文本中使用变量模板,让一通电话按收件人动态播报姓名、订单号、金额等信息,既提升到达率,又让通知更具针对…
批量群发与变量模板的价值
当业务需要向成百上千个号码发起语音通知时,逐条调用接口既慢又容易出错。互亿无线语音通知支持批量群发,并允许在播报文本中使用变量模板,让一通电话按收件人动态播报姓名、订单号、金额等信息,既提升到达率,又让通知更具针对性。
一、接口地址与核心参数
批量调用仍走统一发送接口 https://api.ihuyi.com/voice/vm,支持 POST 与 GET,返回 JSON。核心参数包括 account、password、mobile 与 content。批量场景下在业务系统中循环提交号码,content 中嵌入变量占位符再按数据替换。
account=APIID&password=APIKey&mobile=13800138000&content=尊敬的{name},您的订单{order}已发货
二、变量模板的编写规则
- 模板正文控制在 1 到 500 字之间,TTS 自动合成语音,无需录音;
- 使用 {变量名} 形式占位,提交时替换为真实数据;
- 数字、金额建议按可读格式拼接,避免读起来生硬;
- 模板需先报备,约 2 小时审核通过后即可使用;
- 单条约 70 字(约 20 秒播报),过长内容应拆分。
三、组合调用的推荐流程
- 在控制台报备语音模板,审核通过后获得可用内容;
- 业务系统准备号码与变量数据,组装成批量列表;
- 循环调用发送接口,将变量替换进 content 字段;
- 根据返回 code 判断受理结果,code 为 2 视为成功;
- 对失败号码记录日志,必要时开启失败自动补呼。
系统按成功计费、失败不计费。批量调用可结合独享外呼线路,单线路 20 并发、约 2000 通每小时,并支持语音加短信双呼,到达率 95% 以上。参数见接口文档,DEMO 见代码示例页面。