微信 wechat web 网页版接口的 JavaScrip

wechat4u.js

Announcing wechat4u v0.7.12 Features 导出和导入保持微信登录的必要数据 bot.botData (#160) 修改联系人备注 bot.updateRemarkName(UserName, RemarkName) (#121) 修改群名 bot.updateChatRoomName(ChatRoomUserName, NewName) (#168) 转发消息 bot.forwardMsg(msg, toUserName) 撤回消息 bot.revokeMsg(MsgID, toUserName) Changes 支持uos协议，所有微信均可使用，请先微信实名认证后使用 发送消息的一类方法在成功时会返回完整响应数据 bot.user 对象中不再存储用户头像的 base64 数据 移除 example 目录 修复 Contact 和 Message 中数据某些数据不可枚举 向上层代码传递完整的 Error 对象，并将原来的中文错误描述放在 err.tips bot.getContact(Seq) 方法增加 Seq 参数，支持增量获取完整联系人 安装使用

npm install --save wechat4u@latest

const Wechat = require('wechat4u') let bot = new Wechat() bot.start() // 或使用核心API // const WechatCore = require('wechat4u/lib/core') 开发测试

git clone https://github.com/nodeWechat/wechat4u.git cd wechat4u npm install npm run core // 命令行模式 npm run compile // babel编译 使用范例

node run-core.js

逻辑见代码，简明完整，一定要看

实例化Wechat类

let bot = new Wechat([botData])

若传入botData，则使用此机器人信息，重新开始之前的同步

实例属性

所有属性均只读

bot.botData

可导出的实例基本信息，在下次new新bot时，可以填入此信息，重新同步

bot.PROP

保持登录状态的必要信息

bot.CONF

配置信息，包括当前服务器地址，API路径和一些常量

程序中需要使用CONF中的常量来判断当前状态的新消息类型

bot.state == bot.CONF.STATE.init // 初始化状态 bot.state == bot.CONF.STATE.uuid // 已获取 UUID bot.state == bot.CONF.STATE.login // 已登录 bot.state == bot.CONF.STATE.logout // 已退出登录 msg.MsgType == bot.CONF.MSGTYPE_TEXT // 文本消息 msg.MsgType == bot.CONF.MSGTYPE_IMAGE // 图片消息 msg.MsgType == bot.CONF.MSGTYPE_VOICE // 语音消息 msg.MsgType == bot.CONF.MSGTYPE_EMOTICON // 自定义表情消息 msg.MsgType == bot.CONF.MSGTYPE_MICROVIDEO // 小视频消息 msg.MsgType == bot.CONF.MSGTYPE_VIDEO // 视频消息 bot.state

当前状态

bot.user

当前登录用户信息

bot.contacts

所有联系人，包括通讯录联系人，近期联系群，公众号

key为联系人UserName，UserName是本次登录时每个联系人的UUID，不过下次登录会改变

value为Contact对象，具体属性方法见src/interface/contact.js

msg

登录后接受到的所有消息

msg为Message对象，具体属性方法见src/interface/message.js

实例API bot.start()

启动实例，登录和保持同步

调用该方法后，通过监听事件来处理消息

bot.restart()

利用实例已获取的必要信息，重新登录和进行同步

bot.stop()

停止实例，退出登录

调用该方法后，通过监听logout事件来登出

bot.setPollingMessageGetter(getter)

自定义心跳消息内容

getter 函数返回心跳消息内容

typeof(getter()) 应为 "string"

bot.setRollingMessageGetter(function () { // return (new Date()).toJSON(); }); bot.setPollingIntervalGetter(getter)

自定义心跳间隔

getter 函数返回心跳间隔（以毫秒为单位）

typeof(getter()) 应为 "number"

bot.setRollingIntervalGetter(function () { return 2 * 60 * 1000; }); bot.setPollingTargetGetter(getter)

自定义心跳目标用户

getter 函数返回目标用户的 UserName （形如 @xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ）

typeof(getter()) 应为 "string"

注： 如要使用 bot.user.UserName ，需在 login 事件后定义目标用户

bot.setRollingmeGetter(function () { return bot.user.UserName; });

以下方法均返回Promise

bot.sendText(msgString, toUserName)

发送文本消息，可以包含emoji()和QQ表情([坏笑])

bot.uploadMedia(Buffer | Stream | File, filename, toUserName)

上传媒体文件

返回

{ name: name, size: size, ext: ext, mediatype: mediatype, mediaId: mediaId } bot.sendPic(mediaId, toUserName)

发送图片，mediaId为uploadMedia返回的mediaId

bot.uploadMedia(fs.createReadStream('test.png')) .then(res => { return bot.sendPic(res.mediaId, ToUserName) }) .catch(err => { console.log(err) }) bot.sendEmoticon(md5 | mediaId, toUserName)

发送表情，可是是表情的MD5或者uploadMedia返回的mediaId

表情的MD5，可以自己计算但是可能不存在在微信服务器中，也可以从微信返回的表情消息中获得

bot.sendVideo(mediaId, toUserName)

发送视频

bot.sendDoc(mediaId, name, size, ext, toUserName)

以应用卡片的形式发送文件，可以通过这个API发送语音

bot.sendMsg(msg, toUserName)

对以上发送消息的方法的封装，是发送消息的通用方法

当msg为string时，发送文本消息

当msg为{file:xxx,filename:'xxx.ext'}时，发送对应媒体文件

当msg为{emoticonMd5:xxx}时，发送表情

bot.sendMsg({ file: request('https://raw.githubusercontent.com/nodeWechat/wechat4u/master/bot-qrcode.jpg'), filename: 'bot-qrcode.jpg' }, ToUserName) .catch(err => { console.log(err) }) bot.forwardMsg(msg, toUserName)

转发消息，msg为message事件传递的msg对象

bot.revokeMsg(MsgID, toUserName)

撤回消息

MsgID为发送消息后返回的代表消息的ID

bot.sendMsg('测试撤回', toUserName) .then(res => { return bot.revokeMsg(res.MsgID, toUserName) }) .catch(err => { console.log(err) }) bot.getContact(Seq)

获取通讯录中的联系人

Seq 上一次调用 bot.getContact 后返回的 seq，第一次调用可不传

bot.batchGetContact(contacts)

批量获取指定联系人数据

contacts 数组，指定需要获取的数据

当contacts为[{UserName: xxx}]时，可获取指定联系人或群信息

当contacts为[{UserName: xxx, EncryChatRoomId: xxx}]时，可获取指定群内成员详细信息，EncryChatRoomId 可从群信息中获得

bot.getHeadImg(HeadImgUrl)

获取联系人头像

bot.getHeadImg(bot.contacts[UserName].HeadImgUrl).then(res => { fs.writeFileSync(`${UserName}.jpg`, res.data) }).catch(err => { console.log(err) }) bot.getMsgImg(MsgId)

获取图片或表情

bot.getMsgImg(msg.MsgId).then(res => { fs.writeFileSync(`${msg.MsgId}.jpg`, res.data) }).catch(err => { console.log(err) }) bot.getVoice(MsgId)

获取语音

bot.getVideo(MsgId)

获取小视频或视频

bot.getDoc(UserName, MediaId, FileName)

获取文件，消息的MsgType为49且AppMsgType为6时即为文件。

bot.addFriend(UserName, Content)

添加好友

UserName 一般可从群信息中获得

Content 验证信息

bot.verifyUser(UserName, Ticket)

通过好友添加请求

bot.createChatroom(Topic, MemberList)

创建群

Topic 群聊名称

MemberList 数组, 除自己外至少两人的UserName，格式为 [ {"UserName":"@250d8d156ad9f8b068c2e3df3464ecf2"}, {"UserName":"@42d725733741de6ac53cbe3738d8dd2e"} ]

bot.updateChatroom(ChatRoomUserName, MemberList, fun)

更新群成员

ChatRoomUserName '@@'开头的群UserName

MemberList 数组，联系人UserNa

fun 可选'addmember'，'delmember'，'invitemember'

bot.updateChatRoomName(ChatRoomUserName, NewName)

更新群名称

ChatRoomUserName '@@'开头的群UserName

NewName 字符串，新的群名称

bot.opLog(UserName, OP)

置顶或取消置顶联系人，可通过直接取消置顶群来获取群ChatRoomOwner

OP == 0 取消置顶

OP == 1 置顶

bot.updateRemarkName(UserName, RemarkName)

设置联系人备注或标签

实例事件 uuid

得到uuid，之后可以构造二维码或从微信服务器取得二维码

bot.on('uuid', uuid => { qrcode.generate('https://login.weixin.qq.com/l/' + uuid, { small: true }) console.log('二维码链接：', 'https://login.weixin.qq.com/qrcode/' + uuid) }) user-avatar

手机扫描后可以得到登录用户头像的Data URL

login

手机确认登录

logout

成功登出

contacts-updated

联系人更新，可得到已更新的联系人列表

message

所有通过同步得到的消息，通过msg.MsgType判断消息类型

bot.on('message', msg => { switch (msg.MsgType) { case bot.CONF.MSGTYPE_STATUSNOTIFY: break case bot.CONF.MSGTYPE_TEXT: break case bot.CONF.MSGTYPE_RECALLED: break } }) error Contact对象和Message对象

每个contact，继承自 interface/contact，除原本 json 外，扩展以下属性：

contact.AvatarUrl // 处理过的头像地址 contact.isSelf // 是否是登录用户本人 contact.getDisplayName() contact.canSearch(keyword)

此外，wechat4u 在实例上提供 Contact 作为联系人的通用接口，扩展以下属性：

wechat.Contact.isRoomContact() wechat.Contact.isSpContact() wechat.Contact.isPublicContact() wechat.Contact.getUserByUserName() wechat.Contact.getSearchUser(keyword)

每个msg 对象继承自 interface/message，出原本 json 外，具有以下属性：

message.isSendBySelf // 是否是本人发送 message.isSendBy(contact) message.getPeerUserName() // 获取所属对话的联系人 UserName message.getDisplayTime() // 获取形如 12:00 的时间戳信息 相关项目

关于微信网页端机器人的实现，已经有大量的轮子了。感谢各位大神！（排名不分先后。。收录的肯定也不齐。。）

Python2 的 WeixinBot QT 的 QWX Node，可能会写成uProxy插件的 uProxy_wechat Node，可在shell中直接运行的 wechat-user-bot Python3 的 wechat_robot 开放协议 支持 QQ&微信 的 wxagent 在微信网页版和 IRC 间搭建通道支持 IRC 操作的 wechatircd Chrome 插件版的微信机器人

关于微信网页端的接口说明，也有好几篇分析的很厉害的文章。

Reverland 大神的web 微信与基于node的微信机器人实现 Urinx 大神的 API Map 聂永 大神的 微信协议简单调研笔记 License

MIT