https://blog.csdn.net/u012315529/article/details/86501772
itchat 接口说明文档
2019年01月16日 08:53:20 混元大仙 阅读数 2191
python实现微信接口——itchat模块
python实现微信接口——itchat模块
安装
sudo pip install itchat
登录
itchat.auto_login()这种方法将会通过微信扫描二维码登录,但是这种登录的方式确实短时间的登录,并不会保留登录的状态,也就是下次登录时还是需要扫描二维码,如果加上hotReload==True,那么就会保留登录的状态,至少在后面的几次登录过程中不会再次扫描二维码,该参数生成一个静态文件itchat.pkl用于存储登录状态
退出及登录完成后调用的特定的方法
这里主要使用的是灰调函数的方法,登录完成后的方法需要赋值在loginCallback 中退出后的方法,需要赋值在exitCallback 中.若不设置loginCallback 的值, 将会自动删除二维码图片并清空命令行显示.
importitchat, time
deflc():
print("Finash Login!")
defec():
print("exit")
itchat.auto_login(loginCallback=lc, exitCallback=ec)
time.sleep()
itchat.logout()#强制退出登录
回复消息
send
send(msg="Text Message", toUserName=None)
参数:
msg: 文本消息内容
@fil@path_to_file: 发送文件
@img@path_to_img: 发送图片
@vid@path_to_video: 发送视频
toUserName: 发送对象, 如果留空, 将发送给自己.
返回值
TrueorFalse
实例代码
# coding-utf-8
import itchat
itchat.auto_login()
itchat.send("Hello World!")
ithcat.send("@fil@%s"%'/tmp/test.text')
ithcat.send("@img@%s"%'/tmp/test.png')
ithcat.send("@vid@%s"%'/tmp/test.mkv')
send_msg
send_msg(msg='Text Message', toUserName=None),其中的的msg是要发送的文本,toUserName是发送对象, 如果留空, 将发送给自己,返回值为True或者False
实例代码
importitchat
itchat.auto_login()
itchat.send_msg("hello world.")
send_file
send_file(fileDir, toUserName=None)fileDir是文件路径, 当文件不存在时, 将打印无此文件的提醒,返回值为True或者False
实例代码
mport itchat
itchat.auto_login()
itchat.send_file("/tmp/test.txt")
send_image
send_image(fileDir, toUserName=None)参数同上
实例代码
importitchat
itchat.auto_login()
itchat.send_img("/tmp/test.txt")
send_video
send_video(fileDir, toUserName=None)参数同上
实例代码
importitchat
itchat.auto_login()
itchat.send_video("/tmp/test.txt")
注册消息方法
itchat将根据接受到的消息类型寻找对应的已注册的方法.如果一个消息类型没有对应的注册方法, 该消息将会被舍弃.在运行过程中也可以动态注册方法, 注册方式与结果不变.
注册方法
不带具体对象注册, 将注册为普通消息的回复方法.
importitchat
fromitchat.contentimport*
@itchat.msg_register(TEXT) #这里的TEXT表示如果有人发送文本消息,那么就会调用下面的方法
defsimple_reply(msg):
#这个是向发送者发送消息
itchat.send_msg('已经收到了文本消息,消息内容为%s'%msg['Text'],toUserName=msg['FromUserName'])
return"T reveived: %s"% msg["Text"]#返回的给对方的消息,msg["Text"]表示消息的内容
带对象参数注册, 对应消息对象将调用该方法,其中isFriendChat表示好友之间,isGroupChat表示群聊,isMapChat表示公众号
importitchat
fromitchat.contentimport*
@itchat.msg_register(TEXT, isFriendChat=True, isGroupChat=True,isMpChat=True)
deftext_reply(msg):
msg.user.send("%s : %s"% (mst.type, msg.text))
消息类型向注册方法传入的msg包含微信返回的字典的所有内容.itchat增加Text,Type(也就是参数) 键值, 方便操作.
itcaht.content 中包含所有的消息类型参数, 如下表
参数l类型Text 键值
TEXT文本文本内容(文字消息)
MAP地图位置文本(位置分享)
CARD名片推荐人字典(推荐人的名片)
SHARING分享分享名称(分享的音乐或者文章等)
PICTURE 下载方法 图片/表情
RECORDING语音下载方法
ATTACHMENT附件下载方法
VIDEO小视频下载方法
FRIENDS好友邀请添加好友所需参数
SYSTEM系统消息更新内容的用户或群聊的UserName组成的列表
NOTE通知通知文本(消息撤回等)
附件的下载与发送
itchat的附件下载方法存储在msg的Text键中.发送的文件名(图片给出的默认文件名), 都存储在msg的FileName键中.下载方法, 接受一个可用的位置参数(包括文件名), 并将文件响应的存储.注意:下载的文件存储在指定的文件中,直接将路径与FileName连接即可,如msg["Text"]('/tmp/weichat'+msg['FileName'])
@itchat.msg_register([PICTURE, RECORDING, ATTACHMENT, VIDEO])
defdownload_files(msg):
#msg.download(msg['FileName']) #这个同样是下载文件的方式
msg['Text'](msg['FileName'])#下载文件
#将下载的文件发送给发送者
itchat.send('@%s@%s'% ('img'ifmsg['Type'] =='Picture'else'fil', msg["FileName"]), msg["FromUserName"])
群消息
增加了三个键值,如下:
isAt判断是否 @ 本号
ActualNickName: 实际NickName(昵称)
Content: 实际Content
测试程序
importitcaht
fromitchat.contentimportTEXT
@itchat.msg_register(TEXT, isGroupChat=True)
deftext_reply(msg):
if(msg.isAt):#判断是否有人@自己
#如果有人@自己,就发一个消息告诉对方我已经收到了信息
itchat.send_msg("我已经收到了来自{0}的消息,实际内容为{1}".format(msg['ActualNickName'],msg['Text']),toUserName=msg['FromUserName'])
itchat.auto_login()
itchat.run()
注册消息的优先级
总的来说就是后面注册同种类型的消息会覆盖之前注册的消息,详情见文档https://itchat.readthedocs.io/zh/latest/
消息内容
注意:所有的消息内容都是可以用键值对来访问的,如msg["FromUserName]就是查看发送者,itchat.search_friends(userName=msg['FromUserName'])['NickName']查看的是当发送者昵称
一般消息
一般的消息都遵循以下的内容:
{
"FromUserName":"",
"ToUserName":"",
"Content":"",
"StatusNotifyUserName":"",
"ImgWidth":0,
"PlayLength":0,
"RecommendInfo": {},
"StatusNotifyCode":0,
"NewMsgId":"",
"Status":0,
"VoiceLength":0,
"ForwardFlag":0,
"AppMsgType":0,
"Ticket":"",
"AppInfo": {},
"Url":"",
"ImgStatus":0,
"MsgType":0,
"ImgHeight":0,
"MediaId":"",
"MsgId":"",
"FileName":"",
"HasProductId":0,
"FileSize":"",
"CreateTime":0,
"SubMsgType":0
}
初始化消息
MsgType:51
FromUserName: 自己ID
ToUserName: 自己ID
StatusNotifyUserName: 最近联系的联系人ID
Content:
# 最近联系的联系人
filehelper,xxx@chatroom,wxid_xxx,xxx,...
# 朋友圈
MomentsUnreadMsgStatus
1454502365
# 未读的功能账号消息,群发助手,漂流瓶等
文本消息
MsgType: 1
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: 消息内容
图片消息
itchat增加了Text键, 键值为 下载该图片的方法.
MsgType:3
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取图片,用于表示每一条消息
Content:
拓展:如果想要得到Content中的具体内容可以使用正则表达式匹配出来
视频消息
*itchat增加了Text键, 键值为 下载该视频的方法.*
MsgType:62
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取小视频
Content:
地理位置消息
itchat增加了Text键, 键值为 该地点的文本形式.
MsgType: 1
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: http://weixin.qq.com/cgi-bin/redirectforward?args=xxx
OriContent:
名片消息
itchat增加了Text键, 键值为 该调用add_friend需要的属性.
MsgType:42
FromUserName: 发送方ID
ToUserName: 接收方ID
Content:
RecommendInfo:
{
"UserName":"xxx",# ID,这里的是昵称
"Province":"xxx",
"City":"xxx",
"Scene":17,
"QQNum":0,
"Content":"",
"Alias":"xxx",# 微信号
"OpCode":0,
"Signature":"",
"Ticket":"",
"Sex":0,# 1:男, 2:女
"NickName":"xxx",# 昵称
"AttrStatus":4293221,
"VerifyFlag":0
}
下面是添加好友的测试代码
@itchat.msg_register(itchat.content.CARD,isFriendChat=True)
defsimply(msg):
printmsg['Text']
printmsg['Content']
itchat.add_friend(userName=msg['Text']['UserName'])#添加推荐的好友
printmsg['RecommendInfo']
printmsg['RecommendInfo']['UserName']
语音消息
*itchat增加了Text键,键值为下载该语音文件的方法,下载下来的是MP3的格式
MsgType:34
FromUserName: 发送方ID
ToUserName: 接收方ID
MsgId: 用于获取语音
Content:
下载方法:msg['Text'](msg['FileName'])
动画表情
itchat添加了Text键,键值为下载该图片表情的方法。注意:本人亲测对于一些微信商店提供的表情是不能下载成功的,这里的自带的表情emoji是属于TEXT类别的,因此如果将其注册为PICTURE消息类型的话是不可以监测到的
MsgType:47
FromUserName: 发送方ID
ToUserName: 接收方ID
Content:
普通链接或应用分享消息
主要针对的是分享的文章等等
MsgType:49
AppMsgType:5
FromUserName: 发送方ID
ToUserName: 接收方ID
Url: 链接地址
FileName: 链接标题
Content:
5
...
音乐链接消息
主要针对的是音乐
MsgType: 49
AppMsgType: 3
FromUserName: 发送方ID
ToUserName: 接收方ID
Url: 链接地址
FileName: 音乐名
AppInfo: # 分享链接的应用
{
Type: 0,
AppID: wx485a97c844086dc9
}
Content:
3
0
0
http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
http://ws.stream.qqmusic.qq.com/C100003i9hMt1bgui0.m4a?vkey=6867EF99F3684&guid=ffffffffc104ea2964a111cf3ff3edaf&fromtag=46
0
http://imgcache.qq.com/music/photo/album/63/180_albumpic_143163_0.jpg
0
29
摇一摇搜歌
群消息
itchat增加了三个群聊相关的键值:
isAt: 判断是否 @ 本号
ActualNickName: 实际NickName
Content: 实际Content
MsgType:1
FromUserName:@@xxx
ToUserName:@xxx
Content:
@xxx:
xxx
红包消息
MsgType: 49
AppMsgType: 2001
FromUserName: 发送方ID
ToUserName: 接收方ID
Content: 未知
系统消息
MsgType:10000
FromUserName: 发送方ID
ToUserName: 自己ID
Content:
"你已添加了 xxx ,现在可以开始聊天了。"
"如果陌生人主动添加你为朋友,请谨慎核实对方身份。"
"收到红包,请在手机上查看"
账号类型
tchat为三种账号都提供了 整体获取方法与搜索方法.
好友
get_friends
itchat.get_friends()返回完整的好友列表
每个好友为一个字典, 其中第一项为本人的账号信息;
传入 update=True, 将更新好友列表并返回,get_friends(update=True)
search_friends
itchat.get_friends() 好友搜索,有以下四种方式
仅获取自己的用户信息
# 获取自己的用户信息,返回自己的属性字典
itchat.search_friends()
获取特定UserName的用户信息
# 获取特定UserName的用户信息
itchat.search_friends(userName='@abcdefg1234567')
## 获取发送信息的好友的详细信息
@itchat.msg_register(itchat.content.TEXT,isFriendChat=True)
defreply(msg):
printmsg['FromUserName']
printitchat.search_friends(userName=msg['FromUserName'])#详细信息
printitchat.search_friends(userName=msg['FromUserName'])['NickName']#获取昵称
获取备注,微信号, 昵称中的任何一项等于name键值的用户. (可以与下一项配置使用.)
比如在我的微信中有一个备注为autolife的人,我可以使用这个方法搜索出详细的信息
# 获取任何一项等于name键值的用户
itchat.search_friends(name='autolife')
获取备注,微信号, 昵称分别等于相应键值的用户. (可以与上一项配置使用.)
# 获取分别对应相应键值的用户
itchat.search_friends(wechatAccount='littlecodersh')
# 三、四项功能可以一同使用
itchat.search_friends(name='LittleCoder机器人', wechatAccount='littlecodersh')
update_friend
主要用于好友更新
特定用户: 传入用户UserName, 返回指定用户的最新信息.
用户列表: 传入UserName组成的列表, 返回用户最新信息组成的列表
memberList = itchat.update_friend('@abcdefg1234567')
公众号
get_mps
将返回完整的工作号列表
每个公众号为一个字典,
传入update=True将更新公众号列表, 并返回.
search_mps
获取特定UserName的公众号
# 获取特定UserName的公众号,返回值为一个字典
itchat.search_mps(userName='@abcdefg1234567')
获取名字中还有特定字符的公众号.
# 获取名字中含有特定字符的公众号,返回值为一个字典的列表
itchat.search_mps(name='LittleCoder')
当两项都是勇士, 将仅返回特定UserName的公众号.
群聊
get_chatrooms: 返回完整的群聊列表.
search_chatrooms: 群聊搜索.
update_chatroom: 获取群聊用户列表或更新该群聊.
群聊在首次获取中不会获取群聊的用户列表, 所以需要调用该命令才能获取群聊成员.
传入群聊的UserName, 返回特定群聊的详细信息.
传入UserName组成的列表, 返回指定用户的最新信息组成的列表.
memberList = itchat.update_chatroom('@@abcdefg1234567', detailedMember=True)
创建群聊,增加/删除群聊用户:
由于之前通过群聊检测是否被好友拉黑的程序, 目前这三个方法都被严格限制了使用频率.
删除群聊需要本账号为管理员, 否则无效.
将用户加入群聊有直接加入与发送邀请, 通过useInvitation设置.
超过 40 人的群聊无法使用直接加入的加入方式.
memberList = itchat.get_frients()[1:]
# 创建群聊, topic 键值为群聊名称.
chatroomUserName = itchat.create_chatroom(memberList,"test chatroom")
# 删除群聊内的用户
itchat.delete_member_from_chatroom(chatroomUserName, memberList[0])
# 增加用户进入群聊.
itchat.add_member_into_chatroom(chatroomUserName, memberList[0], useInvitation=False)
方法汇总
itchat.add_friend
itchat.new_instance
itchat.add_member_into_chatroom
itchat.originInstance
itchat.auto_login
itchat.returnvalues
itchat.check_login
itchat.run
itchat.components
itchat.search_chatrooms
itchat.config
itchat.search_friends
itchat.configured_reply
itchat.search_mps
itchat.content
itchat.send
itchat.core
itchat.send_file
itchat.Core
itchat.send_image
itchat.create_chatroom
itchat.send_msg
itchat.delete_member_from_chatroom
itchat.send_raw_msg
itchat.dump_login_status
itchat.send_video
itchat.get_chatrooms
itchat.set_alias
itchat.get_contact
itchat.set_chatroom_name
itchat.get_friends
itchat.set_logging
itchat.get_head_img
itchat.set_pinned
itchat.get_mps
itchat.show_mobile_login
itchat.get_msg
itchat.start_receiving
itchat.get_QR
itchat.storage
itchat.get_QRuuid
itchat.update_chatroom
itchat.instanceList
itchat.update_friend
itchat.load_login_status
itchat.upload_file
itchat.log
itchat.utils
itchat.login
itchat.VERSION
itchat.logout
itchat.web_init
itchat.msg_register