配置微信公众号后台#
WeAuth在正式运行之前，需要您在微信公众号后台进行相关设置。
本章教程将从注册微信公众号开始介绍如何将WeAuth服务器接入微信公众平台。
注册公众号#
您可以前往 微信公众平台官网 进行注册。值得一提的是， 自2024年10月起，个人也可以注册微信服务号。而在以往，个人只能注册订阅号。
对于WeAuth而言，订阅号与服务号没有区别，个人身份注册与企业身份注册也不会影响任何功能。
功能 |
服务号 |
订阅号 |
|---|---|---|
显示位置 |
聊天主页 |
订阅号折叠页面 |
群发能力 |
4条/一个月 |
1条/一天 |
自定义菜单 |
有 |
有 |
关注自动回复 |
有 |
有 |
警告
对于个人主体，每个身份证只能注册一个公众号(订阅号或服务号)。
小技巧
如果您使用个人主体注册了服务号，则默认没有邮箱和密码，需要到您先 找回账号 ，才能开启开发者密钥。
验证服务器地址#
进入服务器配置页面#
完成注册公众号后，登录公众号后台，在左侧选择“设置与开发”-“开发接口管理”，然后启用开发者功能。
之后您会看见“服务器配置(未启用)”一栏，里面包含 服务器地址(URL) , 令牌(Token), 消息加解密密钥 , 消息加解密方式 。
暂时不要填写这些内容，因为只有验证成功才能保存服务器配置。
项目 |
用途 |
填写方式 |
|---|---|---|
服务器地址 |
访问WeAuth web服务的URL地址 |
|
令牌(Token) |
用于验证运算 |
任意填写，与后续保持一致 |
消息加解密密钥 |
用于加密模式加解密使用 |
暂时不支持，选择随机生成即可 |
消息加解密方式 |
微信服务器与WeAuth服务器传递消息模式 |
选择“明文模式”，后续将支持其他模式 |
开启WeAuth验证模式#
请跳转到 仅用于微信公众号验证服务器地址
开启验证模式后，您可以在“服务器配置”中填写服务器地址和token。点击“提交”时，微信便会向WeAuth发送验证请求，如果一切正常，会显示验证成功。
填写config.yaml#
登录公众号后台，在左侧选择“设置与开发”-“开发接口管理”，查看“账号开发信息”。
其中，开发者ID(AppID) 对应config.yaml文件中的 appID 。 开发者密码(AppSecret) 对应 AppSecret 。
此外，您还要将运行WeAuth的服务器IP放入白名单。
登录公众号后台，在左侧点击公众号头像，选择“账号详情”，将“原始ID”填入config.yaml的 WxUserName 。
如果您使用http服务，请将config.yaml中的 ssl 设置为 0 。 （1.6.0起支持）
如果您使用https服务，请将config.yaml中的 ssl 设置为 1 ，并填写ssl证书文件路径。 （1.6.0起支持）
最后，config.yaml中的 url 与您先前使用WeAuth验证模式的路由参数保持一致，默认为 /wx 。
备注
config.yaml的设置应该与您进行微信验证时相同，包括路由地址和是否使用https。
测试配置是否正确#
您可以运行WeAuth的微信端测试模式。（1.6.1起支持）
weauth -wtest
当WeAuth开始运行时，请您使用手机微信给您的公众号发送消息。如果配置正确，则会显示收到微信服务器消息。
至此，WeAuth可以正常接收到来自微信服务器的消息，包括用户发送的文本消息和订阅/取消订阅事件。