短信发送FAQ

运营商的回执是基于用户终端反馈来响应的，因此发送成功而没有收到的情况一般是用户终端问题导致的接收失败。建议按照以下情况排查：

• 手机是否长时间不关机，建议关机重启下。

• 手机收件箱是否已满，建议检查手机是否可以正常接收短信。

• 手机是否为双卡双待，建议将SIM卡拿出来换一下卡槽。

• 手机是否安装了安全软件，安全软件有可能会将短信拦截到垃圾信箱里。

检查完如果还未接收到短信，建议您将SIM卡换到其他手机上进行测试。

国际/港澳台短信无发送时间限制。国内推广短信发送时间一般为8:00~22:00，特殊场景需遵守另行规定，国内通知短信和验证码短信无发送时间限制。

通过审核的签名和模板，如果签名使用场景与模板类型相符，可以任意组合发送短信。

验证码场景的签名，请选择验证码模板；通用场景的签名，请选择验证码、短信通知、推广短信、国际/港澳台短信模板。

短信模板与短信签名在实际使用时没有强关联关系，短信签名实名制认证暂不会影响到您的模板使用。申请模板时选择关联签名是为了提高审核通过率。您创建的模板和签名审核通过后，可以根据实际需求自由搭配发送短信。

若您的短信发送成功率近期显著降低，请您根据以下建议核查发送短信使用的签名状态：

1. 存量签名合规性要求：存量签名若使用已不再支持的签名来源（已备案网站、电商平台店铺、公众号/小程序等），短信将无法正常下发。签名也面临被强制下线风险，建议您及时停用并申请新的签名，以确保短信的正常发送。

2. 签名实名制报备：确保签名来源符合合规性要求后，请您查询短信签名实名制报备结果，并根据各结果的建议进行相应操作。

使用API接口发送短信时，接口调用错误码可以显示短信发送任务的状态。您也可以通过QuerySendDetails接口查询短信发送状态。

在一次请求中，最多可以向100个手机号码分别发送短信。详情请参见SendBatchSms。

支持中国电信、中国联通、中国移动提供的号段，不支持其他虚拟运营商提供的号段。

• 可以在控制台查询发送记录确认是否发送成功，也可以查看API/SDK回执消息确认是否发送成功。更多操作详情，请参见通过控制台发送短信或通过API发送短信。

• 通过API错误码或短信发送状态回执错误码，查看发送失败原因。

• 近期短信发送失败的可能原因：未完成签名实名制报备，发送失败返回的错误码可能为其他值，但实际仍由实名制报备问题导致。请您查询短信签名实名制报备结果，并根据各结果的建议进行相应操作。

• 流控限制：为防止短信被恶意调用，阿里云对短信发送进行限制，触发流控限制后短信会发送失败。

• 携号转网的短信发送：在多数情况下携号转网的信息也能到达。如果运营商未及时更新携号转网路由信息或携号转网24小时内的情况，可能导致短信发送失败。

• 运营商拦截：短信内容可能触发运营商的审核机制，运营商拦截后短信发送失败。

• 终端状态异常：终端网络信号导致接收短信失败。

• 黑名单：机主主动投诉或退订导致发送短信的号码被运营商加入黑名单。

• 国际漫游：取决于运营商之间的国际漫游互联协议，国际漫游不保证一定能接收成功。

• 运营商过滤：部分运营商对短信内容进行“敏感词”过滤。

• 账户余额＜0：国内短信套餐包有余量但账户余额＜0时无法发送短信。

您可通过轻量消息队列（原MNS）消费模式或HTTP批量推送模式获取上行短信内容，详情请参见回执消息配置。

不可以。当前采用智能调度功能，保证客户每次发送均采用最优通道下发，接入号码会有变化。

批量发送短信时，每个手机号发送短信任务互不影响。某个手机号或部分手机号发送失败，不影响其他手机号正常发送短信。

手机端接收显示的号码是106开头的正规号码（通道号+扩展码），由运营商随机分配，不支持固定号码。云通信采用智能决策通道，遇到通道不稳定、网络抖动及机房断电等不可抗拒的因素时，会自动切换通道，通道号会发生变化。

群发助手导入文件的大小不可超过3MB，建议单次导入号码不超过50万个。

通过群发助手发送短信与日常类验证码的发送短信数量没有关系，但给同一个号码下发验证码类短信24小时不要超过40条，超过的部分会被系统拦截。详情请参见群发短信。

为保证您的短信发送成功，请依据当地电信法规发送方需提前注册TFN。

• 如果没有报备SenderID，发送到越南的短信类型只支持OTP，且短信将转换为文本语音通话，以确保OTP的交付。

• 如果已报备SenderID，发送到越南的短信类型支持OTP、推广短信、短信通知。

短信发送后长时间未收到运营商回执状态时，短信状态将显示发送中。建议核实号码状态，比如：空号、关机、停机、飞行模式或手机终端周围基站信号异常等。若手机端72小时内恢复正常，将更新发送状态；若手机端持续异常，返回发送失败。

运营商为降低骚扰短信投诉率，采取了较为严苛的拦截机制。

黑名单是为保护机主免受骚扰短信侵扰的一项保护措施。如果机主有在12321、运营商、工信部等平台投诉过短信内容，使用被投诉的短信签名给该号码下发短信就会返回黑名单相关错误码。

请您核实发送记录，如果没有记录可能存在API调用失败或调用请求没有发出。

