通知类短信 编辑文档

准备工作

配置短信

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

配置签名

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


提示:


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

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

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

  • 配置模版

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


    提示:


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

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

    通知类模版使用场景

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

    配置变量

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

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

    提示:


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

  • 单个变量内容长度不得超过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代表通知类或验证码类上行类型
    }

    调用接口

    野狗新手?
    立即注册,为你提供安全可靠的实时通信云服务。
    没找到需要的文档?
    你可以提交工单反馈 或 阅读常见问题
    期待收到你的反馈,帮助我们改进文档。
    参与调研