tencent cloud

短信

文档短信API 文档SMS Callback APIsSMS Sending and Delivery Status Error Codes

短信发送和回执状态错误码

下载
聚焦模式
字号
最后更新时间: 2026-11-05 11:49:30

功能说明

若 API 调用失败,用户可以根据错误码列表查询相关的错误信息。
注:若您未在回执状态错误码表中查询到详细错误码信息或者对错误码信息有疑问,请联系 SMS Helper 沟通解决。腾讯云短信团队会根据运营商侧的调整对错误码信息定期进行相应更新。

错误码列表

短信 API 3.0 发送错误码

错误码
描述
InternalError.SigVerificationFail
后端校验 Sig 失败。
FailedOperation.ContainSensitiveWord
短信内容中含有敏感词,请联系 SMS Helper。
InternalError.SigFieldMissing
后端包体中请求包体没有 Sig 字段或 Sig 为空。
FailedOperation.FailResolvePacket
请求包解析失败,通常情况下是由于没有遵守 API 接口说明规范导致的,请参考 请求包体解析1004错误详解。
UnauthorizedOperation.RequestPermissionDeny
请求没有权限,请联系 SMS Helper。
InternalError.OtherError
其他错误,请联系 SMS Helper 并提供失败手机号。
InternalError.Timeout
请求下发短信超时,请参考 60008错误详解。
UnauthorizedOperation.RequestIpNotInWhitelist
请求 IP 不在白名单中,您配置了校验请求来源 IP,但是检测到当前请求 IP 不在配置列表中,如有需要请联系 SMS Helper。
InternalError.RestApiInterfaceNotExist
该 RESTful API 不存在,请核查 RESTful API 接口说明。
FailedOperation.SignatureIncorrectOrUnapproved
签名未审批或格式错误。(1)可登录 短信控制台,核查签名是否已审批并且审批通过;(2)核查是否符合格式规范,签名只能由中英文、数字组成,要求2 - 12个字,若存在疑问可联系 SMS Helper。
LimitExceeded.DeliveryFrequencyLimit
下发短信命中了频率限制策略,可自行到控制台调整短信频率限制策略,如有其他需求请联系 SMS Helper。
FailedOperation.TemplateIncorrectOrUnapproved
模板未审批或内容与审核通过的模板不匹配。(1)请登录 短信控制台 核查模板是否已审核通过;(2)请点击 此处 检查模板格式是否正确。如有疑问,请联系 SMS Helper。
FailedOperation.PhoneNumberInBlacklist
手机号在免打扰名单或退订名单中,通常是用户退订或命中运营商名单导致的。如需解决,请联系 SMS Helper。
InvalidParameterValue.IncorrectPhoneNumber
手机号格式错误。
InvalidParameterValue.ContentLengthLimit
请求的短信内容太长。短信长度计算规则请参见 短信长度计算规则。
InvalidParameterValue.SdkAppIdNotExist
SdkAppId 不存在。请检查该应用 ID 是否属于该账号。
UnauthorizedOperation.SdkAppIdIsDisabled
此 SdkAppId 禁止提供服务,如有需要请联系 SMS Helper。
InternalError.RequestTimeException
请求发起时间不正常,通常是由于您的服务器时间与腾讯云服务器时间差异超过10分钟导致的,请核对服务器时间及 API 接口中的时间字段是否正常。
LimitExceeded.AppDailyLimit
业务短信日下发条数超过设定的上限 ,可自行到控制台调整短信频率限制策略。
LimitExceeded.PhoneNumberThirtySecondLimit
单个手机号30秒内下发短信条数超过设定的上限,可自行到控制台调整短信频率限制策略。
LimitExceeded.PhoneNumberOneHourLimit
单个手机号1小时内下发短信条数超过设定的上限,可自行到控制台调整短信频率限制策略。
LimitExceeded.PhoneNumberDailyLimit
单个手机号日下发短信条数超过设定的上限,可自行到控制台调整短信频率限制策略。
LimitExceeded.PhoneNumberSameContentDailyLimit
单个手机号下发相同内容超过设定的上限,可自行到控制台调整短信频率限制策略。
FailedOperation.MarketingSendTimeConstraint
营销短信发送时间限制,为避免骚扰用户,营销短信只允许在8点到22点发送。
UnsupportedOperation
操作不支持。
FailedOperation.InsufficientBalanceInSmsPackage
套餐包余量不足,请 购买套餐包。
UnauthorizedOperation.IndividualUserMarketingSmsPermissionDeny
个人用户没有发送营销短信的权限,请参见 权益区别。
UnauthorizedOperation.ServiceSuspendDueToArrears
欠费被停止服务,可自行登录腾讯云充值来缴清欠款。
UnsupportedOperation.ContainDomesticAndInternationalPhoneNumber
群发请求中同时包含中国大陆号码和国际号码。请检查:(1)是否使用中国大陆签名或模板向国际号码发送短信;(2)是否使用国际签名或模板向中国大陆号码发送短信。
InvalidParameterValue.TemplateParameterLengthLimit
单个模板变量超过 12 个字符。企业用户无变量字符数上限,您可按照 此处 指引将账号身份类型变更为企业,变更约一小时后生效。
InvalidParameterValue.TemplateParameterFormatError
验证码模板参数格式错误,验证码类模板,模板变量只能传入0 - 6位(包括6位)纯数字。
UnsupportedOperation.UnsupportedRegion
不支持该地区短信下发。
LimitExceeded.PhoneNumberCountLimit
调用接口单次提交的手机号个数超过200个,请遵守 API 接口输入参数 PhoneNumberSet 描述。
LimitExceeded.DailyLimit
当日短信下发条数超过设定上限(国际/港澳台短信)。如需调整限制,请联系 SMS Helper。
InvalidParameterValue.ProhibitedUseUrlInTemplateParameter
禁止在模板变量中使用 URL。
LimitExceeded.AppMainlandChinaDailyLimit
业务短信中国大陆日下发条数超过设定的上限,可自行到控制台应用管理>基础配置下调整发送总量阈值。
LimitExceeded.AppGlobalDailyLimit
业务短信国际/港澳台日下发条数超过设定的上限,可自行到控制台应用管理>基础配置下调整发送总量阈值。
LimitExceeded.AppCountryOrRegionInBlacklist
业务短信国家/地区不在国际港澳台短信发送限制设置的列表中而禁发,可自行到控制台应用管理>基础配置下调整国际港澳台短信发送限制。
LimitExceeded.AppCountryOrRegionDailyLimit
业务短信国家/地区日下发条数超过设定的上限,可自行到控制台应用管理>基础配置下调整国际港澳台短信发送限制。
UnsupportedOperation.ChineseMainlandTemplateToGlobalPhone
中国大陆短信模板不能用于向国际号码发送短信,请使用国际/港澳台短信模板。
UnsupportedOperation.GlobalTemplateToChineseMainlandPhone
国际/港澳台短信模板不能用于向中国大陆号码发送短信,请使用中国大陆短信模板。
FailedOperation.TemplateUnapprovedOrNotExist
模板未审批或不存在。可登录 短信控制台,核查模板是否已审批并审批通过。若存在疑问可联系 SMS Helper。
FailedOperation.TemplateParamSetNotMatchApprovedTemplate
请求内容与审核通过的模板内容不匹配。请检查请求中模板参数的个数是否与申请的模板一致。若存在疑问可联系 SMS Helper。
LimitExceeded.GlobalSmsSendingRateLimit
国际/港澳台短信发送速率已达到配置上限。如有疑问,请联系 SMS Helper。
InternalError.UnknownError
未知错误类型。

