极光短信对接指南

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

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

配置极光短信鉴权信息

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

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

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

配置极光短信回调地址

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

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

配置 CMPP 鉴权信息

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

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

上传手机号码

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

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

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

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

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

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

            [{
    "userid": "zhangsan",
    "phone": {
            "1234": "18756432567"
        }
  }]
  
          

  此代码块在浮窗中显示

发送消息

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

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