## 1. 微信机器人介绍
1. weixin_rebot是用Python实现的一个web微信机器人。
2. 后端采用图灵机器人接口
conf配置的key需要用户自行申请
3. 目前只支持文本消息发送
4. 消息发送机制
+ 机器人收到消息后会先判读是否发送和接收都是当前用户,如果是则智能回答。否则判读用户是否在2分钟内操作过手机,如果有则跳过,否则进行回答判断
+ 如果消息来自群聊,先判断当前消息是否 @当前用户,如果没有则随机选择是否发送消息
+ 如果消息来自一般用户,消息类型是图片则随机回复,消息类型是文本则调用图灵机器人接口获取智能回答然后发送消息
+ 如果消息来自公众号,直接过滤
## 2. 使用说明
1. python weixin_rebot.py
2. 扫描二维码登录即可
## 3. 环境依赖
```
1. linux:
1). ubuntu 12.04
2). sudo apt-get install imagemagick
sudo apt-get install python-pip
2 python:
1). version > 2.6
2). sudo pip install requests
3). sudo pip install pypng
4). sudo pip install Pillow
```
## 4. web微信登录过程
```
1. 获取uuid
1). 说明: 微信Web版本不使用用户名和密码登录,而是采用二维码登录,所以服务器需要首先分配一个唯一的会话ID,用来标识当前的一次登录
2). api: https://login.wx.qq.com/jslogin?appid=wx782c26e4c19acffb&redirect_uri=https%3A%2F%2Fwx.qq.com%2Fcgi-bin%2Fmmwebwx-bin%2Fwebwxnewloginpage&fun=new&lang=zh_CN&_=%s
3). get 请求
3). 参数说明:
a. appid 固定值wx782c26e4c19acffb表示微信网页版
b. redirect_uri 固定值
c. fun 固定值 new
d. lang 固定值 表示中文
e. _ 表示13位时间戳
2. 获取登录二维码
1). 说明: get请求拿到数据,再保存为图片并展示
2). api: https://login.weixin.qq.com/qrcode/%s
3). get 请求
4). 参数说明:
a. 唯一参数是uuid
3. 扫描二维码等待用户确认
1). 说明: 当用户拿到二维码数据之后,用户需要扫描二维码并点击确认登录
2). api: https://login.weixin.qq.com/cgi-bin/mmwebwx-bin/login?loginicon=true&uuid=%s&tip=0&r=-979422099&_=%s
3). get 请求
4). 参数说明
a. uuid 表示当前uuid
b. tip: 0->表示等待用户确认登录。返回window.code=200;window.redirect_uri="https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=AWskQEu2O8VUs7Wf2TVOH8UW@qrticket_0&uuid=IZu2xb_hIQ==&lang=zh_CN&scan=1467393709"; 表示登录成功
c. r: -979422099 随机9位字符串即可
d. _表示当前时间戳,13位
5). 点击登录成功之后,返回redirect_uri表示用户已经在手机端完成了授权过程,需要继续访问当前链接获取wxuin和wxsid
4. 访问登录地址,获得uin和sid
1). 说明: wxuin和wxsid在后续的通信中都需要用到
2). api: https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxnewloginpage?ticket=AWskQEu2O8VUs7Wf2TVOH8UW@qrticket_0&uuid=%s==&lang=zh_CN&scan=%s
3). get 请求
4). 参数说明
a. uuid 表示当前uuid
b. scan 表示当前的扫描时间戳 10位
5). 返回结果
0OK@crypt_b13bcf4_b49e9a***c34a5e263381f032e6ae18cbgJmKzszzW2KnFIXf828185***0vBTQ11xy5sLBraR8BT1K7xGQldAmLRSZBzylJ%2FiEVbV77SgMcNyOBj0seNho8kUM1
a. skey
b. wxsid
c. wxuin --> 用户唯一的id
d. pass_ticket
5. 初始化登录页信息
1). 说明: 初始化登录后页面的信息,获取常用联系人以及微信公众号
2). api: https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxinit?r=-%s&lang=zh_CN&pass_ticket=%s
3). post 请求
4). post data
{
'BaseResponse': {
'Uin': wxuin,
'Sid': wxsid,
'Skey': skey,
'DeviceID': //随机串 'e'+str(random.random())[2:17]
}
}
5). 返回json串包含当前user的相关信息,BaseResponse内Ret位0表示成功
6. 开启微信状态通知
1). 说明: 有新消息通知的时候会显示
2). api: https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxstatusnotify?lang=zh_CN&pass_ticket=%s
3). post 请求
4). post data
{
'BaseResponse': {
'Uin': wxuin,
'Sid': wxsid,
'Skey': skey,
'DeviceID': //随机串 'e'+str(random.random())[2:17]
}
'ClientMsgId': 13位时间戳,
'Code': 3 //固定值
'FromUserName': userNmae, //从初始化登录信息那边取到
'ToUserName': userNmae, //从初始化登录信息那边取到
}
5). 返回json串,BaseResponse内Ret位0表示成功
7. 同步刷新,检查服务端消息
1). 说明: 为了实时取到消息,需要客户端不断发送请求给服务端查询
2). api: https://webpush.wx.qq.com/cgi-bin/mmwebwx-bin/synccheck?r=%s&skey=%s&sid=%s&uin=%s&deviceid=%s&synckey=%s&_=%s
3). get 请求
4). 参数说明
a. r --> 13位时间戳
b. skey 同上,需要url quote
c. sid 同上
d. devicedid 同上
e. synckey由 初始化登录页面信息返回串中Sync的list列表组成, 需要url quote
f. _ 13位时间戳
5). 返回值
window.synccheck={retcode:"xxx",selector:"xxx"}
retcode:
a. 0 正常
b. 1100 失败/登出微信
c. 1101 从其它设备登录微信网页版
selector:
a. 0 正常
b. 2 新的消息
c. 7 手机操作了微信
8. 获取消息
1). 说明: 根据同步刷新的接口拿到当前的状态后,如果是新的消息,需要获取新的消息
2). api: https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsync?sid=%s&skey=%s&pass_ticket=%s
3). 返回json串
a. BaseResponse,Ret位0表示返回成功
b. AddMsgCount 表示新消息个数
c. AddMsgList 表示新消息列表
MsgType 说明
1 文本消息
3 图片消息
34 语音消息
37 VERIFYMSG
40 POSSIBLEFRIEND_MSG
42 共享名片
43 视频通话消息
47 动画表情
48 位置消息
49 分享链接
50 VOIPMSG
51 微信初始化消息
52 VOIPNOTIFY
53 VOIPINVITE
62 小视频
9999 SYSNOTICE
10000 系统消息
10002 撤回消息
9. 发送消息
1). 说明: 发送数据给指定用户,包括群聊等
2). api: https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxsendmsg
3). post 请求
4). post data
{
'BaseResponse': {
'Uin': wxuin,
'Sid': wxsid,
'Skey': skey,
'DeviceID': //随机串 'e'+str(random.random())[2:17]
}
'Type': //消息类型,同上
'Content': //消息内容
'FromUserName': //发送用户
'ToUserName': //接受用户
'LocalID': //13位时间戳+4位随机数
'ClientMsgId': //同LocalId
}
5). 返回json串,BaseResponse内Ret位0表示成功
```
## 5. 参考
1. https://github.com/xiangzhai/qwx/blob/master/doc/protocol.md
2. https://github.com/Urinx/WeixinBot
3. https://github.com/liuwons/wxBot
4. http://www.tanhao.me/talk/1466.html/