wxwobot 某信运营自助工具

项目介绍

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

项目特点

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

项目缺点

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

项目组成

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

线上DEMO

点击跳转=>>在线DEMO 账号密码都是wxwobot

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

体验流程

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

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

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

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

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

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

外接配置：机器人管理->点击相应机器人的【新增外接配置】-> 选择外接发送消息的目标，业务层的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之类的服务器)

常见问题

开发部署常见问题

鸣谢

• JFinal极速开发社区
• itchat4j开源项目
• Bootstrap中文网,BootCDN
• Glyphicons,BootstrapTable
• Bootstrap Switch,Bootbox.js
• bootstrapvalidator
• bootstrap-fileinput
• 阿里云推广计划

技术交流群