短信 API 2.0 发送错误码

错误码
说明
处理措施
1001
sig 校验失败
请核对 API 的 sig 格式说明。
1002
短信内容中含有敏感词
请联系 SMS Helper 沟通解决。
1003
请求包体没有 sig 字段或 sig 为空
请遵守 API 接口说明规范。
1004
请求包解析失败,通常情况下是由于没有遵守 API 接口说明规范导致的
请参考 1004错误详解。
1006
请求没有权限
请查看错误提示语说明,如还有问题请联系 SMS Helper 并提供失败手机号。
1007
其他错误
请查看错误提示语说明。如问题仍存在,请联系 SMS Helper 并提供失败的手机号。
1008
请求下发短信超时
出现概率很低,可重试解决。
1009
请求 IP 不在白名单中
您配置了校验请求来源 IP,但是检测到当前请求 IP 不在配置列表中,如有需要请联系 SMS Helper。
1011
不存在该 REST API 接口
请核查 REST API 接口说明。
1012
签名格式错误或者签名未审批
签名只能由中英文、数字组成,要求2 - 12个字。如果符合签名格式规范,请核查签名是否已审批。
1013
下发短信命中了频率限制策略
可自行到控制台调整短信频率限制策略,如有其他需求请联系 SMS Helper。
1014
模板未审批或请求的内容与审核通过的模板内容不匹配
请参考 1014错误详解。
1015
手机号在免打扰名单或退订名单中,通常是用户退订或命中运营商名单导致的
请联系 SMS Helper 解决。
1016
手机号格式错误
请参考 1016错误详解。
1017
请求的短信内容太长
短信长度计算规则请参见 短信长度计算规则。
1019
sdkappid 不存在
-
1020
sdkappid 已禁用
此 sdkappid 禁止提供服务,如有需要请联系 SMS Helper。
1021
请求发起时间不正常,通常是由于您的服务器时间与腾讯云服务器时间差异超过10分钟导致的
请核对服务器时间及 API 接口中的时间字段是否正常。
1022
业务短信日下发条数超过设定的上限
可自行到控制台调整短信频率限制策略。
1023
单个手机号30秒内下发短信条数超过设定的上限
可自行到控制台调整短信频率限制策略。
1024
单个手机号1小时内下发短信条数超过设定的上限
可自行到控制台调整短信频率限制策略。
1025
单个手机号日下发短信条数超过设定的上限
可自行到控制台调整短信频率限制策略。
1026
单个手机号下发相同内容超过设定的上限
可自行到控制台调整短信频率限制策略。
1029
营销短信发送时间限制
为避免骚扰用户,营销短信只允许在8点到22点发送。
1030
不支持该请求
-
1031
套餐包余量不足
1032
个人用户没有发营销短信的权限
请参见 权益区别。
1033
欠费被停止服务
可自行登录腾讯云充值来缴清欠款。
1034
群发请求里既有中国大陆手机号也有国际/港澳台手机号
中国大陆和国际/港澳台手机号请分开发送。
1036
单个模板变量超过 12 个字符
企业用户无变量字符数上限,您可按照 身份认证变更指引 将账号身份类型变更为企业,该变更约一小时后生效。
1038
验证码类模板,每个变量取值最多支持6位纯数字
-
1045
不支持该地区短信下发
-
1046
调用群发 API 接口单次提交的手机号个数超过200个
请遵守 API 接口说明规范。
1047
国际/港澳台短信日下发条数被限制
如需调整限制,可联系 SMS Helper 解决。
1048
禁止在模板变量中使用 URL
-
1049
中国大陆短信当日发送量超过设定上限
可在控制台调整短信发送频率限制策略。
1050
国际/港澳台短信当日发送量超过设定上限
可在控制台调整短信发送频率限制策略。
1051
短信发送的目标国家/地区在黑名单中
可在控制台调整短信发送限制策略。
1052
发往接收方国家/地区的短信当日发送量超过设定上限
可在控制台调整短信发送频率限制策略。
1053
中国大陆短信模板不能用于向国际号码发送短信
向国际号码发送短信请使用国际/港澳台短信模板。
1054
国际/港澳台短信模板不能用于向中国大陆号码发送短信
向中国大陆号码发送短信请使用中国大陆短信模板。
1055
模板未审批或不存在
可登录 短信控制台,核查模板是否已审批并审批通过。
1056
请求内容与审核通过的模板内容不匹配
请检查请求中模板参数的个数是否与申请的模板一致。
1057
国际/港澳台短信发送速率已达到配置上限
如有疑问,请联系 SMS Helper。
60008
处理请求超时
请参考 60008错误详解。

