【云小课】应用平台第23课 短信发送失败别慌张,小课给你来帮忙
消息&短信 (Message&SMS)是华为云携手全球多家优质运营商和渠道,为企业用户提供的通信服务。具有极速稳定、海量并发、易操作、易管理等优势。企业用户通过调用API或使用群发助手,即可发送验证码、通知和会员推广类短信。
首先,在我们正确创建短信应用、申请短信签名和模板以后,发送短信的流程如下图所示。(如果您是还没有创建短信应用的新用户,请参考国内短信使用全流程。)
在发送短信的过程中,我们可能会遇到以下两种情况:
API调用失败:
通过调用API发送短信时,当短信平台返回了携带API错误码的响应信息,即接口调用失败。请根据返回的API错误码(“status”或“code”),参考API错误码处理。
短信发送失败:
当接口调用成功,或使用群发助手发送短信时,如果短信的发送结果为“失败”,请根据对应的状态码(状态回执错误码),参考状态回执错误码处理。
这里小课为您总结了导致短信发送失败的一些常见原因,通过识别短信错误码,帮助您高效应对短信发送失败的问题。
模板变量校验失败
当返回API错误码为“E200028”时,表示模板变量校验失败,请检查您的API参数是否填写正确。相关参考文档:模板和变量规范、发送短信API。
API错误码 |
失败原因 |
处理建议 |
E200028 |
API参数填写错误 |
例如: 模板内容为:您的验证码为:${1},请尽快完成验证。祝您生活愉快! 注:模板中有一个变量,变量属性为“其他号码”,最大长度以8个字符为例。 正确示例: templateParas='["12345"]'; //发送短信API templateParas=["12345678"]; //发送分批短信API 错误示例: templateParas='["123","456"]'; //发送短信API,变量个数不正确 templateParas='["123456789"]'; //发送短信API,变量长度不正确 templateParas='["1a2b.3c"]'; //发送短信API,变量内容类型不正确 |
说明:
在申请短信模板时,需要选择适合的变量属性。当变量属性选择为“其他”类型时,默认的变量长度为1-20。运营人员在审核模板时,会根据您的变量用途做出适当的变量长度调整,如果您的变量长度较长需要扩展变量长度,请详细备注您的变量样例和用途说明,以便运营人员在审核模板时设定适合的变量长度。 |
签名通道校验失败
当返回状态码为“E200020”时,表示短信签名通道校验失败,需要检查API参数中的签名通道对应的签名与模板ID对应的签名是否一致,同时检查签名内容是否规范。请参考签名规范。
状态码 |
失败原因 |
处理建议 |
E200020 |
|
|
禁用关键字拦截
当返回状态码为“SC:0006”时,表示短信因包含禁用关键字被拦截。请参考模板和变量规范。
状态码 |
失败原因 |
处理建议 |
SC:0006 |
短信内容不合规,触发安全管控拦截。 |
请检查短信内容是否包含敏感词,修改模板变量内容后重试。 |
短信发送超频
当返回“SC:0010”等以下状态码时,表示短信发送超频。点击了解短信发送频率限制。
状态码 |
失败原因 |
处理建议 |
SC:0010 |
短信发送频率过高,触发安全管控拦截。 |
请控制短信发送频率,分时段分批次发送短信。 出现超频限制24小时后会自动解除,请待超频限制解除之后再尝试发送。 |
FYLIMIT |
||
MILIMIT |
一分钟内单个号码发送了太多短信。 |
等待一分钟后再给该号码发送短信; |
LIMIT |
当日给单个号码发送的短信已经达到了下发限制。 |
等到第二天再给该号码发送短信; |
BEYONDN |
||
说明:
如果发生短信发送超频限制,建议减少发送次数。如果有业务需求,可以联系华为云客服沟通解除下发限制。 同类的状态码还有:CA:1000,CS.0012,GL:0000,MD:9419,MAXFREQ等 |
号码黑名单
当返回“BLACK”、“MBBLACK”等以下状态码时,表示号码黑名单。
状态码 |
失败原因 |
处理建议 |
BLACK |
手机号码位于黑名单中,可能是该号码回复过退订信息或者该号码用户向工信部投诉过。 |
如确认该手机需要接收短信,请联系华为云客服解除黑名单。 |
TDBLACK |
||
TSBLACK |
||
MBBLACK |
||
SC:0005 |
投诉黑名单。接收号码状态特殊,触发安全管控拦截。 |
请从接收号码列表中剔除特殊号码后重试。 |
SC:0003 |
黑名单拦截。接收号码状态特殊,触发安全管控拦截。 |
请提供号码信息,联系华为云客服申请解除黑名单。 |
说明:
不同平台、供应商或运营商会返回不同的黑名单拦截状态码,建议联系华为云客服申请解除黑名单。 同类的状态码还有:-10,KA:0023,CM:8003,DB:0144,MA:0027,MK:100D,DB:0141,MX:0011,MX:0005,SW:0009,DB:9006,SUPERWD等 |
手机终端问题
当通过状态回执错误码查询后,提示为手机终端问题(如手机关机、停机、信号差等)时,建议您核实手机终端是否处于正常状态。
以上,是小课为大家带来的本次内容,还有更多短信问题,请戳常见短信问题
- 点赞
- 收藏
- 关注作者
评论(0)