运维监控

语音通知批量接口与变量模板组合使用指南

文章详情

批量群发与变量模板的价值 当业务需要向成百上千个号码发起语音通知时,逐条调用接口既慢又容易出错。互亿无线语音通知支持批量群发,并允许在播报文本中使用变量模板,让一通电话按收件人动态播报姓名、订单号、金额等信息,既提升到达率,又让通知更具针对…

批量群发与变量模板的价值

当业务需要向成百上千个号码发起语音通知时,逐条调用接口既慢又容易出错。互亿无线语音通知支持批量群发,并允许在播报文本中使用变量模板,让一通电话按收件人动态播报姓名、订单号、金额等信息,既提升到达率,又让通知更具针对性。

一、接口地址与核心参数

批量调用仍走统一发送接口 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 秒播报),过长内容应拆分。

三、组合调用的推荐流程

  1. 在控制台报备语音模板,审核通过后获得可用内容;
  2. 业务系统准备号码与变量数据,组装成批量列表;
  3. 循环调用发送接口,将变量替换进 content 字段;
  4. 根据返回 code 判断受理结果,code 为 2 视为成功;
  5. 对失败号码记录日志,必要时开启失败自动补呼。

系统按成功计费、失败不计费。批量调用可结合独享外呼线路,单线路 20 并发、约 2000 通每小时,并支持语音加短信双呼,到达率 95% 以上。参数见接口文档,DEMO 见代码示例页面

立即开始使用语音通知 API

注册送10条调试额度 · 3分钟快速接入 · 免费技术支持