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

举报
应用万花筒. 发表于 2021/11/01 09:44:56 2021/11/01
【摘要】 本篇云小课总结了企业用户在使用消息&短信服务的过程中,短信发送失败的常见案例,向您介绍如何通过查询短信错误码,高效处理短信发送失败的问题。

8565626ba8d51d3202e1_900x300.jpg

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

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

2345截图20211102095857.png

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

API调用失败:

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

短信发送失败:

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

2345截图20211029193440.png

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

模板变量校验失败

当返回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。运营人员在审核模板时,会根据您的变量用途做出适当的变量长度调整,如果您的变量长度较长需要扩展变量长度,请详细备注您的变量样例和用途说明,以便运营人员在审核模板时设定适合的变量长度。


签名通道校验失败

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

手机终端问题

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

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

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。