Submit、GetNum与回执：语音通知接口三件套分工 刚接触语音通知API的开发，常被几个方法名绕晕：Submit、GetNum、回执到底各管什么？其实它们分工很清楚——一个负责发起呼叫、一个负责查余量、一个负责拿结果。本文把这套语音通…
Submit、GetNum与回执：语音通知接口三件套分工
刚接触语音通知API的开发，常被几个方法名绕晕：Submit、GetNum、回执到底各管什么？其实它们分工很清楚——一个负责发起呼叫、一个负责查余量、一个负责拿结果。本文把这套语音通知接口的配合讲透，看完就知道每一步该调谁。
Submit：发起呼叫
调用 Submit 方法，传入账号密码、被叫号码与播报内容，平台返回提交结果。注意：Submit 返回 code=2 仅代表请求提交成功，并不代表对方已接听，必须保存返回的 voiceid 作为后续追溯依据。需要 JSON 响应时，记得显式传 format=json，否则返回格式可能不便解析。
GetNum：查询剩余条数
用 GetNum 方法查询账户剩余可呼叫条数，方便在业务里做余量预警，避免因余额不足导致通知中断。余额不足会返回 4051，建议在定时任务或关键链路里定期调用 GetNum 检查余量。
回执接口：拿呼叫结果
呼叫结束后，通过 voiceid 关联查询呼叫状态与接听时长，判断是否需要补呼。常见状态对应业务动作：
- 已接听 → 通知成功，结束流程
- 未接听 → 按策略触发失败自动补呼或短信协同
- 内容/模板不符 → 检查 4072，核对模板变量
回执什么时候回来？
呼叫结束后，平台会把最终状态回传，可能在提交后的几秒到几十秒之间。业务侧不要在 Submit 返回 code=2 时就当成功，而要等回执：以回执里的呼叫状态和接听时长为准。把 voiceid 写进业务流水表，后续无论是补呼、对账还是客户追问，都能凭它查到这通电话。
余量预警怎么设？
建议每天定时用 GetNum 查一次剩余条数，低于阈值就提前充值，避免余额不足返回 4051、中断关键通知。
为什么 code=2 不等于成功？
因为呼叫是异步的：Submit 只是受理请求，真正拨通要等线路外呼。把 code=2 当成功，会在客户其实没接到电话时误判已通知。务必以回执为准，这也是 voiceid 必须保存的原因。
三个方法配合，就能搭起「提交—查余量—收回执」的完整闭环。思锐提供多语言示例、回执可查，一个接口还能配置语音+短信双提醒。对接细节可咨询 400-118-6878，或免费注册（https://user.ihuyi.com/new/register.html）测试。