tencent cloud

短信

动态与公告
公告
产品简介
常用概念
产品概述
审核标准
使用须知
签名审核标准
正文模板审核标准
正文模板示例
审核驳回原因
国际/港澳台短信
国际/港澳台短信简介
国际/港澳台短信购买指南
国际/港澳台短信快速入门
控制台指南
控制台说明
国际/港澳台短信
营销管理
业务统计
应用管理
通用管理
访问管理
实践教程
如何群发祝福短信
如何实现短信验证码功能
API 文档
History
Introduction
API Category
Making API Requests
Status Pull APIs
SMS Statistics APIs
SMS Signature APIs
SMS Delivery APIs
SMS Mobile Number APIs
SMS Conversion Rate APIs
SMS Template APIs
Data Types
Error Codes
短信回调相关接口
SDK 文档
SDK 下载
Java SDK
PHP SDK
Python SDK
Node.js SDK
C# SDK
Go SDK
C++ SDK
常见问题
费用相关问题
安全相关问题
签名相关问题
模板相关问题
发送内容相关问题
其他问题
相关协议
腾讯云短信数据处理和安全协议
腾讯云短信隐私政策
Service Level Agreement
腾讯云短信服务条款
联系我们

其他问题

PDF
聚焦模式
字号
最后更新时间: 2025-02-24 15:28:29

用户没有收到短信怎么处理?

登录 短信控制台 ,选择统计分析 > 国际/港澳台短信 > 短信记录,查看对应号码的短信发送状态备注
如果发送状态为失败,可结合备注中的失败原因说明进一步排查,常见原因有请求命中了频率控制策略、短信内容格式不正确或手机号已因退订加入黑名单中等。
如果发送状态为成功,但备注中提示错误码,请根据具体 错误码 信息进一步排查。
如果发送状态为成功且备注中提示“用户短信接收成功”,但是用户实际并未收到短信,可以从以下几个方面进行排查:
手机关机、欠费或停机:检查手机状态,例如拨打手机确认。
手机号处于黑名单状态:确认机主是否投诉过运营商或退订过业务。
手机长时间未关机引起无法正常接收短信:可以尝试重启手机。
手机信号异常引起无法正常接收短信:检查手机信号,必要时可尝试重启手机。
手机收件箱满:可尝试删除多余短信。
手机设置异常或硬件异常引起无法正常接收短信:可尝试修改相关设置或将 SIM 卡换到其他手机上进行测试(双卡手机可交换卡槽测试)。
短信被用户手机中的系统/软件拦截屏蔽:检查屏蔽列表。
如仍然无法解决,请提交工单

调用接口耗时比较长怎么办?

如果发现访问腾讯云短信接口时请求耗时较长,可参考以下方法进行定位:
1. 执行dig yun.tim.qq.com命令,确认是否使用内网 DNS。若是使用内网 DNS,则选择一个就近的同运营商的腾讯云短信 IP 配置 host,排查问题是否解决。
如果问题已解决,则说明可能是 DNS 解析卡住或者 DNS 解析跨地域运营商访问引起的时延,建议使用 DNS 代理或配置公网 DNS server。
如果问题未解决,请执行 步骤2
2. 检查业务使用哪种连接模式以及是否使用连接池。
如果业务使用单条长连接,根据 HTTP 一应一答的模式,前面的请求卡住会影响该连接上的后续请求。建议优化成“长连接 + 连接池”模式。
如果业务使用短连接,用 netstat 确认本机连接数是否已满。如果连接数已满,建议优化成“长连接 + 连接池”模式。
用 netstat 确认或用 tcpdump 抓包确认连接的 Recv-Q 和 Send-Q 是否存在积压。如果存在积压,建议优化成“长连接 + 连接池”模式。
如果某条连接长时间(90s)没有请求时,为了防止中间网络设备回收该连接,建议请求方先关闭该连接,等下次发起请求且连接池中连接不够用时再新建连接。

为什么用户很久才收到短信?

