“提交成功”和“用户收到”是两件事。理解两者的区别,业务系统对发送状态的判断才不会出错。本文说明提交、记录与回执的关系。 提交成功说明什么 HTTP 请求完成说明接口有响应,业务返回结果说明本次提交的处理情况。国际短信还需要经过后续发送环节…
“提交成功”和“用户收到”是两件事。理解两者的区别,业务系统对发送状态的判断才不会出错。本文说明提交、记录与回执的关系。
提交成功说明什么
HTTP 请求完成说明接口有响应,业务返回结果说明本次提交的处理情况。国际短信还需要经过后续发送环节,提交成功不等于用户已收到。
回执说明什么
回执反映短信的最终发送状态。按开通文档解析回执,字段与状态码以文档为准,不同产品的返回结构不要混用。
- 提交结果:请求是否被受理
- 发送记录:流水与时间信息
- 通道回执:最终发送状态
业务系统怎么处理
保存业务编号、请求时间、目标号码与返回流水号,接收回执后更新状态。回执可能与业务操作不同时到达,处理时做幂等更新,避免重复回调引发多次业务动作。
回执延迟的处理
回执没有按时到达时,先查发送记录确认提交状态,再结合平台记录判断。不要因为回执延迟就重复发送,重复短信反而影响用户体验。确需补发时,由业务系统按重试策略控制。
回执与业务状态管理
回执到达后,把状态更新与业务动作放在同一链路判断。例如订单通知场景,回执确认送达后才标记“已通知”,重复回执不会再次触发动作。业务状态与短信记录保持一致,运营排查才有依据。
排查顺序
用户反映未收到时,从号码格式、内容、发送记录和回执逐项排查。发送状态管理,可访问亿互通国际短信官网查看发送管理说明,或拨打 400 118 6878 联系接入支持。
状态判断的业务规则
业务系统对发送状态的判断,要结合提交结果与回执:提交成功只代表受理,回执才反映最终状态。判断规则在开发时定清楚,业务动作不会因状态误判而错乱。
国际短信的状态管理,以开通文档为准,规则统一,排查也简单。
回执字段的确认
回执字段与状态码的含义,以开通文档为准。字段确认清楚,状态判断才不会出错。不同产品的返回结构不同,按文档解析,不套用其他经验。
回执处理的代码逻辑,建议在开发完成后用模拟数据走一遍,字段解析、状态更新与幂等处理逐项验证,确认无误后再联调真实接口。
