微信公众号对接指南

UMS 目前支持微信公众号的模板消息、订阅通知,这 2 种消息仅服务号类型的公众号才支持,因此企业需要首先申请一个服务号。

注:图文消息类型在后续计划中,敬请期待。

申请服务号

1、在微信公众平台的登录页面,点击注册 jpush_web

2、选择服务号类型,不同的公众号拥有不同的能力,详情请见:公众号接口权限说明,这里我们要接入模板消息、订阅通知,则需要选择服务号。 jpush_web

3、激活邮箱

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

4、邮箱激活后,需要选择注册地,并再次选择账号类型 jpush_webjpush_web

5、注册服务号需要登记较为详细的信息,所需信息具体详见官方说明,如何选择主体类型详见官方说明

如果资料未能准备好,可以在准备好后,使用已激活的邮箱&密码登录再进行登记。

审核通过后,即可使用模板消息、订阅通知等功能。

基本配置与鉴权

1、公众平台官网登录之后,在左侧菜单栏最下方,找到“开发”-“基本配置”页面,在该页面可以获取到 AppID 和 AppSecret 信息,将信息配置到 UMS 微信公众号通道信息中去 jpush_webjpush_web 2、配置 IP 白名单,请将 UMS 系统的 IP 地址配置到 IP 白名单中

  • 119.3.213.183

jpush_web 3、服务器配置,为了检测微信公众号消息的真实送达状态,需要将 UMS 的回调地址配置在此:https://ums-callback.jiguang.cn/v1/wechatoa/callback jpush_web

启用模板消息

在功能->添加功能插件处看到申请模板消息功能的入口,详情查看模板消息的官方介绍说明

jpush_web

添加模板消息能力后,在模板消息菜单页,可以在模板库添加自己所需要的模板,总共可以申请 25 个模板,如果没有找到合适的模板,也可以申请专门的模板,每月可申请 3 次。 jpush_web jpush_web

注意,使用模板消息,需要遵循微信官方的运营规范

在微信公众号成功添加模板后,在 UMS 系统中,点击刷新列表即可获取到模板列表,从而在发送消息时使用它 jpush_web

启用订阅通知

在添加新的功能页面看到申请订阅通知的入口,详情查看订阅通知的官方介绍说明

jpush_web

添加订阅通知的能力后,在广告与服务->订阅通知菜单页,可以在公共模板库添加自己所需要的模板,总共可以申请 50 个模板,如果没有找到合适的模板,也可以申请专门的模板,每月可申请 10 次。

jpush_web

在微信公众号成功添加模板后,在 UMS 系统中,点击刷新列表即可获取到模板列表,从而在发送消息时使用它

jpush_web

除了在公众号后台申请模板外,UMS 集成了公众号申请模板的能力,在通道设置创建了微信公众号通道,并授权给了渠道后,企业可以直接在渠道-模板管理-微信公众号-公共模板库中选用模板。

jpush_web jpush_web

上传 openID

1、在微信公众号中将企业的账号与微信用户进行绑定,需要通过网页授权,获取到 openID。

  • 一般的操作是:在用户关注后,引导其登录绑定,点击跳转到企业的账号登录页面,用户在该页面进行登录后,调用微信官方接口获取 openID,即能获得 openID 与账号的关联关系。

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

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

  • 在 UMS 控制台上点击文件上传,微信公众号的 openID 在 UMS 中的命名是:wechatoa_openid,Excel 内容参考: jpush_web
  • 调用 rest API 上传的 JSON 示例如下,详情请参考 rest API - 用户管理
[{
    "userid": "zhangsan",
    "set":{
        "wechatoa123":"oRcf0w_yHT-1F_pioV1cHbf7ghFI"
    }
}]

简要测试方案

1、如果企业没有服务号,测试阶段可以访问官方地址申请微信公众平台接口测试帐号,暂不支持测试订阅通知

2、如果企业尚未开发账号绑定功能,有 2 种方式快速获取测试微信的 openID

  • 通过获取用户列表-关注公众号-再次获取用户列表的方式,这之间新增的 ID 即测试微信的 openID。极光提供了一个程序可协助开发者获取用户列表,下载 pushtools 工具( Linux 版本 Mac 版本),在控制台输入如下命令,填写上具体的 AppID 和 AppSecret 即可
./pushtool wechatoa -appid xxx -secret xxx
  • 登录公众号后台,在左侧菜单管理-用户管理,找到测试微信账号,点击名称,在新打开的聊天页面里,复制地址栏,地址栏里有一个参数 tofakeid=o_xxxxxxx,这个 tofakeid 后面的值,就是该账号的 openID

订阅通知特别说明

与模板消息(关注后即可发送)不同的是,订阅通知需要用户主动点击了订阅某一个模板,才能发送消息,否则即便获得了 openID 也无法向该用户发送消息成功。

  • 简单测试的操作是:在微信公众号后台发送一条图文消息,在图文消息中带上订阅信息

jpush_web

  • 此外,还可以在网页等场景通过微信开放的标签能力设置订阅通知功能,供用户主动订阅。网页端设置订阅通知的接口是wx-open-subscribe

  • 和小程序一样,用户点击订阅后将拉起订阅弹框提示,如果用户选择了“总是保持以上选择,不再询问”,之后用户再次点击订阅将不需要授权。

  • 点击订阅按钮一次只能发送一次消息,如果有多条消息需要发送,企业需要想办法在各项操作中调用订阅接口来积累可发消息的次数。

发送消息

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

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


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

Documentation built with MkDocs.