1. 查看本地记录的请求发送时间和控制台上记录的该短信发送时间,计算两者之间的时间差。
如果时间差较大(例如接近甚至超过10分钟),则可能是因为调用接口有时延,请参考 调用接口耗时比较长 解决。
如果时间差较小,请执行 步骤2
2. 在控制台查询该短信发送时间状态上报时间,计算两者之间的时间差。
如果时间差较大(例如普通短信超过数10秒,营销短信超过5分钟),可能原因有短信内容有敏感词进入人工审核、手机信号不佳或手机处于异常状态(例如欠费或停机)等。
如果时间差较小,可能原因有手机信号不佳或手机处于异常状态(例如关机)等。
3. 如果以上场景都不满足,请 提交工单

手机黑名单是什么?

目前黑名单有以下类型:
退订用户名单,用户主动对短信内容进行退订回复,例如回复“R”、“T”、“N”、“TD”、“退订”、“T退订”、“QX”或“0000”等(不区分大小写),系统收到回复后会将其手机号加入黑名单中。再次下发短信时会返回发送失败并备注“1015手机号在黑名单库中”,且用户无法成功接收短信。
您可以登录 短信控制台 ,选择通用管理 > 退订用户管理页面提交解除退订状态申请,审核通过后生效。
运营商黑名单,该类用户因不同原因被运营商定为黑名单。下发短信时会返回发送成功,但是可能会因为被运营商网关拦截或其他原因导致用户无法成功接收短信。

返回1004错误如何处理?

调用腾讯云短信接口发送短信时,如果应答包返回1004错误,可通过以下方式定位解决:
1. 检查发送的请求是否为标准的 JSON 格式,建议您到网上搜索 JSON 格式检查工具进行排查校验。例如,误将单引号当做双引号使用,而标准的 JSON 格式应该是使用双引号。
2. 检查参数名称是否正确。
3. 检查请求的字段类型是否与 API 文档 中描述的字段类型一致。 例如,将 JSON 字符串和 JSON 整型混淆使用({"姓名":"小明", "年龄":23},"姓名"应为 JSON 字符串,"年龄"应为 JSON 整型)。
4. 检查请求的字段的取值是否在 API 文档中描述的取值范围内。 例如,international 字段只能取0或1。
5. 检查对 API 的调用是否与 API 文档描述的一致。 例如,调用群发短信的 API 时,包体的格式不能是单发短信的。
6. 如果仍旧无法解决,请 提交工单

返回1014错误如何处理?

调用腾讯云短信接口发送短信时,如果应答包返回1014错误,可通过以下方式定位解决:
1. 确认申请的内容模版格式是否正确。例如内容模版中的“{}”为英文的括号,括号中的数字需从1开始连续编号,即{1},{2}等。
2. 确认模板中是否含变量值,若模板中含变量值,则发送短信时需传入变量进行发送,若模板中设置了多个变量值,则发送短信时也应该传入多个变量进行发送。
3. 确认请求内容对应的模版是否审批通过。
4. 确认请求包中 type 参数的值(0表示普通短信,1表示营销短信)与申请的内容模版类型是否一致。
5. 确认请求的内容与申请的内容模版格式是否一致,例如因空格等不可见字符导致不匹配。
6. 如果内容中含有中文,请确认中文需使用 UTF-8 编码。
7. 中国大陆地区文本短信模板只能发中国大陆手机号,国际/港澳台短信模板只能发境外手机号。
8. 如果仍旧无法解决,请 提交工单

返回1016错误如何处理?

调用腾讯云短信接口发送短信时,如果应答包返回1016错误,可通过以下方式定位解决:
1. 确认 AppID 和 AppKey 是否正确。
2. 确认手机号码格式是否正确。手机号码正确格式为连续数字,无需输入空格。
3. 确认字段名称是否正确。

返回60008错误如何处理?

调用腾讯云短信接口发送短信时,如果应答包返回60008错误,可通过以下方式定位解决:
1. 如果请求在1s内响应60008错误码,请确认请求格式是否是标准 HTTP 格式。
2. 确认请求的 URL 及 Body 格式是否与 API 相符。
3. 确认请求 Content-Type 是否与包体相符(短信服务应该是Content-Type: application/json;charset=utf-8)。
4. 确认 DNS 配置是否正常,确保使用的是公网 DNS server。
5. 推荐业务使用 HTTP 长连接并使用连接池,以提升网络质量。
6. 如果仍旧无法解决,请 提交工单

返回1001(sig 校验失败)错误如何处理?

