验证码、通知短信API常见使用问题
如今短信应用于我们生活工作的方方面面,注册或者登录一个应用可以用短信验证码快速登录,支付可以使用短信验证码;商家搞促销活动可以发送通知短信给客户,会员到期了商家可以发送告警短信给会员用户…可见验证码短信API和通知短信API是非常被需要、热门的API了。
在这里给大家推荐 APISpace 的验证码短信API和通知短信API,它们支持三大运营商,虚拟运营商短信发送,电信级运维保障,独享专用通道,3秒可达,99.99%到达率,支持大容量高并发。大家在使用短信API的时候也是遇到了各种各样的问题,在这里我就把短信API使用过程中遇到的各种问题进行了汇总,希望可以帮助到大家~
问题汇总
1. 签名和模板规范
Q:什么是短信签名?
短信签名是加在短信的开头,在【】里加上您的公司名称或店铺名称的标识符,字数要求 2-20个字符。例如:【Eolink】。
根据电信基础运营商的规定,每条短信前必须附加短信签名,否则将无法正常发送。
Q:返回签名错误,什么原因?
查看签名是否合规。签名规范:
- 建议签名内容为短信发送方的真实应用名称。
- 短信签名作为短信发送者属性的一种标识,签名必须用于标识产品名称或业务,禁止发送涉及:色情、赌博、毒品、党政、法律维权、众筹、慈善募捐、宗教、迷信、股票、留学移民、面试招聘、博彩、贷款、催款还款、信用卡提额、投资理财、中奖、抽奖、一元夺宝、一元秒杀、一元云购、二类电商、A货、烟酒、交友、暴力、恐吓、皮草、返现返利、代开发票、运营商禁止发送的信息、代理注册、代办证件、加群、加QQ或者加微信、贩卖个人信息、运营商业务、流量营销、违反广告法用语、殡葬、刷单、做任务、空包网、邀请好评、转店类、拉新、众包业务等内容的短信。若签名内容侵犯到第三方权益,必须获得第三方授权。
- 短信签名必须具有实际意义。不支持含义模糊的中性签名,如“客服通知”、“客户您好”等。
- 字数要求2-20个字符。
Q:短信模板有什么限制?
- 短信模板需明确表述短信发送的实际内容。所有模板均禁止发送金融相关的所有内容。
- 不支持发送未经许可的信息,主要指邀请注册、邀请成为会员的商业性信息。
- 禁止发送涉及:色情、赌博、毒品、党政、法律维权、众筹、慈善募捐、宗教、迷信、股票、留学移民、面试招聘、博彩、贷款、催款还款、信用卡提额、投资理财、中奖、抽奖、一元夺宝、一元秒杀、一元云购、二类电商、A货、烟酒、交友、暴力、恐吓、皮草、返现返利、代开发票、运营商禁止发送的信息、代理注册、代办证件、加群、加QQ或者加微信、贩卖个人信息、运营商业务、流量营销、违反广告法用语、殡葬、刷单、做任务、空包网、邀请好评、转店类、拉新、众包业务、POS机、积分兑换等内容的短信。禁止在关键字或关键信息中出现错别字、变体字、异体字、各类干扰符号等;禁止出现各类非正常混合字以及非常用的表达法。不支持内容中含有直接或间接访问应用内测分发平台的行为。
- 地产、留学、招聘、交友、游戏等行业仅支持发送验证码短信。
- 短信模板支持 emoji 特殊表情符号;
- 支持变量短信模板;
- 变量名称不能带有任何特殊符号;
- 短信模板内不能包含【】符号,模板内容首尾位置也不可使用,否则将会影响发送。
Q:模板无法通过审核的原因是什么?
如果您的内容含有敏感词或者内容违规违法,将无法通过审核。
2. 短信使用限制
Q:报备是什么意思?
报备的意思是需要提交短信模板。在报备后,您再提交短信时,平台会自动匹配审核通过的模板,匹配成功任意一个模板即可发送,短信报备是针对自己账号进行的报备,没有报备的话会进入人工审核。
Q:可以同时发多个手机吗?
可以,群发短信使用post方式,一次支持 1000 号码一个包,每个包间隔 1至 2秒提交。
Q:三网(移动、联通和电信)都可以发吗?
是的。三网都支持,全国号码都可以发。
Q:发送时间段有限制吗?
行业短信的发送时间段没有限制。实际使用时,请以不打扰用户正常作息时间为前提。
Q:短信发送字数有限制吗?
- 短信字数<=70个字,按照 70个字一条短信计算
- 短信字数>70个字,即为长短信,按照 67个字记为一条短信计算
注意:短信签名是包含算在计费字数里。
Q:短信能测试吗?
可以。注册账户后,申请API即可进行测试。但是要注意测试的短信中,无论是签名还是短信内容不要携带【测试】的字眼,需要模拟真实场景发送短信。
行业短信一天内一个手机号的接收次数限制默认是 10条,一天的计算时间是凌晨一点开始计算。
Q:哪些情况手机号会进入黑名单?
之前投诉过运营商,如打过 10086、10010或 10000投诉的,可能会被运营商加入黑名单;有过退订历史,如回复过含有 T、TD、退订或取消等代表拒绝接收短信的指令。
Q:手机号进黑名单了,怎么办?
您可以选择:
- 如果联系客服解除黑名单,需要您提供要解除黑名单的手机号;
- 如果是验证码短信进入黑名单,可以使用语音验证码服务。
Q:短信规格是什么?
中文:70字符,英文:160字符,支持发送长短信,中文:67字符;英文 153字符;多出字符部分自动计算成第二条。一般显示为一条短信。极少数为多条显示。
Q:你们的通道号码是 106开头的吗?
是的,都是 106开头的号码。
Q:短信变量有长度限制嘛?
变量最大长度是30。
Q:提交短信的频率有限制吗?
没有限制。如想更快的提交短信,可以使用多线程提交,但相同手机号为防止骚扰,会限制频率和日上限。
Q:通知短信接口可以查询短信发送报告嘛?
在通知短信的介绍页有open API可以查询短信的发送报告。
Q:行业短信和营销短信的区别?
行业短信是指向不同的客户发送手机短信的业务,短信内容一般为验证码信息、通知信息、触发类信息等不带任何营销字眼的短信。
示例:【Eolink】亲爱的用户,您的短信验证码为###,5分钟内有效,若非本人操作请忽略。(#为变量)
营销短信指短信内容一般为经营性企业向App、网站注册会员下发会员活动信息等明显带营销类推广短信(强调:凡是营销类短信内容短信,要添加“退订回复D”)
示例:【Eolink】尊敬的用户:618高温补贴,清凉来袭!现登录最高可得100元现金!点击查看:https://www.apispace.com 退订回复D
验证码短信、通知短信、语音通知,均不支持发送营销类性质的短信。
3. 短信调用问题
Q:发送后没收到是什么原因?
首先确认API调用后的返回状态码。
- 如果API返回失败,请按具体返回的状态码代码和出错提示排查。
- 如果API返回成功,请检查:
a. 手机是否处于关机或欠费停机状态,可以拨打手机号码确认;
b. 请检查手机信号是否正常,必要时重启一下手机;
c. 是否被短信屏蔽软件拦截,检查是否在屏蔽的短信列表中;
d. 通过接口查询短信接受状态和错误代码。
Q:发送中什么意思?
手机可能处于无法拨通,或关机,或信号不稳定的状态,一时半会运营商那边没有返回值,所以短信还在运营商那边发送中状态, 72小时以后都会有状态返还回来。如果是个别号码处于发送中状态,那就是号码信号问题,当时下发时的号码所处信号弱,或者信箱满。还有个别智能手机需要重启激活才能收到。一般发生延迟都是手机信号弱,关机,短时间内停机导致。
Q:为什么会重复收到短信?
- 检查您的程序是否重复提交的问题;
- 极端情况下,由于手机端未正确返回确认信号给运营商,造成运营商认为手机没有接受成功,尝试重试发送。请重启手机解决,必要的时候,取出手机卡,插入接受正常的手机接受完短信再插回原来的手机。
Q:为什么发送失败?
用户在没有开通国际漫游的前提下在所处区域是无法收到任何信息;还有一些其他常见问题,如网关问题、手机号码错误、无法接通、停机等。
Q:为什么出现批量短信发送被驳回?
如出现批量短信发送驳回的情况,可能为“敏感词拦截”进入人工审核。
Q:为什么发送时间和接收时间相差几分钟?
跟模板的内容有关,比如模板内容带链接,如果没有提交审核的模板带链接就可能会进入人工审核,此时要等人工审核完才会发送,因此时间较久。
解决办法是联系客服人员进行模板报备,报备成功后,后续的请求都能够即时发送。