余额不足/欠费语音通知：让用户及时充值

余额不足通知的业务背景

在 SaaS 平台、云通信等业务中，账户余额是用户持续使用服务的前提。仅靠短信提醒打开率不稳定，用户可能未及时查看，业务停机后才被动联系客服。引入语音通知后，系统可在余额低于阈值时主动外呼，播报"您的账户余额不足，请及时充值"，降低因欠费导致的服务中断。互亿无线语音通知 API 无需自建呼叫中心，通过 HTTP 接口即可完成模板播报。

方案架构

典型链路为：计费系统定时扫描余额表 → 命中阈值规则 → 调用语音接口 → 平台外呼用户 → 通话状态与回执回传业务系统，全程秒级完成。

接入步骤与代码示例

接入前在控制台申请 API ID 与 API Key，并报备语音模板，审核约 2 小时通过。发送接口为 https://api.ihuyi.com/voice/vm，支持 POST 与 GET，返回 JSON。以 PHP 为例：

<?php
$url = 'https://api.ihuyi.com/voice/vm';
$data = ['account'=>'YOUR_API_ID','password'=>'YOUR_API_KEY',
  'mobile'=>'13800138000','content'=>'您的账户余额不足，请及时充值。'];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch); // {"code":2,"msg":"提交成功"}

返回 code=2 表示提交成功，其余为错误码。详细参数见 语音通知接口文档，官方还提供多语言代码示例。

关键参数与注意事项

• 单条模板约 70 字（约 20 秒播报），超长内容请拆分。
• 按成功计费、失败不计费，套餐无有效期，注册送 10 条免费调试额度。
• 建议设两档阈值：余额低于 20% 提醒一次、欠费后再提醒一次。
• HTTPS 加密传输，API ID 与 API Key 双重认证，请妥善保管密钥。
• 可结合批量群发，按变量替换用户名、余额等个性化内容。

小结

余额不足语音通知把"被动等充值"转变为"主动触达"，配合 TTS 文本转语音，业务方无需录音即可上线。结合通话状态回传，运营可统计接听率并优化提醒节奏。