准备工作

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

配置短信

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

配置签名

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

提示：

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

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

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

配置模版

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

提示：

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

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

通知类模版使用场景

配置变量

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

提示：

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

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

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

例如，模板配置如下：

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

如果提交params参数为：

["123456"]

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

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

短信字符限制

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

• 普通短信每条限制 70 个字符。

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

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

配置上行接口（选配）

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

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

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

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

提示：

上行接口返回状态码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代表通知类或验证码类上行类型
}

调用接口

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