了解语音产品

语音通知（Voice Notification）向手机号发起真实的语音呼叫，接通后以 TTS 播报模板内容（或播放录制的音频），适用于订单提醒、物流通知、会议邀约、风险告警、验证提醒等需要强触达的场景。相比短信，电话呼叫的到达感知更强，适合重要且时效性高的通知。

开始前的准备

• 已开通语音产品，并创建了 API Key（参见 快速开始 的准备工作）
• 理解两个基本概念：模板（呼叫播报的内容，需审核通过）与任务（一次向一批号码发起的呼叫）

呼叫链路

一次语音通知的完整生命周期：

1. 提交：通过 Console 呼叫任务 或 发送 API 提交一批号码与模板
2. 受理：平台校验参数、模板、余额后受理任务（API 返回 000000 与 callId）
3. 外呼：平台按模板绑定的国家选择线路发起呼叫；未接通时按配置的重拨策略重试
4. 终态：每通呼叫到达终态（接通挂断 / 无人接听 / 无法接通）
5. 结果：通过 发送记录、查询 API 或 话单推送 获取每通结果

能力一览

边界：当前面向通知场景的单向外呼，不支持 IVR 按键交互、来电接听或录音上传以外的语音处理。

常见问题

API 受理成功后为何仍可能失败？

受理只完成参数与资源校验；实际外呼受被叫状态、线路、国家路由影响。逐通结果请查看 发送记录，失败原因见 错误代码。

应从哪里开始？

建议顺序：快速开始（用测试白名单发一通真实呼叫）→ 使用语音控制台 → 发起呼叫 → API 参考。

相关资源

• 快速开始：发送第一条语音通知
• 使用语音控制台
• 发起呼叫：单次与批量
• 查看结果：发送记录与话单推送
• 常见问题