向业务系统加入
语音通知调用能力。

准备账户、模板与接收服务

1. 

   创建账户

   开设账户，并按平台要求提供企业认证资料。

2. 

   报备模板

   用真实业务文案报备模板，审核通过后组织发送。

3. 

   获取凭据

   进入语音通知产品模块，获取对应的 API ID 与 API KEY。

4. 

   联调回执

   准备可访问的服务端地址，测试回执接收与确认。

提交一次语音通知请求

接口接受 GET 或 POST；下面采用 HTTPS 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["SURLINK_API_ID"],
    "password": os.environ["SURLINK_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())
# 提交成功不等于呼叫成功，结果请结合回执判断。

提交响应与呼叫回执分开处理

获取账户可用条数

沿用语音账户凭据，将请求方法设为 GetNum，读取当前剩余数量。

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

将电话结果写回业务系统

在平台登记回执接收地址，由服务端接收 POST 结果并更新对应的通知任务。

无人接听（-6）、占线（-4）与拒接（-12）属于不同呼叫状态，需分别记录，与提交阶段的错误区分处理。

按错误类型定位提交问题

完整错误码与动态密码规则请查看 思锐短信平台官方接口文档。实际联调以官方文档与账户配置为准。