wechat-api 是一个基于微信Web协议的Java版本封装，提供了发送消息、接受消息、群操作等功能。
!> 强烈建议仅使用小号运行机器人！
从近期 (17年6月下旬) 反馈来看，使用机器人存在一定概率被限制登录的可能性。 主要表现为无法登陆 Web 微信 (但不影响手机等其他平台)。
你需要做的是引入依赖，然后创建属于自己的微信机器人应用。
该依赖支持 JDK7+，请确保你的Java环境是该版本或更高， 加载最新版 wechat-api 依赖，
可以在 Github 的 maven-central 图标查看或者在 这里 查看。
添加依赖
<dependency>
<groupId>io.github.biezhi</groupId>
<artifactId>wechat-api</artifactId>
<version>1.0.6</version>
</dependency>该依赖中包含了日志组件，默认是 logback，如果你的系统中需要其他的日志组件，请先排除 logback
<dependency>
<groupId>io.github.biezhi</groupId>
<artifactId>wechat-api</artifactId>
<version>1.0.6</version>
<exclusions>
<exclusion>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
</exclusion>
</exclusions>
</dependency>机器人 WeChatBot 对象可被理解为一个 Web 微信客户端。创建一个 Java 类作为我们的机器人，比如 HelloBot
public class HelloBot extends WeChatBot {
public HelloBot(Config config) {
super(config);
}
@Bind(msgType = MsgType.TEXT)
public void handleText(WeChatMessage message) {
if (StringUtils.isNotEmpty(message.getName())) {
log.info("接收到 [{}] 的消息: {}", message.getName(), message.getText());
this.sendMsg(message.getFromUserName(), "自动回复: " + message.getText());
}
}
public static void main(String[] args) {
new HelloBot(Config.me().autoLogin(true).showTerminal(true)).start();
}
}不到 20 行的代码我们已经完成了一个简单的机器人实现，我们来看一下这个机器人的代码流程， 然后分析他们的意思。
Bot 在初始化时便会执行登陆操作，需要手机扫描登陆。
- 首先继承
WeChatBot这个父类被标识为一个机器人 - 创建了一个以
Config为入参的构造函数 - 设置允许自动登录（在常见问题中描述了什么是自动登录）
- 设置在终端显示微信二维码
- 绑定了一个函数
handleText来接受 文本 类型的消息 - 启动机器人
wechat-api 提供了一个父类 WeChatBot 给所有的微信机器人作为扩展使用，
通过注解绑定函数来完成消息灵活监听。
- 使用
@Bind注解在方法标识 - 方法参数为
WeChatMessage @Bind注解参数:msgType为消息类型，建议不要使用ALL，这里可以配置多个@Bind注解参数:accountType监听群聊或单聊
监听群聊
@Bind(accountType = AccountType.TYPE_GROUP)
public void groupMessage(WeChatMessage message) {
if(StringUtils.isNotEmpty(message.getName())){
log.info("接收到群 [{}] 的消息: {}", message.getName(), message.getText());
this.sendMsg(message.getFromUserName(), "自动回复: " + message.getText());
}
}监听好友消息
@Bind(accountType = AccountType.TYPE_FRIEND)
public void friendMessage(WeChatMessage message) {
if(StringUtils.isNotEmpty(message.getName())){
log.info("接收到好友 [{}] 的消息: {}", message.getName(), message.getText());
this.sendMsg(message.getFromUserName(), "自动回复: " + message.getText());
}
}监听添加好友消息
@Bind(msgType = MsgType.ADD_FRIEND)
public void addFriend(WeChatMessage message) {
log.info("收到好友验证消息: {}", message.getText());
if (message.getText().contains("java")) {
this.api().verify(message.getRaw().getRecommend());
}
}很多同学想获得最新的代码在本地运行，需要再三强调一点。
!> 在本地开发环境安装 lombok 插件并确保你的 Java 环境是 1.7+
所有的 API 都在 WeChatApi 这个接口中定义。
使用
wechat-api扫码登录后会获得微信返回的 登录会话 缓存在本地，同事也会获得一个Cookie在通讯时用到， 自动登录的原理是每次心跳检查后将登录信息缓存到本地，存储为login.json，重新启动时加载该文件恢复即可。
有些账号是天生无法给自己的账号发送信息的，建议使用
filehelper代替。
- 调整发送消息频率
Config类添加获取配置方法
- 校验函数绑定错误抛出异常
- 添加通过
ClassPath加载Config配置 - 消息只可以被处理一次
- 添加创建群聊接口
- 添加消息撤回接口
- 添加自动同意好友功能
- 添加加好友接口
- 添加邀请、剔除群成员接口
- 添加修改群名接口