语音服务开发对接指南

获取语音服务 APIID 及 APIKEY

在对接前，开发者需要先下载接口文档和相关 DEMO 示例。您可以点击“下载 API 接口文档”，获取多种语言的 DEMO 示例和语音通知对接常见问题说明。

获取 APIID 及 APIKEY 的方法为：登录客户端平台，点击左侧“语音通知”菜单，在页面右上角即可查看 APIID 和 APIKEY 信息。请注意，APIID 与 APIKEY 与用户端登录的用户名密码不同。

为保障安全，查看 APIKEY 时需要经过账户负责人的手机验证。

语音通知接口文档：https://voice.ihuyi.com/support/detail/926.html

语音验证码接口文档：https://voice.ihuyi.com/support/detail/925.html

语音通知模板

在对接测试期间，请务必使用默认的语音通知模板，否则会提交失败。默认模板内容为： “您的订单号是：0648。已由顺风快递发出，请注意查收。”

如需使用企业自定义模板与签名进行调试，必须先完成企业认证并提交模板审核。

查看接口返回状况

对接过程中，您可以通过提交状态接口获取提交状态信息，帮助分析语音通知提交失败的原因。

建议提交失败时的重试次数不要超过 1 次。

如果遇到报错，请参考接口报错代码说明，结合返回的状态码进行问题排查。

账户安全设置

为确保账户使用安全，请进行以下安全设置：

• 绑定 IP：系统仅接受绑定服务器 IP 的请求提交。
• 手机黑名单：系统会自动忽略黑名单中手机号的语音请求。
• 余额提醒：设置余额阈值与提醒手机号，避免余额不足影响通知发送。
• 敏感信息保护：开启后，后台数据中的手机号会部分隐藏，语音内容中的变量部分也会自动脱敏。

技术支持

建议将您企业的工程师加入对接讨论组，便于直接与互亿无线的技术支持工程师沟通。这能够帮助您更快速地完成语音通知接口的接入和调试。