极光短信对接指南

UMS 除了默认支持对接极光短信服务外,还支持通过 CMPP 协议对接企业已有的短信平台

本文将对 UMS 对接 JSMS 所需进行的操作一一说明,更具体的如 JSMS 客户端 SDK 集成操作请阅读 JSMS 文档

配置极光短信鉴权信息

登录极光官网,进入服务中心-开发者平台,创建一个应用后,在应用设置页面获取 Appkey 与 MasterSecret,并配置到 UMS 的短信通道信息中。

使用极光短信需要先完成实名认证

jpush_webjpush_web

UMS 并不限制对接的短信属于哪一个极光账号,任意极光账号下的短信均可以对接。

配置极光短信回调地址

为了让 UMS 系统能检测到消息的送达状态,需要企业在极光短信-回调设置-发送状态回调页面,配置送达回执地址。

  • 发送状态回调地址:https://ums-callback.jiguang.cn/v1/sms/callback

jpush_web

配置 CMPP 鉴权信息

在 UMS 通过 CMPP 添加短信通道时,需要填写 7 项信息:

  • 供应商
    • 为了对您所配置的通道进行准确的折损分析,请将供应商的名称和他所返回的回执状态码通过技术支持或 support@jiguang.cn 告知极光
  • 网关IP
  • 网关端口
    • 若端口不是 80、443、25、465 这 4 个之一,需要联系商务说明端口
  • 账号
  • 密码
  • 接入号
  • 连接数

jpush_web

上传手机号码

1、如果企业已自行实现了获取用户手机号码的方法,则仅需将手机号码与对应的账号信息上传即可。

2、如果还未实现,建议接入极光短信 SDK,可以阅读 JSMS 文档,JSMS SDK 可以帮助企业在 App 端实现注册、登录、验证码验证等功能,然后将获取到的手机号码与用户账号信息上传至 UMS。

  • 关于短信对接:UMS 公有云只支持对接极光短信,UMS 私有云可以支持对接其它短信服务商。

3、上传手机号码时,支持区分渠道上传,绑定标识 bind_id 为渠道的 ChannelKey,即不同的业务线创建不同的渠道后,若同一个用户的手机号码不一样,则可以对每一个渠道均绑定一个手机号码,该渠道给该用户发短信时,会使用渠道绑定的手机号码发送。

4、假设在 UMS 创建渠道时得到的 channelKey 为:1234,则上传信息至 UMS 平台的示例如下:

  • 在 UMS 控制台上点击文件上传,邮箱在 UMS 中的命名是:phone,Excel 内容参考: jpush_web
  • 调用 rest API 上传的 JSON 示例如下,详情请参考 rest API - 用户管理
[{
    "userid": "zhangsan",
    "phone": {
            "1234": "18756432567"
        }
}]

发送消息

配置成功后即可开始使用官网控制台发送消息,阅读控制台操作指南

还可以调用 API 进行发送,阅读 REST API 文档


Copyright 2011-2020, jiguang.cn, All Rights Reserved.
粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

Documentation built with MkDocs.