微信小程序对接指南
最近更新:2022-5-21

微信小程序对接指南

UMS 支持对接微信小程序的订阅通知,所有小程序的消息都在微信中的「服务通知」会话中展示。

申请微信小程序

1、进入小程序注册页根据指引填写信息和提交相应的资料。

注意,每个邮箱仅能申请一种帐号,此处填写未注册订阅号/服务号/企业号/小程序/open帐号/个人微信号的邮箱。 jpush_web

2、登录邮箱进行激活。

3、填写主体信息,选择主体类型后,完善主体信息和管理员信息,并进行认证。

企业类型的主体支持使用「对公账号认证」和「微信认证」2 种方式,详见官方说明

和微信公众号一致,如果注册时未准备好信息,下次可以在微信公众平台首页直接使用邮箱登录,继续进行认证登记操作。

基本配置与鉴权

使用 AppID 和秘钥

1、在微信公众平台首页登录小程序,在左侧菜单栏找到「开发」-「开发工具」-「开发设置」,即可获取到 AppID 和 AppSecret,将信息配置到 UMS 微信小程序通道信息中去。 jpush_webjpush_web

使用第三方平台扫码授权

1、公有云统一使用「极光统一消息系统」这个第三方平台供应商,在创建通道时操作扫码授权,需要「公众号的管理员」才能扫码。使用本方式创建通道时无需配置回调地址。

  • 如果企业的业务系统已经自行接入了微信公众号/小程序业务,希望 UMS 在使用微信公众号/小程序时不要与业务系统产生冲突(token、获取统计数据),则可以在创建通道时,选择使用扫码授权的方式进行。

2、私有云客户可配置企业自己创建的第三方平台进行授权管理,操作步骤与公众号一致,查阅公众号文档,小程序所需配置的权限集说明如下:

权限集ID 描述 备注
18 开发管理与数据分析权限 必须

添加模板

1、进入订阅消息菜单页,在公共模板库选用模板,一共可以选择 50 个模板。 jpush_web

2、在微信小程序平台成功添加模板后,在 UMS 系统中,点击刷新列表即可获取到模板列表,从而在推送时使用它 jpush_web

上传 openID

1、在微信小程序中将企业的账号与微信用户进行绑定,需要通过微信官方提供的登录接口获取到 openID。

  • 一般的操作是:在用户进入小程序后,引导其登录绑定,用户在账号登录页面进行登录后,调用微信官方接口获取 openID,即能获得 openID 与账号的关联关系。

2、将该绑定关系上传至 UMS 用户体系中。

3、假设在 UMS 创建通道时设置的通道编码为:wechatmp123,则上传信息至 UMS 平台的示例如下:

  • 在 UMS 控制台上点击文件上传,微信小程序的 openID 在 UMS 中的命名是:wechatmp_openid,Excel 内容参考:
    jpush_web
  • 调用 rest API 上传的 JSON 示例如下,详情请参考 rest API - 用户管理
    [{ "userid": "zhangsan", "set":{ "wechatmp123":"pioV1cHbf7ghFI_oRcf0w_yHT-1F" } }]
              [{
      "userid": "zhangsan",
      "set":{
          "wechatmp123":"pioV1cHbf7ghFI_oRcf0w_yHT-1F"
      }
    }]
    
            
    此代码块在浮窗中显示

注意事项

订阅消息需要用户主动点击了订阅某一个模板,才能发送消息,否则即便获得了 openID 也无法向该用户发送消息成功。

  • 一般的操作是:在用户进入小程序后,在他做某项操作时调用微信小程序的订阅消息接口 wx.requestSubscribeMessage,将拉起订阅弹框提示,如果用户选择了“总是保持以上选择,不再询问”,之后调用该接口将不会再需要用户允许。

  • 由于点击订阅按钮一次只能发送一次消息,如果有多条消息需要发送,建议在小程序的很多操作中都调用一次 wx.requestSubscribeMessage,用来积累可发消息的次数。

  • 如果担心每个操作上调用 API 会导致用户被频繁的询问是否订阅,可以在重点操作上默认调用,在其他操作上调用前先通过 wx.getSetting 接口查询一下用户是否勾选了「总是保持以上选择,不再询问」,如果勾选了,则调一次 API

发送消息

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

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

文档内容是否对您有帮助?

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

在文档中心打开