# wxwobot

**Repository Path**: wesleyOne/wxwobot

## Basic Information

- **Project Name**: wxwobot
- **Description**: wxwobot - 微信多开运营自助工具 （岁月安好，停止维护）
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 189
- **Forks**: 69
- **Created**: 2018-12-15
- **Last Updated**: 2025-07-21

## Categories & Tags

**Categories**: weixin-app

**Tags**: None

## README

### <a href="https://gitee.com/wesleyOne/wxwobot">wxwobot 某信运营自助工具</a>
[![star](https://gitee.com/wesleyOne/wxwobot/badge/star.svg?theme=dark)](https://gitee.com/wesleyOne/wxwobot/stargazers)
[![fork](https://gitee.com/wesleyOne/wxwobot/badge/fork.svg?theme=dark)](https://gitee.com/wesleyOne/wxwobot/members)

#### 项目介绍
- 项目简介：模拟某信WEB端接口的自助机器人
- 基于<a href="https://github.com/yaphone/itchat4j">itchat4j开源项目</a>开发
- 支持多开/热登录/远程操作等特点

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

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

#### 项目组成
- 后台：JFinal3.5 + undertow + mysql + 常用工具包 + JDK1.8+ + maven3.5+
- 前端：Bootstrap3+及相关插件

#### 线上DEMO
[点击跳转=>>在线DEMO 账号密码都是wxwobot](https://wxwobot.51guagua.top)
- 由于是公开的线上项目，注意下自己的账号安全
- 那台服务器配置低，麻烦不要做压测


**体验流程**

![创建登录机器人](https://images.gitee.com/uploads/images/2019/0114/000301_65359f3b_1581722.gif "new (1).gif")

**创建登录机器人**：机器人管理->添加机器人->搜索刚添加的机器人->点击【已下线-登录】->扫码登录
> 登录完成后，在手机客户端里将目标群聊添加到**通讯录**，然后点击【刷新群列表】，通过【查看群列表】验证

![登录后按钮](https://images.gitee.com/uploads/images/2019/0114/000634_89eb2d75_1581722.png "all.png")

**测试发送消息**：机器人管理->点击相应机器人的【测试发送】->选择目标微信昵称，选择发送类型，文本/文件/图片
> 图片文件提交前要先点下上传按钮

![测试发送](https://images.gitee.com/uploads/images/2019/0114/001937_1afd0c4d_1581722.png "ceshifasong.png")

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

![新增关键字](https://images.gitee.com/uploads/images/2019/0114/000816_81da763e_1581722.png "keyword.png")

**外接配置**：机器人管理->点击相应机器人的【新增外接配置】-> 选择外接发送消息的目标，业务层的IP白名单->提交后点击顶部栏目【对外接口配置】，找到刚才的配置获取**外接唯一码**，点击启用
> 外接和测试发送的区别在于**外接可以解耦合**，可以由外部访问接口形式转发消息，本项目只做独立中台，不涉及业务

![外接配置](https://images.gitee.com/uploads/images/2019/0114/001510_caa748a6_1581722.png "weijiejiekou.png")

```
    调用接口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://www.jfinal.com/doc/1-5)

#### 鸣谢
<ul>
    <li><a href="https://www.jfinal.com/">JFinal极速开发社区</a></li>
    <li><a href="https://github.com/yaphone/itchat4j">itchat4j开源项目</a></li>
    <li><a href="http://www.bootcss.com">Bootstrap中文网</a>,<a href="https://www.bootcdn.cn/">BootCDN</a></li>
    <li><a href="https://www.glyphicons.com/">Glyphicons</a>,<a href="https://bootstrap-table.wenzhixin.net.cn/" target="_blank">BootstrapTable</a></li>
    <li><a href="https://github.com/Bttstrp/bootstrap-switch">Bootstrap Switch</a>,<a href="http://bootboxjs.com/" target="_blank">Bootbox.js</a></li>
    <li><a href="https://github.com/nghuuphuoc/bootstrapvalidator">bootstrapvalidator</a></li>
    <li><a href="https://github.com/kartik-v/bootstrap-fileinput">bootstrap-fileinput</a> </li>
    <li><a href="https://promotion.aliyun.com/ntms/yunparter/invite.html?userCode=dnuqwh0e" target="_blank">阿里云推广计划</a></li>
</ul>

#### 技术交流群
![QQ技术交流群](https://images.gitee.com/uploads/images/2019/0113/041630_383a6659_1581722.png "wxwobot_qq_qrcode.png")

[![阿里云推广](https://images.gitee.com/uploads/images/2019/0113/043826_4dbc36f4_1581722.png "源码页980-60.png")](https://promotion.aliyun.com/ntms/act/qwbk.html?userCode=dnuqwh0e)