分清接口响应、呼叫回执和业务完成,准确记录每一条通知。
第一步:请求是否被接收
调用 Submit 后,响应中的 code=2 表示提交成功。保存返回的 voiceid 作为平台流水号,并将其与内部订单或工单标识关联。此时不能认定用户已经接听。
第二步:等待呼叫回执
配置回执接收地址后,平台通过 POST 推送呼叫结果。回执包含 code、msg、mobilephone、talktime、voiceid 和 report_time。依据 voiceid 找到对应通知记录,再更新状态。
第三步:正确确认回执
成功接收并可靠保存回执后,按文档输出小写 success。由于可能出现重复推送,接收端应能处理同一回执的重复到达,避免重复触发后续业务动作。
两个 code 的语境不同
提交响应 code=2 表示平台接收请求,呼叫回执 code=2 表示呼叫成功。两类状态应分别存储,不应让同名字段掩盖它们对应的不同阶段。
业务完成还需单独判断
即使用户接听,也不能据此断言用户理解了内容、领取了包裹或解决了故障。业务完成应以订单、工单、签到或账户状态为准。
接口参数参考 达信通语音通知官方文档。流程编排为实施建议,具体能力按实际开通方案确认。返回场景实验室