通过API使用语音通知/语音验证码

使用须知

• 文本转语音模板和语音通知文件审核通过后才可以使用。

• 针对同一个“资质信息+号码用途”，呼叫同一个被叫方时进行流控限制：1次/分钟、5次/小时、20次/24小时（从第一次正常通话开始计时），请合理使用。更多有关流控内容，请参见流控规则介绍。

准备工作

• 注册阿里云账号完成企业实名认证后开通语音服务。

• 申请企业资质并审核通过，操作步骤请参见企业资质管理。

• 申请话术并审核通过。申请话术的目的是业务场景报备，话术内容后续不会应用于语音通话，详情请参见新增话术。

• 若选用公共模式进行通话（推荐使用），无需自行购买号码，由阿里云提供统一的号码池。若选用专属模式则需要申请真实号码；

• 调用API接口前，可以查看API概览了解接口说明，并查询必选的请求参数。发送请求后报错时，可以在API错误码文档中获取错误信息。

使用流程

步骤一：准备通话内容

通话内容包含文本转语音模板和语音文件，推荐使用控制台申请通话内容并查询审核状态，审核通过后即可发起语音通话。

• 文本转语音模板：暂不支持通过API接口创建，请通过语音服务控制台创建。操作步骤请参见创建语音模板。

• 语音文件：支持通过API、SDK接口上传和控制台上传，调用API或使用SDK上传操作步骤请参见通过API上传语音文件。

  说明

  语音文件上传后，可通过QueryVoiceFileAuditInfo查询审核状态，若审核不通过，请查看失败原因后重新上传语音文件。

步骤二：发起语音通话

根据业务需要调用相应的API接口发起语音通知或语音验证码，在调用接口前请仔细阅读参数描述。

步骤三：查询通话详情

相关文档

• API在线调试：访问OpenAPI开发者门户，可以在线调试接口、查看完整请求参数和自动生成各种语言的SDK示例代码。

• 错误码查询：调用API返回错误时，请参考API错误码文档排查问题。

• 常见问题：

  • 公共模式/专属模式FAQ

  • 语音计费FAQ

  • 语音模板FAQ

  • API&SDK常见问题