【云小课】应用平台第23课 短信发送失败别慌张，小课给你来帮忙

消息&短信 （Message&SMS）是华为云携手全球多家优质运营商和渠道，为企业用户提供的通信服务。具有极速稳定、海量并发、易操作、易管理等优势。企业用户通过调用API或使用群发助手，即可发送验证码、通知和会员推广类短信。

首先，在我们正确创建短信应用、申请短信签名和模板以后，发送短信的流程如下图所示。（如果您是还没有创建短信应用的新用户，请参考国内短信使用全流程。）

在发送短信的过程中，我们可能会遇到以下两种情况：

API调用失败：

通过调用API发送短信时，当短信平台返回了携带API错误码的响应信息，即接口调用失败。请根据返回的API错误码（“status”或“code”），参考API错误码处理。

短信发送失败：

当接口调用成功，或使用群发助手发送短信时，如果短信的发送结果为“失败”，请根据对应的状态码（状态回执错误码），参考状态回执错误码处理。

这里小课为您总结了导致短信发送失败的一些常见原因，通过识别短信错误码，帮助您高效应对短信发送失败的问题。

模板变量校验失败

当返回API错误码为“E200028”时，表示模板变量校验失败，请检查您的API参数是否填写正确。相关参考文档：模板和变量规范、发送短信API。

API错误码

失败原因

处理建议

E200028

API参数填写错误

请检查请求携带的“templateParas”参数值，对照“templateId”指定的模板，核对模板变量个数是否正确，变量长度是否小于模板变量定义的长度。

若“templateId”指定的模板为无变量模板，则请求无需携带“templateParas”参数；若携带了该参数，请置空。

当时间变量需要同时指定日期和时间时，请检查模板中是否将日期和时间配置为两个变量，一个变量传入日期，另一个变量传入时间。不要将日期和时间合成一个变量。

请检查“其他”类型的变量赋值是否包含“.”或“。”字符，建议剔除后重试。如果变量取值为IP地址，请重新申请模板，并设置变量属性为“金额”。

例如：

模板内容为：您的验证码为：，请尽快完成验证。祝您生活愉快！

注：模板中有一个变量，变量属性为“其他号码”，最大长度以8个字符为例。

正确示例：

templateParas='["12345"]'; //发送短信API

templateParas=["12345678"]; //发送分批短信API

错误示例：

templateParas='["123","456"]'; //发送短信API，变量个数不正确

templateParas='["123456789"]'; //发送短信API，变量长度不正确

templateParas='["1a2b.3c"]'; //发送短信API，变量内容类型不正确

说明：

在申请短信模板时，需要选择适合的变量属性。当变量属性选择为“其他”类型时，默认的变量长度为1-20。运营人员在审核模板时，会根据您的变量用途做出适当的变量长度调整，如果您的变量长度较长需要扩展变量长度，请详细备注您的变量样例和用途说明，以便运营人员在审核模板时设定适合的变量长度。

签名通道校验失败

当返回状态码为“E200020”时，表示短信签名通道校验失败，需要检查API参数中的签名通道对应的签名与模板ID对应的签名是否一致，同时检查签名内容是否规范。请参考签名规范。

状态码

失败原因

处理建议

E200020

发送短信携带签名和通道签名不匹配。

签名不规范。

请检查from参数传递的通道号对应的签名和templateId参数（短信模板ID）对应的签名是否一致。如果是通用模板（所属签名为通用签名），则必须携带签名名称（signature参数）。

将签名中的标点符号去掉后重试。

禁用关键字拦截

当返回状态码为“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等

手机终端问题

当通过状态回执错误码查询后，提示为手机终端问题（如手机关机、停机、信号差等）时，建议您核实手机终端是否处于正常状态。

以上，是小课为大家带来的本次内容，还有更多短信问题，请戳常见短信问题

云小课

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。