wxBot 是用Python包装Web微信协议实现的微信机器人框架

目前的消息支持情况:

Web微信协议参考资料:

挖掘微信Web版通信的全过程

微信协议简单调研笔记

master-dev 分支为开发版本,用于测试新特性,欢迎使用后提出建议!

1 环境与依赖

此版本只能运行于Python 2环境 。

wxBot 用到了Python requests , pypng , Pillow 以及 pyqrcode 库。

使用之前需要所依赖的库:

2 快速开发

利用 wxBot 最简单的方法就是继承WXBot类并实现 handle_msg_all 或者 schedule 函数,然后实例化子类并调用 run 方法 。

2.1 代码

以下的代码对所有来自好友的文本消息回复文本消息 hi 、图片消息 1.png 以及文件消息 1.png , 并不断向好友 tb 发送文本 schedule 。

handle_msg_all 函数用于处理收到的每条消息,而 schedule 函数可以做一些任务性的工作(例如不断向好友推送信息或者一些定时任务)。

2.2 运行

直接用 python 运行代码(如运行测试代码 test.py ):

2.3 登录微信

如果运行在Linux下,还可以通过设置 WXBot 对象的 conf['qr'] 为 tty 的方式直接在终端打印二维码(此方法只能在Linux终端下使用),效果如下:

3 效果展示

测试代码 test.py 的运行效果:

4 接口

4.1 handle_msg_all

handle_msg_all 函数的参数 msg 是代表一条消息的字典。字段的内容为:

字段名字段内容msg_type_id整数,消息类型,具体解释可以查看 消息类型表msg_id字符串,消息idcontent字典,消息内容,具体含有的字段请参考 消息类型表 ,一般含有 type(数据类型)与 data(数据内容)字段,type 与 data的对应关系可以参考 数据类型表user字典,消息来源,字典包含 name(发送者名称,如果是群则为群名称,如果为微信号,有备注则为备注名,否则为微信号或者群昵称)字段与 id(发送者id)字段,都是字符串

4.2 消息类型表

类型号消息类型content0初始化消息,内部数据无意义,可以忽略1自己发送的消息无意义,可以忽略2文件消息字典,包含 type 与 data 字段3群消息字典, 包含 user (字典,包含 id 与 name字段,都是字符串,表示发送此消息的群用户)与 type 、 data 字段,红包消息只有 type 字段, 文本消息还有detail、desc字段, 参考 群文本消息4联系人消息字典,包含 type 与 data 字段5公众号消息字典,包含 type 与 data 字段6特殊账号消息字典,包含 type 与 data 字段99未知账号消息无意义,可以忽略

4.3 数据类型表

type数据类型data0文本字符串,表示文本消息的具体内容1地理位置字符串,表示地理位置3图片字符串,图片数据的url,HTTP POST请求此url可以得到jpg文件格式的数据4语音字符串,语音数据的url,HTTP POST请求此url可以得到mp3文件格式的数据5名片字典,包含 nickname (昵称), alias (别名),province (省份),city (城市), gender (性别)字段6动画字符串, 动画url, HTTP POST请求此url可以得到gif文件格式的数据7分享字典,包含 type (类型),title (标题),desc (描述),url (链接),from (源网站)字段8视频不可用9视频电话不可用10撤回消息不可用11空内容空字符串12红包不可用13小视频字符串,视频数据的url,HTTP POST请求此url可以得到mp4文件格式的数据99未知类型不可用

4.4 群文本消息

由于群文本消息中可能含有@信息,因此群文本消息的 content 字典除了含有 type 与 data 字段外,还含有 detail 与 desc 字段。

各字段内容为:

字段内容type数据类型, 为0(文本)data字符串,消息内容,含有@信息desc字符串,删除了所有@信息detail数组,元素类型为含有 type 与 value 字段的字典, type 为字符串 str (表示元素为普通字符串,此时value为消息内容) 或 at (表示元素为@信息, 此时value为所@的用户名)

4.5 WXBot对象属性

WXBot 对象在登录并初始化之后,含有以下的可用数据:

属性描述contact_list当前用户的微信联系人列表group_list当前用户的微信群列表public_list当前用户关注的公众号列表special_list特殊账号列表sessionWXBot 与WEB微信服务器端交互所用的 Requests Session 对象

4.6 WXBot对象方法

WXBot 对象还含有一些可以利用的方法

方法描述get_icon(uid, gid)获取联系人或者群聊成员头像并保存到本地文件 img_[uid].jpg , uid 为用户id, gid 为群idget_head_img(id)获取用户头像并保存到本地文件 img_[id].jpg ,id 为用户id(Web微信数据)get_msg_img(msgid)获取图像消息并保存到本地文件 img_[msgid].jpg , msgid 为消息id(Web微信数据)get_voice(msgid)获取语音消息并保存到本地文件 voice_[msgid].mp3 , msgid 为消息id(Web微信数据)get_video(msgid)获取视频消息并保存到本地文件 video_[msgid].mp4 , msgid 为消息id(Web微信数据)get_contact_name(uid)获取微信id对应的名称,返回一个可能包含 remark_name (备注名), nickname (昵称), display_name (群名称)的字典send_msg_by_uid(word, dst)向好友发送消息,word 为消息字符串,dst 为好友用户id(Web微信数据)send_img_msg_by_uid(fpath, dst)向好友发送图片消息,fpath 为本地图片文件路径,dst 为好友用户id(Web微信数据)send_file_msg_by_uid(fpath, dst)向好友发送文件消息,fpath 为本地文件路径,dst 为好友用户id(Web微信数据)send_msg_by_uid(word, dst)向好友发送消息,word 为消息字符串,dst 为好友用户id(Web微信数据)send_msg(name, word, isfile)向好友发送消息,name 为好友的备注名或者好友微信号, isfile为 False 时 word 为消息,isfile 为 True 时 word 为文件路径(此时向好友发送文件里的每一行),此方法在有重名好友时会有问题,因此更推荐使用 send_msg_by_uid(word, dst)is_contact(uid)判断id为 uid 的账号是否是本帐号的好友,返回 True (是)或 False (不是)is_public(uid)判断id为 uid 的账号是否是本帐号所关注的公众号,返回 True (是)或 False (不是)

5 群聊机器人示例

bot.py 用 图灵机器人 API 以及 wxBot 实现了一个自动回复机器人.

此机器人会回复来自联系人的消息,以及群里@此账号的消息。

并且本帐号可以通过发送 退下 、 走开 、 关闭 、 关掉 、 休息 、 滚开 来关闭机器人的自动回复。

也可以通过发送 出来 、 启动 、 工作 来再次开启机器人的自动回复。

群聊时需要将对应的群保存到联系人列表。

群聊实现效果:

bot.py 的运行方法:

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20181007A1JU6500?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券