一个 HTTP 接口，
把语音通知接入业务。

开始之前

1. 创建账户

   注册并按要求完成企业认证。

2. 报备模板

   提交实际业务模板，确认审核通过。

3. 获取凭据

   在用户中心语音通知产品中查看 API ID / API KEY。

4. 联调回执

   配置服务端接收地址，验证完整通知流程。

发送语音通知

使用 HTTPS 提交表单参数。官方接口支持 GET / POST，本站示例使用 POST。

POST https://api.vm.ihuyi.com/webservice/voice.php?method=Submit
Content-Type: application/x-www-form-urlencoded

选择熟悉的开发语言

替换账户环境变量、授权测试号码和已审核模板内容后，在服务端运行。页面只展示代码，不发起呼叫。

import os
import requests

url = "https://api.vm.ihuyi.com/webservice/voice.php"
data = {
    "account": os.environ["YHT_API_ID"],
    "password": os.environ["YHT_API_KEY"],
    "mobile": "YOUR_TEST_MOBILE",
    "content": "已审核模板对应的通知内容",
    "format": "json"
}

response = requests.post(
    url, params={"method": "Submit"},
    data=data, timeout=10
)
response.raise_for_status()
print(response.json())
# 提交成功不等于呼叫成功，结果请结合回执判断。

区分提交结果与呼叫结果

查询账户剩余数量

将 method 改为 GetNum，使用同一语音产品的账户凭据查询余额。

POST https://api.vm.ihuyi.com/webservice/voice.php?method=GetNum

接收呼叫回执

提供服务端接收地址并在平台绑定，亿互通将通过 POST 推送通知结果。

例如无人接听（-6）、正在通话（-4）、用户拒接（-12）应分别记录，不应全部当作接口提交失败。

常见提交错误

完整错误码与动态密码规则请查看 亿互通官方接口文档。实际联调以官方文档与账户配置为准。