什么是语音通知 API 语音通知 API 是一种通过 HTTP 接口向企业业务系统开放的自动外呼能力。开发者只需在自己的系统中调用接口，传入目标手机号与播报文本，平台即可自动发起一通电话，将文本内容以语音形式播放给接听用户。相比人工坐席逐通…
什么是语音通知 API
语音通知 API 是一种通过 HTTP 接口向企业业务系统开放的自动外呼能力。开发者只需在自己的系统中调用接口，传入目标手机号与播报文本，平台即可自动发起一通电话，将文本内容以语音形式播放给接听用户。相比人工坐席逐通拨打电话，它把通知动作从"人打电话"变成了"系统调接口"，从而把单通通知的边际成本与耗时大幅降低，尤其适合需要批量、定时、触达用户的业务场景。
它的工作流程
一次完整的语音通知通常经历四个环节：
- 业务系统调用发送接口
https://api.ihuyi.com/voice/vm，传入 account、password、mobile、content 等参数； - 平台通过 TTS 文本转语音将播报文本实时合成为语音流；
- 外呼线路向目标手机号发起呼叫，用户接听后自动播放语音内容；
- 平台回传呼叫状态、通话时长与接听时间，开发者可通过状态查询接口或回调推送获取送达结果。
接口返回示例为 {"code":2,"msg":"提交成功"}，其中 code=2 表示任务已成功受理，并不代表用户已经接听，实际送达情况仍需以后续回传的呼叫状态为准。开发者在系统设计时应区分"提交成功"与"用户接听"两个节点，避免误判送达效果。
典型应用场景
- 电商与物流：下单成功提醒、发货通知、派件到达提醒；
- 金融与风控：登录验证码、交易提醒、逾期催缴、风险预警；
- 政务与公共事务：疫苗接种提醒、开庭通知、应急预警；
- 企业内部：考勤异常提醒、会议通知、系统故障告警。
与普通电话的区别
普通电话需要真人坐席逐通拨打，受限于人力规模与工作时段，夜间与节假日几乎无法触达；语音通知 API 由系统批量触发，可在短时间内完成大量呼叫，并支持在模板中插入自定义变量实现个性化播报，例如把订单号、金额、姓名嵌入同一条语音。
在实际接入中，企业通常把语音通知嵌入自己的业务流程：用户下单后系统自动触发接口，通话状态通过回调推送回写订单表，运营在后台即可看到哪些通知已送达、哪些待补呼。通话状态回传通常包含接听状态、通话时长、挂断时间等字段，便于业务系统自动归档。互亿无线语音通知服务采用 API ID 与 API Key 双重认证，全程 HTTPS 加密传输，模板报备约 2 小时审核通过，企业接入门槛较低。详细的参数说明与请求示例可查阅语音通知接口文档。