项目介绍

• 项目简介：模拟某信WEB端接口的自助机器人
• 基于itchat4j开源项目开发
• 支持多开/热登录/远程操作等特点

项目特点

• 支持多账号
• 重启项目热登录
• 消息统一使用队列，间隔时间发送，减少被封几率
• 其他业务访问本项目的对外接口，可实现消息转发到某信
• 自动回复（默认效果是全匹配关键字回复和进群欢迎语）
• jfinal-undertow开发部署的种种优势
• 扩展方便，有开发能力可自行实现消息的处理

项目缺点

• WEB端接口有限，功能有些鸡肋，传说WEB端即将关闭
• 没有合适的用户(群)唯一识别码，本项目使用用户(群)昵称作为标识，存在隐患
• 代码不够优美，性能有待提高

项目组成

• 后台：JDK1.8 + JFinal3.5 + undertow + mysql + 常用工具包
• 前端：Bootstrap3+及相关插件

线上DEMO

在线DEMO 账号密码都是wxwobot（https://wxwobot.51guagua.top/login）

• 由于是公开的线上项目，注意下自己的账号安全
• 那台服务器配置低，麻烦不要做压测

体验流程

创建登录机器人：机器人管理->添加机器人->搜索刚添加的机器人->点击【已下线-登录】->扫码登录

登录完成后，在手机客户端里将目标群聊添加到通讯录，然后点击【刷新群列表】，通过【查看群列表】验证

测试发送消息：机器人管理->点击相应机器人的【测试发送】->选择目标微信昵称，选择发送类型，文本/文件/图片

图片文件提交前要先点下上传按钮

关键字回复:机器人管理->点击相应机器人的【新增关键字】-> 可以设置普通关键字或新人进群欢迎词类型，可以目标某个群(好友)或者默认所有群（好友），可以设置回复文本/图片/文件；

图片文件提交前要先点下上传按钮

外接配置：机器人管理->点击相应机器人的【新增外接配置】-> 选择外接发送消息的目标，业务层的IP白名单->提交后点击顶部栏目【对外接口配置】，找到刚才的配置获取外接唯一码，点击启用

外接和测试发送的区别在于外接可以解耦合，可以由外部访问接口形式转发消息，本项目只做独立中台，不涉及业务

调用接口io.wxwobot.admin.web.controller.ExtendController
 /**
 * 对外通用规则发消息
 * url: /ext/sendMsg
 * 请求类型: Post
 * 参数:
 * ok 外接唯一码
 * msg 消息列表
 * 类型参考 @see io.wxwobot.admin.itchat4j.utils.enums.SendMsgType
 * TEXT 文本消息串
 * IMG 图片名串（需要后台-通用工具-上传获取）
 * FILE 文件名串（需要后台-通用工具-上传获取）
 * 例子:
 * {"ok":"test123",
 * "msg":[
 * {"type":"TEXT","body":"我是消息体"},
 * {"type":"IMG","body":"ty6yLk3X_1545142908614.jpg"},
 * {"type":"FILE","body":"ty6yLk3X_1545142537914.txt"},
 * ]
 * }
 *
 * 说明:
 * 发送顺序按照列表顺序从前往后发
 *
 * 返回:
 * 00 成功
 * 01 外接码不存在
 * 02 外接码失效
 * 03 IP未通过审核
 *
 */
 public void sendMsg();

开发部署

准备

• 使用 wxwobot.sql 中的 sql 语句创建数据库与数据库表
• 修改 pom.xml 文件，填入正确的数据库连接用户名、密码
• 请确保安装了 JavaSE 1.8 或更高版本

本地开发

1. 将项目导入开发工具，推荐使用IDEA
2. 打开 io.wxwobot.admin.web.common.MyConfig 文件，运行
3. 打开浏览器输入 localhost:8180 即可查看运行效果,默认账号密码均为 wxwobot，开发模式无需登录

生产部署

1. 修改pom.xml中uat配置，填入生产的数据库连接用户名、密码
2. 命令行进入项目根目录，然后运行 mvn install -P uat 即可打包
3. 打包完后，将 io.wxwobot.admin/target下的wxwobot-release.zip或wxwobot-release.tar.gz发送到云服务器上
4. 登入云服务器找到压缩包并解压
5. linux 下运行 start.sh 脚本启动项目,stop.sh 关闭项目;windows 下双击 start.bat 启动项目;
6. 访问云服务器的公网IP(或域名):8180，查看效果 (是的，不需要布置tomcat之类的服务器)

项目地址

https://gitee.com/wesleyOne/wxwobot