语音通知 API 限流与并发控制：合理规划外呼节奏

为什么要规划外呼节奏

语音通知依赖真实电话线路，资源有限且成本较高。如果业务方在短时间内瞬间提交大量任务，既可能被平台限流，也可能因为线路拥塞导致接通率下降。合理规划并发与速率，既能保证任务按时送达，也能避免不必要的失败重试，把宝贵的线路资源用在刀刃上。

线路容量参考

互亿无线为客户提供独享外呼线路，单线路规格约为 20 并发、约 2000 通每小时。这意味着：

• 同一时刻最多有 20 通电话正在外呼或通话中，超出部分进入排队等待。
• 按每通约 20 秒播报估算，一小时理论上限约 2000 通，实际会因未接、占线略有波动。
• 套餐无有效期，可根据业务量选择更高并发的线路规格，从容应对增长。

并发规划建议

在业务侧设计提交逻辑时，建议按以下方式控制节奏，避免一次性把队列打满。

1. 令牌桶限速：在提交端实现限速器，把每秒请求数限制在与线路容量匹配的范围内，例如单线路控制在约每秒 1 通左右平滑下发。
2. 分批提交：把批量任务切成多个小批次，每批之间短暂间隔，避免一次性塞入成千上万个号码造成抖动。
3. 错峰调度：非紧急通知尽量避开整点、午间等高峰时段，提升接通率与用户体验。
4. 失败自动补呼：振铃 60 秒未接由平台按自定义次数与间隔重呼，业务侧无需重复提交，避免叠加并发。

被限流后的处理

若返回提示超出频率限制，不要立即疯狂重试，应指数退避后再提交，并适当降低限速阈值。短时间大量重试只会加剧拥塞，反而拖慢整体送达，因此退避间隔要逐步拉长。重要告警类任务建议预留一定并发余量，避免被普通批量任务挤占；可以把告警任务单独走一条限速更宽松的通道。日常监控中应持续观察外呼成功率、排队时长与接通率，及时发现异常，当接近线路上限时提前扩容或错峰，避免在业务高峰出现堆积。完整接口参数与返回码说明见 https://www.ihuyi.com/doc/voice/vm/api 。