企业微信
旺财狗支持对接企业微信,通过企业微信自建应用的接收消息回调实现消息收发,支持文本、图片、语音、视频等消息的被动回复。
💬 功能简介
- 基于企业微信官方 API,稳定合规
- 企业成员向应用发消息,旺财狗自动回复
- 支持文本、图片、语音、视频、链接等消息类型
- 需要企业微信授权(VIP 功能)
准备工作
- 企业微信管理后台:登录 企业微信管理后台
- 创建自建应用:应用管理 → 应用 → 创建应用,创建后记录:
- 企业ID(CorpId):我的企业 → 企业信息
- AgentId:应用详情页
- Secret:应用详情页
- 一台公网服务器:旺财狗需要运行在公网可达的服务器上(80/443 或自定义端口)
- 企业微信授权:旺财狗「关于软件」-「授权中心」购买企业微信 VIP
配置指南
第一步:生成回调地址
在旺财狗「系统配置」-「聊天软件对接」中新增 微信企业号 机器人,点击「生成企业号回调URL」,得到类似:
https://你的域名/workwx/notify?workid=企业ID第二步:配置企业微信后台
在企业微信管理后台,进入自建应用的「接收消息」设置:
| 配置项 | 填写内容 |
|---|---|
| URL | 旺财狗生成的回调地址 |
| Token | 自定义一个 Token(旺财狗中填写相同值) |
| EncodingAESKey | 点击随机生成 |
| 加解密方式 | 推荐「安全模式」 |
第三步:配置旺财狗
回到旺财狗新增机器人页面,填写:
| 配置项 | 说明 |
|---|---|
| 企业号ID | 企业微信的企业ID(CorpId) |
| AgentID | 自建应用的 AgentId |
| Secret | 自建应用的 Secret |
| 调用Token | 与后台填写的 Token 一致 |
| EncodingAESKey | 与后台生成的一致 |
| 加密模式 | 与后台选择的一致 |
保存后即完成对接。
消息能力
接收消息
| 类型 | 支持 |
|---|---|
| 文本 | 支持(走消息管线处理) |
| 图片 | 支持(管理员可发送群二维码等) |
发送消息(被动回复)
| 类型 | 支持 |
|---|---|
| 文本 | 支持 |
| 图片 | 支持 |
| 语音 | 支持 |
| 视频 | 支持 |
| 链接 | 支持 |
💡 辅助命令
- 发送
state可测试机器人是否运行正常(返回"旺财狗运行正常!") - 发送
getWorkWxID可获取当前用户的 OpenID
⚠️ 注意事项
- 企业微信对接采用被动回复模式,需要在 5 秒内响应
- 需要对外可达的回调 URL(公网服务器 + 80/443 或自定义端口)
- 企业微信授权是 VIP 功能,免费用户不可用
- 回复内容超过 600 字会被截断