发送失败原因排查
号码发送失败时如何看错误码，以及常见失败原因的处理方法。
查询发送记录时，失败号码会返回错误码与失败原因。
错误码分类
| 错误码 | 含义 | 是否退费 |
|---|---|---|
rejected |
通道未受理该号码 | 已退还本条费用 |
not_sent |
经平台核实未发出 | 已退还 |
运营商状态码（如 CR:0217） |
短信已发出，运营商回执失败 | 不退费 |
运营商原始状态码中 0 表示发送成功，其他值为失败状态码，具体原因见失败原因字段。
常见原因与处理
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 整批提交被拒绝 | 余额与流量包不足 | 充值或购买流量包后重新发送 |
| 提示缺少模板参数 | 发送参数未覆盖模板中的全部变量 | 按模板变量名补齐参数 |
| 号码格式错误或重复 | 非中国大陆手机号，或同一请求内号码重复 | 使用 11 位号码，去重后再发送 |
| 运营商回执失败 | 空号、停机、关机、拦截等 | 核对号码有效性，避免短时间内反复发送 |
发送前自查
- 签名与模板均为「已通过」状态。
- 一次最多 200 个号码，支持
13800000000、+8613800000000、8613800000000三种写法。 - 重试时保持同一个
Idempotency-Key，避免重复发送，详见幂等与限流。
这篇文章对您有帮助吗？
没有找到答案？
接口参数、签名方法与错误码请查看开发文档；账户或业务问题可以在控制台提交工单，由平台人工处理。