状态不是同一个概念
| 状态 | 含义 | 建议动作 |
|---|---|---|
| accepted | 平台接受请求 | 等待后续状态 |
| submitted | 已提交上游或运营商 | 继续等待 |
| delivered | 收到终端送达回执 | 记录延迟;不等于已读 |
| failed | 发送失败 | 按错误码判断是否重试 |
| expired | 有效期内未送达 | 检查号码、时效和路由 |
| unknown | 没有明确最终结果 | 达到阈值后升级调查 |
Webhook要求
- 验证签名和时间戳
- 按消息ID去重
- 允许状态从中间态推进到终态
- 快速返回2xx,再异步处理业务
- 保留原始回执用于审计
正确区分 accepted、submitted、delivered、failed、expired 和 unknown。
| 状态 | 含义 | 建议动作 |
|---|---|---|
| accepted | 平台接受请求 | 等待后续状态 |
| submitted | 已提交上游或运营商 | 继续等待 |
| delivered | 收到终端送达回执 | 记录延迟;不等于已读 |
| failed | 发送失败 | 按错误码判断是否重试 |
| expired | 有效期内未送达 | 检查号码、时效和路由 |
| unknown | 没有明确最终结果 | 达到阈值后升级调查 |