短信使用手册
更新时间: 2024/08/08 17:51:01
短信介绍
网易短信功能具体有全网覆盖、3-5 秒可达、超高到达率、7*24 小时服务监控等优势。
云信短信组成
按照区域分,云信目前提供 国内短信 和 国际/港澳台短信。
按照短信类型分,云信目前提供验证码短信(包含文本验证码短信和语音验证码短信)、通知类短信、营销类短信,视频短信等,其中验证码短信可提供验证码生成服务。
每条云信短信由短信签名+短信正文模版内容组成,短信长度限制为 500 字。
短信签名
-
“短信签名”可以是您的公司简称、品牌名或网站名(建议为应用名),提交后需审核;
-
每种类型的短信模版创建一个短信签名,一个应用最多有三个短信签名;
-
不能含违禁关键词,不能有其他特殊符号(如-.+#);
-
无须添加【】、()、[]符号,短信发送会自带【】、()、[]符号,避免重复;
-
模板内容如侵犯到第三方权益须获得第三方的授权,并将授权委托凭证上传管理中心; 凭证上传路径:登陆-管理中心-选择相对应的应用-短信-添加签名-签名用途选择:企业使用, 签名用于非自有产品-下载授权书模板-填写对应信息提交凭证扫描件审核。
-
各类短信签名一般在三个工作日内审核完成。
短信正文模版
1、 模版分为三种,验证码模版(包含文本验证码短信和语音验证码短信)、通知类模版、营销类模版,其中验证码模版中的验证码可以由云信生成;
2、 网易云信提供的模板短信由固定内容与多个变量构成,其中 " %s " 为需要接口替换的变量,变量内容可以是汉字、字母、数字组合,但单个变量内容长度不得超过 30 个字,一条模板短信中变量数量不限制,总字数限制 500 字内;
3、 审核通过的短信模版,重新修改模版内容后,在审核期间可以发送老的模版内容;
4、 每个应用中每种类型的短信模版分别可以创建 400 条模版;
5、 验证码模版由固定内容和一个验证码变量"%s"构成,验证码由网易云信生成或由开发者自行定义;
6、 验证码短信模版必须包含“验证码”关键字,营销类短信模版必 须包含“退订”关键字;
7、 验证码模版中的验证码默认有效时间为 10 分钟,单个手机号码短信接收次数为 10 次,如需修改可在验证码模版类别中修改;
8、 短信模板必须配置短信签名,否则无法发送。
验证码短信模版
云信验证码模版是云信提供的特色功能,目前市面上提供的模版验证码都需要用户方去生成,这样需要用户制定验证码生成规则,而使用云信验证码模版,用户只要传一个参数”%s”用来代替验证码,而这个验证码由云信帮用户生成,大大降低了用户接入成本和开发成本,强烈推荐用户使用。
云信验证码模版可用到的场景很多,例如注册时发送验证码短信、登录时发送验证码短信、找回/修改密码时发送验证码短信、绑定银行/实名认证时发送验证码短信等。验证码模版接入流程:
接口调用请参考 接口指南。
通知类短信模版
云信短信服务是云信提供的专业短信通知到达服务,用户可以使用多个参数“%s”来替换内容,云信通知类模版每个应用最多可以创建 400 条。
云信通知类模版可用到的场景很多,例如:
- 服务通知: 用户触发事件动作后,商家或者平台后台系统自动触发服务通知,比如服务开通、审核结果通知、报告结果反馈、刷卡消费通知等;
- 物流通知:网购发货或者用户寄件以后,有商家或者物流公司发送发货通知、收货提醒等短信;
- 出票通知:O2O 配送、优惠券下发、航班信息、景区出票通知等等;
- 付款回执:用户进行充值、付款、转账、缴费、退款等行为后,系统实时发送短信提醒给用户;
- 活动确认:在线发起活动、活动报名、作品提交等环节,系统通过短信实时反馈给用户结果;
- 系统通知:系统运行状态通知、任务执行结果、优惠信息、维护公告、节假日问候等消息通过系统发送给用户。
通知类模版接入流程:
接口调用请参考 接口指南。
营销类短信模版
云信可提供营销类文字短信服务,三网合一的高质量专用通道,金融级安全保护;适用于会员服务、客户关怀、新品上线等使用场景。
云信营销类模版可用到的场景很多,例如:
- 会员服务:定期给会员用户发送活动信息;
- 客户关怀:节假日给客户发送关怀短信;
- 新品上线:在有最新优惠信息、新功能上线时,实时通知用户。
通知类模版接入流程:
接口调用请参考 接口指南。
计费规则
云信短信计费包括短信签名,70 字以内按1条短信计费,超过 70 字则以 67 字每条计费,当短信中出现中文字符,则单个汉字、英文、标点和空格等都算一个字。
短信接入
接入说明
1、短信服务属于收费功能,用户可按照自己的使用量自助购买短信条数;
2、对接收方手机号码限制 1 天最多 10 条短信验证码;
3、提供验证码发送方 deviceId 参数,调用方选填。填写效果如下:一个 deviceId 默认一天发送 10 条验证码,如需修改可在短信配置中修改,最多不超过 25 条;
4、对同一个接收方手机号码,一分钟最多接受 3 条相同的短信, 超过后可能被运营商拦截;
5、对同一个接收方手机号码,一天最多接受 5 条相同的短信,超过后可能被运营商拦截;
6、验证码有效时间默认为 10 分钟,如需修改可在短信配置中修改,单位秒,最长不超过120 分钟;
7、对一个手机号码的验证调用,连续校验错误 10 次以后,该验证码立即失效,校验错误接口返回中需告知开发者当前错误次数;
8、对未发送短信验证码的手机号码验证调用,一天累计超过 1 万次会视为恶意攻击,将暂停该 appkey 的短信验证码服务,一旦发生此情况请联系客户顾问;
9、云信短信通道分为通道验证码短信、通知类短信通道和营销类短信通道,在调用短信验证码接口时可以同时调用校验验证码接口进行验证码校验。用户使用短信模版来发送短信则只需调用发送模版短信接口即可。
接入流程
开发者接入云信短信一共需要 6 个步骤,具体请参见开通流程。
发送短信验证码接口
、校验验证码接口
、查询模板短信发送状态接口
,这三个接口是按用户自身需求调用,云信短信提供的验证码模版接口只需要用户定义一个参数,云信将帮您生成验证码,无需用户开发验证码生成功能,大大降低了开发成本。
错误代码表
用户在调试云信短信接口时,如报错会给出不同的状态码提示,用户可根据给出的状态码做相应的修改。
服务器端状态码:
code | 详细描述 |
---|---|
200 | 操作成功 |
201 | 客户端版本不对,需升级SDK |
302 | 用户名或密码错误 |
403 | 非法操作或没有权限 |
404 | 对象不存在 |
405 | 参数长度过长 |
406 | 对象只读 |
408 | 客户端请求超时 |
414 | 参数错误 |
415 | 客户端网络问题 |
416 | 频率控制 |
422 | 账号被禁用 |
500 | 服务器内部错误 |
503 | 服务器繁忙 |
509 | 无效协议 |
998 | 解包错误 |
999 | 打包错误 |
月账单
云信短信计费依托于运行商的计费方式,故云信在统计用户短信条数时会先扣除用户的发送短信条数,在账单日统计出用户发送失败的条数,把发送失败条数补还给用户。云信短信的账单日是每月 5 号,统计上个月用户实际发送的短信条数。
例如:用户在 2016 年 1 月 1 日-2016 年 1 月 31 日一共发送了 50000 条短信,其中发送成功 49900 条,发送失败 100 条。这时云信会先扣除用户总共的发送条数 50000 条。在 2月 5 日出账单时把发送失败的 100 条短信补还到用户账户中。
您可以在云信控制台首页 费用中心 中选择 账单管理,查看账单总览和明细。
数据查询
云信提供了完善的数据查询系统,用户可以在云信管理后台查询统计短信的发送量、发送时间、回执状态等信息。
在控制台首页 应用管理 中选择应用进入应用配置页面,然后单击左侧 数据统计 下的 短信,查看短信相关数据。