• 如果是API调用失败，建议查看本地的回执信息或者日志，参见API错误码查找短信发送失败的原因。

• 如果是发送请求没有发出，建议您检查本地调用程序是否异常。

为防止短信被恶意调用，阿里云对短信发送进行以下限制，触发流控限制后短信将无法正常下发。

您可以将指定号码加入白名单，解除流控限制。更多操作请参见设置短信发送频率。

设置白名单后，阿里云侧将不对该号码进行流控限制。如果发送短信返回GB开头的分钟级或小时级流控表明号码已触发运营商侧的流控限制。更多详情，请参见短信发送频率限制。

有流控限制：针对同一个手机号，每天短信发送的条数不超过20条。

不可以取消。为限制短信被恶意调用、短时间内大量发起短信发送请求，阿里云对短信发送进行流控限制，该限制无法直接取消。

如果您是企业认证用户可以在短信服务控制台设置白名单号码，白名单号码不受短信发送频率限制。更多操作请参见设置短信发送频率。

处于发送中的短信无法取消，也无法删除发送记录。

短信一旦提交发送，无论处于发送中、成功或失败状态，均不支持撤回

您可通过短信服务控制台群发助手发送短信，并设置定时发送任务达成自动发送短信的效果。详情请参见群发短信。

原因可能是发送短信时使用的短信模板和短信签名类型不一致。例如：用验证码签名下发了短信通知或推广短信。

验证码场景的签名，请选择验证码模板；通用场景的签名，请选择验证码、短信通知、推广短信、国际/港澳台短信模板。

“未知状态”短信即发送中的短信。

• 若72小时内，客户终端正常接收到短信，短信状态更新为“发送成功”；未能正常接收到短信，短信状态更新为“发送失败”。

• 若超过72小时，短信状态为“未知状态”。

验证码传入的格式有误，Code值传参时使用字符串格式，需要是JSON格式，否则首位为0会缺失。

错误示例：TemplateParam = {code:0207}

正确示例：TemplateParam = {"code":"0207"}

短信签名和短信模板无关联性，无需绑定。

您创建的模板和签名审核通过后，若签名适用场景为验证码，请搭配验证码模板下发短信；若签名适用场景为通用，您可自由搭配短信模板下发短信。

已删除的签名和短信模板无法直接恢复，需要重新申请签名和模板，审核通过后才可以发送短信。

手机号码格式如下：

• 国内短信：+、+86、0086、86或无任何前缀的11位手机号码，例如：1590000****。

• 国际/港澳台短信：国际区号+号码，例如852000012****。

  重要

  在拨打国际、中国香港、中国澳门和中国台湾的号码时，需要注意号码格式的调整。例如，在越南拨打当地号码时，通常使用区号开头的完整号码（如04987654321，其中04为区号），但在拨打国际号码时，需将国家或地区代码（如越南的84）与本地号码组合，并去掉本地号码前的0，最终格式为844987654321。上传至发送平台时也需遵循此格式。

短信的长度会导致发送记录和实际发送量不一致。

• 发送记录是按发送次数维度统计。短信发送详情，请参见短信发送规则。

• 实际发送量是按费用维度统计。短信计费详情，请参见计费概述。

终端用户收到推广短信后，回复“R”代表不愿意再接收同签名的推广短信，发送方无法解除此限制。

推广短信容易被手机终端安全软件拦截，属于终端厂商的防骚扰策略，云通信侧无法干预调整，建议优化短信文案。

部分终端手机对于特殊字符兼容展示效果不太好，可以参考以下建议：

• 检查短信模板或变量传参是否有不可见字符，如果发现有不可见字符，建议将其去掉后重新下发。

• 如果模板和变量传参不方便更改，建议更换手机重新下发。

针对短信下发失败，目前不支持补发。 您可以在短信服务控制台，发送记录查询页面，导出失败号码，重新调用API接口或使用控制台群发助手发送短信。

• 发送中和待回执的短信，在用户开机后，可以正常接收到短信。

• 发送失败的短信，用户开机后，收不到短信。

请您核实发送号码是否已超过目前所设置的频率或已超过阿里云流控限制的最高值，建议继续调整发送频率，如果已超过最高值，可等24小时后重新发送。

• 短信签名不支持含义模糊、品牌指向不明的中性签名和全数字签名。更多规范详情请参见短信签名规范。

• 内容关键字拦截，是运营商根据短信中有潜在风险或者高投诉的内容关键字进行自动拦截。不同运营商的拦截规则不同，请您检查发送的短信内容并相应修改文案。例如：通知模板禁止发送推广内容、推广短信必须带退订、涉及到金融业务的暂时不支持发送，更多规范详情请参见短信模板规范。

• 可能是发送终端信号不稳定导致的失败，建议重启手机或者换一个信号好的环境重新发送。

• 检查短信发送的主账号和子账号是否异常，如果子账号出现违规或高风险操作，会导致短信发送失败提示内容关键字拦截。例如：是否对账号定期修改登录密码、对AccessKey定期维护更新等。

• 您也可以通过短信发送状态回执错误码查看具体原因。

短信发送的明细记录会保存180天。 如果您需要保留更久的时间，建议您通过调用QuerySendDetails接口获取短信发送记录，自行储存以便后续查询。

短信服务控制台展示的发送记录带星号是为了保障短信内容信息安全，例如：对短信内容中的数字、字母进行脱敏展示。用户实际接收到的短信内容是完整的。如果您需要获取完整的短信内容，可通过QuerySendDetails接口查看发送详情。