Skip to content

微信开放平台

当伙伴需要给自己的SaaS版本(多组织版本)提供:微信模板消息微信自动登录等能力时,可以参考以下流程

为什么不直接绑定服务号?

当一个服务号绑定了多个应用时,各个应用之间会出现 顶号 的问题,这会直接导致应用工作异常

为了防止服务号原有的应用工作异常,采用了 微信官方 提供的 第三方平台授权模式 来解决 顶号 的冲突问题。

1.创建第三方应用

1.1 注册账号

点击跳转到微信开放平台,并注册开放平台账号,并通过开发者资质认证

特别说明

这里必须以 企业/单位 为主体来注册微信开放平台,否则无法认证 开发者资质 !!!
这里必须以 企业/单位 为主体来注册微信开放平台,否则无法认证 开发者资质 !!!
这里必须以 企业/单位 为主体来注册微信开放平台,否则无法认证 开发者资质 !!!

注意

微信开放平台 的开发者资质认证需要 认证费用 ,这是独立于 微信服务号的额外费用

这是一次性的费用, 永久有效

1.2 创建平台

点击创建第三方平台


填写基本信息

注意

账号类型需要选择:平台型

开发模式需要选择:传统模式

2.配置平台

2.1 配置权限集

点击详情进入第三方平台页面,并配置权限集

注意

仅需要配置公众号权限集中的47

2.2 配置开发资料

点击详情进入第三方平台页面,并编辑开发资料

开发资料配置页面


配置项的详细说明

提示

以下配置示例,均假设域名为domain.com,协议为https

配置时需要替换为真实的域名及协议

配置项配置示例配置说明配置截图
授权事件接收配置https://domain.com/api/wx/固定值:/api/wx/
消息与事件接收配置https://domain.com/api/wx/event/$APPID$固定值:
/api/wx/event/$APPID$
消息校验Token随机字符串(推荐24位)
消息加解密Key随机字符串(必须43位)
授权发起页域名domain.com
公众号开发域名domain.com注意:这里需要校验域名的有效性。可以使用:自动证书-HTTPS,进行域名归属权验证
授权测试公众号/小程序列表gh_869c98fb3299;gh_86f680c6c4b4;不需要全网发布也可以通过对白名单内的公众号进行授权
白名单IP地址列表47.108.150.131;125.69.8.230填写服务器的ip地址

授权测试公众号/小程序列表

若未全网发布,则需要将 公众号 / 小程序AppID 填入 授权测试公众号/小程序列表
公众号 / 小程序 获取 AppID ,参考图:

小程序获取AppID

公众号获取AppID

2.3 生成AppSecret

特别说明

AppSecret是平台重要的身份凭据,需要妥善保管

2.4 提交审核(可选)

【此步骤可省略】 提交当前开放平台给微信官方进行审核

注意

即使不审核,在授权测试公众号/小程序列表中的公众号/小程序也可以进行授权

2.5 全网发布(可选)

【此步骤可省略】 将当前平台进行发布全网发布,全网发布后,任何公众号/小程序都可以进行授权

注意

即使不进行全网发布,在授权测试公众号/小程序列表中的公众号/小程序也可以进行授权

3.使用平台

3.1 启用服务

使用初始管理员账号进入 服务后台⇲如何进入服务后台管理?

  1. 系统配置 -> 微信开放平台 ,填充微信参数

微信参数

获取方式见后文

  1. 系统配置 -> 基础配置 中修改 系统根地址

特别说明

注意:一定要同步修改系统根地址/ROOT_DOMAIN参数字段,必须和微信开放平台后台配置的域名一致,否则无法进行授权!

  1. 然后重启运行主服务

应用ID:WX_OPEN_PLATFORM_APP_ID

微信开放平台应用id


应用密钥:WX_OPEN_PLATFORM_SECRET

微信开放平台应用秘钥


消息校验-Token:WX_OPEN_PLATFORM_MSG_TOKEN
消息加解密-Key:WX_OPEN_PLATFORM_CRYPTO_KEY

消息校验Token 和 消息加解密Key

3.2 微信服务号授权

配置了微信开放平台参数并重启服务后,则可以进行微信服务号授权

特别说明

必须是实名认证通过微信服务号才能进行授权!

查看是否是已实名的服务号


进行服务号授权

注意

这里需要确认当前账号是否拥有微信服务号权限,初始管理员默认拥有全部权限,如果你的账号没有权限请联系会众云客服


授权成功后

3.3 配置微信推送模板

登录微信服务号,选择模板消息并添加对应的消息模板

添加模板以后,执行更新模板操作可以同步所有的模板

提示

添加模板后,可以在应用的工作流中选择微信消息节点推送微信模板消息

3.4 使用消息推送

推送消息主要通过工作流节点 微信通知 来完成,详情可见:⇲应用工作流-通知节点-微信通知

4.问题排查

详见 ⇲微信 | 企微接入过程