国际/港澳台短信回执状态错误码

说明:
以下国际/港澳台短信全新标准回执错误码于2026年12月1日开始逐步灰度生效。
下表为国际/港澳台短信的常见回执状态错误码。其中“回执状态”为标准化后的大类状态,“子错误码”为具体的细分原因。若未在下表中查询到详细的错误码信息或者对错误码信息有疑问,请联系 SMS Helper 沟通解决。
错误大类
回执状态
子错误码
说明
成功送达
DELIVRD
000
送达成功。
001
送达成功。
002
送达成功。
003
送达成功。
送达失败
UNDELIV
101
该号码本日接收短信次数超出运营商限制,请次日再试。
102
该短信内容发送频率过高,超出运营商限制,请降低发送频率。
103
该内容重复发送过多,已被运营商拦截,请减少重复内容发送。
104
该 SenderID 未在当前国家/地区注册,请先注册后再发送。
105
该 SenderID 已被用户手机列入免打扰名单,请联系用户自行解除拦截。
106
该短信内容因不合规或未报备被运营商拦截,请检查内容或联系腾讯云运营报备。
107
该短信内容未报备被运营商拦截,请联系腾讯云运营报备。
108
用户手机关机或不在服务区。
109
该号码不存在(空号)。
110
该号码已停机,无法接收短信。
111
用户手机收件箱已满,无法接收新短信,请联系用户清空收件箱。
112
该号段运营商未开通,请核实手机号码是否正确。
113
用户手机未开启漫游,请联系用户开启漫游后重试。
114
号码状态异常,请确认用户号码近期是否携号转网,需转网成功落库后才能正常接收短信。
115
该号码不支持接收短信(如固定电话)。
116
号码无效,请核对号码是否正常在网。
117
手机号码信号异常,暂时无法触达,请稍后重试。
118
手机号码信号异常,暂时无法触达,请稍后重试。
119
手机号码信号异常,暂时无法触达,请稍后重试。
120
无法定位该号码,请核实号码是否有效。
短信过期
EXPIRED
201
送达超时,请确认手机号码状态或稍后重试。
202
送达超时,请确认手机号码状态或稍后重试。
203
送达超时,请确认手机号码状态或稍后重试。
204
运营商网络拥堵,请稍后重试。
205
运营商网络拥堵,请稍后重试。
短信被删除
DELETED
301
短信被运营商拦截,请检查短信内容是否合规或联系腾讯云运营核实。
302
短信被运营商拦截,请检查短信内容是否合规或联系腾讯云运营核实。
303
短信被运营商拦截,请检查短信内容是否合规或联系腾讯云运营核实。
304
该 SenderID 发送频率过高被运营商拦截,请降低发送频率。
305
短信被运营商拦截,请检查短信内容是否合规或联系腾讯云运营核实。
306
短信格式错误,无法送达,请检查短信格式或联系腾讯云运营核实。
短信被拒绝
REJECTD
401
SenderID 格式不符合目标国家/地区要求,请修改后重发。
402
该 SenderID 已被运营商列入黑名单,请重新提交资料申诉/注册。
403
该 SenderID 被运营商拦截,请重新提交资料注册。
404
当前国家/地区不支持该类型的 SenderID,请更换后重发。
405
短信内容含敏感词被拦截,请检查短信内容是否合规。
406
短信内容格式不支持,请修改后重发。
407
短信类型与通道类型不匹配,请修正后重试。
408
短信内容长度超出运营商限制,请精简短信内容。
409
短信内容含敏感词被拦截,请检查短信内容是否合规。
410
短信内容未报备被运营商拦截,请联系腾讯云运营报备后重试。
411
终端号码已开启免打扰(DND),无法接收短信。
412
该号码在运营商防骚扰保护名单中,无法接收短信。
413
当前时段禁止发送营销短信,请调整发送时间。
414
该号码被运营商标记为疑似垃圾短信号码,已被运营商拦截。
415
该号码已被运营商列入黑名单,无法接收短信。
416
消息未送达,未能送达。
未知状态
UNKNOWN
501
运营商未返回送达结果,短信状态未知,请联系腾讯云运营核实。
502
运营商未返回送达结果,短信状态未知,请联系腾讯云运营核实。
503
运营商未返回送达结果,短信状态未知,请联系腾讯云运营核实。
504
运营商未返回送达结果,短信状态未知,请联系腾讯云运营核实。
505
运营商系统异常,短信未送达。
506
运营商线路异常,短信未送达。
507
运营商未返回送达结果,短信状态未知,请联系腾讯云运营核实。
508
运营商未返回送达结果,短信状态未知,请联系腾讯云运营核实。
509
当前国家/地区不支持该短信类型,无法送达。
510
送达超时,运营商未返回具体原因,请联系腾讯云运营核实。
511
运营商未返回送达结果,请联系腾讯云运营核实。
512
运营商未返回送达结果,请联系腾讯云运营核实。
513
运营商未返回送达结果,请联系腾讯云运营核实。
514
运营商未返回送达结果,请联系腾讯云运营核实。
515
运营商未返回送达结果,请联系腾讯云运营核实。
516
运营商未返回送达结果,请联系腾讯云运营核实。
517
运营商未返回送达结果,请联系腾讯云运营核实。
518
运营商未返回送达结果,请联系腾讯云运营核实。
519
运营商未返回送达结果,请联系腾讯云运营核实。
520
运营商未返回送达结果,请联系腾讯云运营核实。
521
运营商未返回送达结果,请联系腾讯云运营核实。
522
运营商未返回送达结果,请联系腾讯云运营核实。
523
运营商未返回送达结果,请联系腾讯云运营核实。
524
运营商未返回送达结果,请联系腾讯云运营核实。
525
运营商未返回送达结果,请联系腾讯云运营核实。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