微信公众号对接指南

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

注:微信公众号新发布的订阅消息类型正在适配中,图文消息类型也在后续计划中,敬请期待。

申请服务号

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

启用模板消息

在功能->添加功能插件处看到申请模板消息功能的入口,每个账号可以同时使用 25 个模板。 jpush_web

添加模板消息能力后,在模板消息菜单页,可以在模板库添加自己所需要的模板,也可以申请专门的模板,每月可申请 3 次。 jpush_web jpush_web

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

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

上传 openID

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

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

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

简要测试方案

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

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

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

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

Documentation built with MkDocs.