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

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

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

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

API调用失败

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

短信发送失败

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

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

模板变量校验失败

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

API错误码	失败原因	处理建议
E200028	API参数填写错误	请检查请求携带的“templateParas”参数值，对照“templateId”指定的模板，核对模板变量个数是否正确，变量长度是否小于模板变量定义的长度。若“templateId”指定的模板为无变量模板，则请求无需携带“templateParas”参数；若携带了该参数，请置空。请检查“其他”类型的变量赋值是否包含“.”或“。”字符，建议剔除后重试。如果变量取值为IP地址，请重新申请模板，并设置变量属性为“金额”。例如：模板内容为：您的验证码为：${1}，请尽快完成验证。祝您生活愉快！注：模板中有一个变量，变量属性为“其他号码”，最大长度以8个字符为例。正确示例： templateParas='["12345"]'; //发送短信API templateParas=["12345678"]; //发送分批短信API 错误示例： templateParas='["123","456"]'; //发送短信API，变量个数不正确 templateParas='["123456789"]'; //发送短信API，变量长度不正确 templateParas='["1a2b.3c"]'; //发送短信API，变量内容类型不正确
说明：在申请短信模板时，需要选择适合的变量属性。当变量属性选择为“其他”类型时，默认的变量长度为1-20。运营人员在审核模板时，会根据您的变量用途做出适当的变量长度调整，如果您的变量长度较长需要扩展变量长度，请详细备注您的变量样例和用途说明，以便运营人员在审核模板时设定适合的变量长度。

API错误码

失败原因

处理建议

E200028

API参数填写错误

请检查请求携带的“templateParas”参数值，对照“templateId”指定的模板，核对模板变量个数是否正确，变量长度是否小于模板变量定义的长度。
若“templateId”指定的模板为无变量模板，则请求无需携带“templateParas”参数；若携带了该参数，请置空。
请检查“其他”类型的变量赋值是否包含“.”或“。”字符，建议剔除后重试。如果变量取值为IP地址，请重新申请模板，并设置变量属性为“金额”。

例如：

模板内容为：您的验证码为：${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	发送短信携带签名和通道签名不匹配。签名不规范。	请检查from参数传递的通道号对应的签名和templateId参数（短信模板ID）对应的签名是否一致。如果是通用模板（所属签名为通用签名），则必须携带签名名称（signature参数）。将签名中的标点符号去掉后重试。

禁用关键字拦截

当返回状态码为“SC:0006”时，表示短信因包含禁用关键字被拦截。请参考模板和变量规范。

状态码	失败原因	处理建议
SC:0006	短信内容不合规，触发安全管控拦截。	请检查短信内容是否包含敏感词，修改模板变量内容后重试。

短信发送超频

当返回“SC:0010”等以下状态码时，表示短信发送超频。点击了解短信发送频率限制。

状态码	失败原因	处理建议
SC:0010	短信发送频率过高，触发安全管控拦截。	请控制短信发送频率，分时段分批次发送短信。出现超频限制24小时后会自动解除，请待超频限制解除之后再尝试发送。
FYLIMIT	短信发送频率过高，触发安全管控拦截。	请控制短信发送频率，分时段分批次发送短信。出现超频限制24小时后会自动解除，请待超频限制解除之后再尝试发送。
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

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

（完）