title: 通知类短信

title: 通知类短信
准备工作
配置短信
配置上行接口（选配）
调用接口

准备工作

创建应用。首先，你需要在控制面板中创建应用。请参考控制面板-创建应用。
账户充值。如余额不足，请进入控制面板-财务-充值进行充值。

配置短信

通知类短信需配置三部分: 签名、模版、变量。

配置签名

签名将出现在下发短信的开头，实际效果如下图中的【野狗实时】。签名可以是你的公司简称，品牌名或网站名。通过控制面板-短信-配置配置短信签名，同时需要提交相关资质，审核通过后可使用。

title: 通知类短信 - 图1

提示：

每一个应用只能创建一个短信签名。

更改签名需要在控制面板-短信-配置页面中提交相关资质。

签名提交后需审核，在审核期间可以使用旧的签名发送短信。

配置模版

通知类模版需创建后提交审核。每个用户可以使用变量来替换内容，每个应用最多创建 50 条通知类模版。过程如下：

title: 通知类短信 - 图2

提示：

通知类模版需要调用短信模板 id。

通过控制面板-短信-模板创建通知类短信内容模板，操作如下：

title: 通知类短信 - 图3

通知类模版使用场景

场景	场景说明
服务通知	用户触发事件动作后，商家或者平台后台系统自动触发服务通知。服务开通、审核结果通知、报告结果反馈、刷卡消费通知等。
物流通知	网购发货或者用户寄件以后，有商家或者物流公司发送发货通知、收货提醒等短信。
出票通知	O2O 配送、优惠券下发、航班信息、景区出票通知等等。
付款回执	用户进行充值、付款、转账、缴费、退款等行为后，系统实时发送短信提醒给用户。
活动确认	在线发起活动、活动报名、作品提交等环节，系统通过短信实时反馈给用户结果。
系统通知	系统运行状态通知、任务执行结果、优惠信息、维护公告、节假日问候等消息通过系统发送给用户。

配置变量

野狗短信提供的模板短信由固定内容与多个变量构成，其中 %s 为需要接口替换的变量，发送短信时，接口会按顺序依次传入要替换的变量。

参数	类型	必选	说明
params	string	否	短信参数列表，用于依次填充模板，JSONArray格式，如[“xxx”,”yyy”]；对于不包含变量的模板，表示模板即短信全文内容，此参数传[]

提示：

变量内容可以是汉字、字母、数字或者特殊字符。

单个变量内容长度不得超过30个字符。

一条模板短信中变量数量不限制，但不能连续使用5个变量。

例如，模板配置如下：

您有一个新的订单，订单编号为 %s。

如果提交params参数为：

["123456"]

则替换变量后短信内容为：

您有一个新的订单，订单编号为 123456。

短信字符限制

短信分为普通短信和长短信：

普通短信每条限制 70 个字符。
超过 70 个字符即为长短信，长短信最多支持 300 个字符。每条长短信将被拆分，其中每条信息限制为 67 个字符。

例如：一条 134 个字符的长短信，将被拆分为（67个字符+67个字符）共2 条信息，同时按两条普通短信计费。

配置上行接口（选配）

野狗支持以下数据的上行推送：

1. 短信发送状态报告
2. 用户回复的短信内容（上行内容）

配置上行接口后，野狗会将短信发送状态或用户回复内容发送至该接口。可选择配置，默认关闭。

你需要提供一个公网可访问的 http 接口地址，在控制面板-短信-配置中配置为推送地址。如下：

title: 通知类短信 - 图4

提示：

上行接口返回状态码200代表接收上行数据成功，返回其他状态码系统会进行重试

如果连续 5 次接口请求失败，上行功能将被关闭，需要在控制面板重新开启。

上行接口需要自行保证安全性，如校验rrid、mobile等参数是否合法，以防止恶意调用。

因为网络原因，可能会导致上行推送重复提交，需要上行接口侧做好幂等操作

系统接收到运营商返回的发送状态报告或上行内容后，将状态或上行内容以http post形式发送至配置的推送地址。

发送状态推送数据格式如下：

{
  "data": [
    {
      "status": "Success", //Success代表发送成功 Failure代表发送失败
      "deliveryStatus": "DELIVRD", //运营商状态码
      "mobile": "xxxxxxxxxxx",
      "rrid": "$rrid",
      "receiveTime": "2016-12-28 14:43:21"
    }
  ],
  "type": 1 //type为1代表状态类型
}

短信上行数据格式如下：

{
  "data": [
    {
      "content": "回复内容",
      "mobile": "xxxxxxxxxxx",
      "rrid": "$rrid",
      "receiveTime": "2016-12-28 15:18:30",
      "extno": "0001"
    }
  ],
  "type": 3 //type为3代表通知类或验证码类上行类型
}

调用接口

需生成数字签名及调用接口，请参考接口文档。
如需查询短信发送状态，请参考查询发送状态。