排障指南
短信显示发送成功,客户却没收到?按这个顺序排查
接口或后台显示“发送成功”,多数情况下只代表平台已经接收了你的提交,不代表短信已经到达客户手机。排查时先查这条短信的状态回执:回执是失败的,按失败原因处理;回执是成功、客户却说没看到,重点查手机拦截、退订和防骚扰设置。还找不到原因,就把手机号、发送时间、短信内容和回执状态一起发给服务商查。
先分清三种“成功”
| 阶段 | 含义 | 在哪里看 |
|---|---|---|
| 提交成功 | 平台已经接收你的发送请求 | 接口返回值、后台提交记录 |
| 回执成功 | 运营商返回了送达结果 | 状态回执(状态报告)、后台发送明细 |
| 客户看到 | 短信出现在客户的收件箱里 | 只能请客户确认,可能被拦截 |
很多“发送成功却没收到”,其实只看了“提交成功”,没有看回执。
按五步排查
- 查状态回执。 在后台发送明细或 API 回执回调里,找到这条短信的结果。没有接入回执,就只能看到“提交成功”,建议尽快接入。回执状态码的含义各通道、各运营商不完全一样,要以服务商提供的说明为准,不要直接套用网上的对照表。回执迟迟没回来,先等一段时间再查,同时记下来,报障时一起说明。
- 查号码本身。 看号码有没有多一位、少一位,有没有带空格或国家码;号码是否空号、停机、欠费、关机或长时间无信号;是否携号转网或在境外漫游。这类原因通常会体现在失败回执里。
- 查手机端拦截、退订和防骚扰。
- 查签名、模板和内容。 签名或模板未通过报备、实际发送内容和报备模板对不上,都可能被拦截,参见签名与模板报备。通知短信夹带了优惠推广、营销短信没附退订方式、链接打不开或来源不明、内容含敏感词,也是常见原因,参见通知短信内容规范。
- 查发送策略和通道。 同一号码短时间内重复发送,可能触发频率限制(验证码场景尤其常见,见验证码短信选型);营销短信在服务商规定的时段之外提交,可能被延后或拒绝;账户余额或额度不足也会导致发送失败。如果失败集中在某个运营商、某个地区或某个时间段,多半是通道或运营商侧的问题,交给服务商排查。
报障时提供这些信息
服务商排查需要定位到具体的那一条短信,信息越完整,查得越快:
- 完整手机号(只提供给服务商,注意保护客户信息)
- 发送时间,精确到分钟
- 签名、模板编号或完整的短信内容
- 接口返回的消息编号或批次号
- 回执状态码和描述(如有)
- 影响范围:是单个号码还是一批?是否集中在某个运营商或地区?
- 客户手机是否开启了拦截软件或防骚扰服务(如了解)
《通信短信息服务管理规定》第13条要求,短信服务提供者留存短信发送和接收时间、发送端和接收端码号等信息不少于6个月。发现问题后尽早报障,查起来更容易。
日常预防清单
- 接入状态回执,并把结果写进自己的日志
- 重要短信(验证码、预约变更等)失败后设置重推,或用其他渠道补充
- 定期清理停机、空号等无效号码
- 验证码、通知、营销分开模板和签名
- 签名用企业全称、简称或注册商标,客户一眼能认出来
- 营销短信只发给已同意接收的用户,附退订方式,退订及时生效
- 对验证码接口做频率限制,避免被刷
- 按运营商、地区、时段定期看送达情况,发现集中异常尽早反馈
佛山市金枝网络科技有限公司(一枝云AI)持有跨地区增值电信业务经营许可证 B2-20190966,106短信支持状态回执和发送明细查询。遇到收不到的问题,可以点页面右下角“在线咨询”,带上上面的信息,我们协助排查;也可以提交需求。
常见问题
回执显示已送达,客户还是说没收到,是怎么回事?
常见原因是短信被手机自带的骚扰拦截、安全软件或运营商的“来电来信免打扰”服务归入了拦截或垃圾信息。可以请客户查看手机的拦截记录,并确认是否开通了相关防护服务。签名用企业全称或注册商标、内容不夹带营销,也有助于客户认出并找到短信。
只有个别客户收不到,正常吗?
少量失败通常和号码状态(停机、关机、欠费、空号)或手机拦截有关,逐个看回执就能定位。如果失败集中在某个运营商、某个地区或某个时间段,更可能是通道或运营商侧的问题,应尽快带上明细联系服务商。
客户退订后,还能收到我们的短信吗?
《通信短信息服务管理规定》第23条规定,接收方明确拒绝接收商业性短信后,服务提供者不得再向其传输相关商业性短信。通知类短信是否受影响,以服务商的退订处理规则为准。建议营销和通知分开模板,避免混淆。
服务商能确保每条短信都送达吗?
不能。用户关机、停机、信号差、开启拦截等情况,服务商无法单方面控制。比较实际的做法是接入状态回执,对失败的重要短信设置重推,或者用电话、App 推送等其他渠道补充触达。
发送失败的短信计费吗?
计费口径因服务商而异,有的按提交计费,有的按成功计费,长短信还会拆成多条计费。签约前问清楚,并按回执核对账单。