调用腾讯云短信接口发送短信时,如果应答包返回1001错误,可通过以下方式定位解决:
1. 确认 sig 生成的随机数与 URL 中的随机数是否一致。
2. 确认代码中的 SDK AppID/App Key(SDK AppID 以1400开头)是否填写正确。
3. 确认使用的代码是否跟示例代码一致,检查带入参数生成的 sig 伪代码是否一致。

如何获取短信 API SecretId 和SecretKey?

1. 登录腾讯云管理中心控制台。
2. 前往 云API密钥 的控制台页面。
3. 在云API密钥页面,单击新建密钥即可以创建一对密钥。
SecretId:用于标识 API 调用者身份,可以简单类比为用户名。
SecretKey:用于验证 API 调用者的身份,可以简单类比为密码。
说明:
用户必须严格保管安全凭证,避免泄露,否则将危及财产安全。如已泄漏,请立刻禁用该安全凭证。
短信 SecretId 与 AccessKey ID 是一样的。

如何获取短信 SDK AppID 和 AppKey?

SDK AppID 和 AppKey 是开发者在申请开发新应用时获得的由腾讯云授予的应用程序接入账户和密钥,当您创建应用成功之后即可看到。
SDK AppID:是腾讯云短信应用的唯一标识码,SDK AppID 如下图所示:



AppKey:是用来校验短信发送请求合法性的密码,该密钥在一定技术条件下可保证应用来源的可靠性。

腾讯云短信发送后,对方收到信息是否可以回复,回复是否有时间限制?

对方需要在72小时内回复才有效,回复信息支持查看。

是否支持查看或者接收用户回复的信息?

短信支持用户上行回复,且回复短信不收取额外费用。回复内容可在控制台 短信回复记录 中查看,或设置回调地址获取回复内容。

开通腾讯云短信后,发送消息的号码是什么?

国际/港澳台短信:如果您申请了sender ID会优先显示您所申请的sender ID,如未申请,则可能为Qsms 或 Qcloud或其他信息,不同国家地区显示的信息会不同。

不同的手机在同一时间,是否可以发送不同的短信内容?

可以多进程调用单发接口,实现对不同手机号发送不同短信内容。

发送短信报错,自己排查不出来该怎么办?

您可以 提交工单

短信发送失败,记录提示含有敏感词,但是申请时已通过审核,是什么情况?

敏感词库是由运营商反馈的,可以 提交工单 并提供发送失败的手机号码,人工客服将与运营商沟通确认能否解除。

短信签名和正文已审核通过,是否每发送一次短信都需要进行审核?

个人认证用户使用控制台的发送功能是需先经过审核后才可以发送的,建议升级为企业认证用户。

给某个号码发送了短信,但是该号码未收到短信且控制台短信发送记录查询不到该号码,该怎么处理?

若是通过控制台发送的,建议检查发送文件里号码是否有其他字符,需要删除多余字符。
若是通过接口发送的,建议查看数据是否有正常请求给腾讯云,是否有响应返回。

境外的服务器是否可以正常发送短信?

境外服务器可以调用接口发送短信,域名就近解析,您可以先用 curl 接口测试。

是否支持短信群发?

支持短信群发,调用 发送短信 API 时一次最多不要超过200个手机号,通过控制台群发时单次最多上传10万个手机号。

是否支持号码去重?

从控制台导入号码,平台会针对相同属性的一批号码自动做去重处理。 在一次发送短信的请求中,平台会校验同一短信内容的接收号码是否存在重复,针对重复号码只会正常发送一条。

是否可以开发票?

如果您需要开具发票,可登录费用中心控制台 > 费用账单 > 发票 申请发票。

为什么预览短信内容时,数字会出现星号?例如尊敬的客户,您充值的1**2美元已到账,请在系统查看!

控制台会对数字进行加密入库,所以预览时数字会出现星号,但用户接收到的短信是正常显示的。

国家(或地区)码分别是多少?

国家(或地区)码详情请参 国际/港澳台短信日结后付费价格表

什么是数据中心,我该怎么选择数据中心?

数据中心(又称地域)是指数据中心所在的物理位置,不同数据中心间数据相互隔离,应用资源默认不互通。
当前短信服务可选数据中心包括 新加坡 和 法兰克福 2个数据中心,均可支持发送全球短信,您可根据自身需求选择使用其中一个或多个数据中心。

帮助和支持

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

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

文档反馈