语音通知回执接收配置教程：回调对接与去重处理

语音通知回执接收：为什么 code=2 不算送达？

很多开发者第一次对接语音通知回执时会疑惑：接口返回 code=2，为什么用户说没收到电话？这是因为 code=2 仅代表提交成功，平台已受理呼叫；用户是否接听、通话时长多少，需要通过语音通知回执接收回调获取。

回执推送机制

• 平台在呼叫结束后主动 POST 推送到企业配置的回调地址；
• 回执中携带 voiceid，与提交时返回的流水号一一对应，用于关联通知记录；
• 接收端处理完成后必须输出 success，否则平台会重试推送；
• 需处理重复推送：同一 voiceid 可能多次到达，业务侧按 voiceid 幂等去重。

回调地址配置要点

1. 回调地址需公网可访问，建议使用 HTTPS；
2. 接收接口要快：先落库再异步处理，避免超时被判定失败；
3. 按 voiceid 建唯一索引，重复推送直接返回 success；
4. 根据呼叫状态与接听时长安排后续动作：未接听触发失败补呼，长通话可标记为已触达。

回执能做什么

有了回执，企业才能真正统计通知到达率：总提交数、接通数、未接数、补呼后接通数，形成闭环。常见状态包括已接听、未接听、拒接、关机、空号，可按维度汇总成日报，用于线路质量评估与文案优化。

与业务系统联动

回执落库后，可与工单、CRM、运维告警系统打通：告警类通知未接通则自动升级呼叫值班长；营销类未接通则转短信兜底；订单类未接通则安排客服外呼回访。达信通平台同时提供语音与短信协同通道。

达信通 22 年云通信经验、15 万+ 客户、7×24 售后，自主研发平台，资质齐全。回调联调遇到问题？拨打 400-118-6878（工作日 9:00–21:00），或"咨询接入方案"获取回执字段说明。