一、写在前面
很多朋友对itchat非常感兴趣,今天下午又学到了itchat另一种有趣的玩法---微信自动回复机器人。
程序很简单仅仅三十行代码左右,实现了机器人自动与你的微信好友聊天,下面是我的机器人小笼包跟自己微信好友聊天的截图。
二、程序介绍
本程序通过itchat获取微信的相关消息,将微信消息传输到机器人接口(本程序使用的是图灵),获取机器人的返回消息。将返回消息返回给微信消息的发送人。以此实现将微信个人号变身为聊天机器人。
三、具体实现
安装
itchat的安装可以通过下面这行代码
1pip install itchat
登录
itchat.auto_login() 这种方法将会通过微信扫描二维码登录,但是这种登录的方式确实短时间的登录,并不会保留登录的状态,也就是下次登录时还是需要扫描二维码。
1# 扫描二维码登陆微信,实际上就是通过网页版微信登陆
2 itchat.auto_login()
如果加上hotReload==True,那么就会保留登录的状态,至少在后面的几次登录过程中不会再次扫描二维码,该参数生成一个静态文件itchat.pkl用于存储登录状态
1itchat.auto_login(hotReload=True)
微信信息的发送
微信可以发送各类消息,文本、图片、文件等,下面是具体的方法的介绍。
1itchat.send('Message Content', 'toUserName')
该发送消息的函数需要两个参数,消息的内容与接受者的UserName,即标识符。
用下面的代码举一个小栗子,实现向文件助手发送信息。
1import itchat
2
3itchat.auto_login(hotReload=True)
4itchat.send(u'测试消息发送', 'filehelper')
微信消息的获取
itchat 将根据接受到的消息类型寻找对应的已注册的方法。如果一个消息类型没有对应的注册方法, 该消息将会被舍弃。在运行过程中也可以动态注册方法, 注册方式与结果不变。
注册方法
不带具体对象注册, 将注册为普通消息的回复方法.
1 import itchat
2 from itchat.content import *
3 @itchat.msg_register(TEXT) #这里的TEXT表示如果有人发送文本消息,那么就会调用下面的方法
4 def simple_reply(msg):
5 #这个是向发送者发送消息
6 itchat.send_msg('已经收到了文本消息,消息内容为%s'%msg['Text'],toUserName=msg['FromUserName'])
7 return "T reveived: %s" % msg["Text"] #返回的给对方的消息,msg["Text"]表示消息的内容
带对象参数注册, 对应消息对象将调用该方法,其中isFriendChat表示好友之间,isGroupChat表示群聊,isMapChat表示公众号。
1import itchat
2from itchat.content import *
3
4@itchat.msg_register(TEXT, isFriendChat=True, isGroupChat=True,isMpChat=True)
5def text_reply(msg):
6 msg.user.send("%s : %s" % (mst.type, msg.text))
消息类型
向注册方法传入的 msg 包含微信返回的字典的所有内容.itchat 增加 Text, Type(也就是参数) 键值, 方便操作。
itcaht.content 中包含所有的消息类型参数。例如图片、语音、名片、分享等,也对应不同的注册参数:
图片对应
itchat.content.PICTURE
语音对应
itchat.content.RECORDING
名片对应
itchat.content.CARD
其余的可以参考官方API
https://pypi.org/project/itchat/
1import itchat
2
3@itchat.msg_register(itchat.content.TEXT)
4def print_content(msg):
5 print(msg['Text'])
6
7itchat.auto_login()
8itchat.run()
通过运行上面的代码,实现基础的文本信息的接收。
实现与图灵机器人的交互
实现机器人有很多种方法,最简单的就是使用他人提供的接口。这里以图灵机器人为例,演示这一功能。图灵机器人简单而言就是以一定的规则给图灵的服务器发送数据包(包含你对他说的话)图灵的服务器会以一定的规则给你返回数据包(包含他回复你的话)
你需要一个Tuling Key来告诉图灵服务器你有权和他对话。
18edce3ce905a4c1dbb965e6b35c3834d
2eb720a8970964f3f855d863d24406576
31107d5601866433dba9599fac1bc0083
471f28bf79c820df10d39b4074345ef8c
接下来需配置图灵机器人
1{
2 'key' : 'TULING_KEY',
3 'info' : 'YOUR_MSG',
4 'userid' : 'USERID',
5}
下面使用图灵机器人向好友发送了hello
1#coding=utf8
2import requests
3
4apiUrl = 'http://www.tuling123.com/openapi/api'
5data = {
6 'key' : '8edce3ce905a4c1dbb965e6b35c3834d', # 如果这个Tuling Key不能用,那就换一个
7 'info' : 'hello', # 这是我们发出去的消息
8 'userid' : 'wechat-robot', # 这里你想改什么都可以
9}
10# 我们通过如下命令发送一个post请求
11r = requests.post(apiUrl, data=data).json()
12
13# 让我们打印一下返回的值,看一下我们拿到了什么
14print(r)
完整代码:
1import requests
2import itchat
3
4KEY = '8edce3ce905a4c1dbb965e6b35c3834d'
5
6def get_response(msg):
7 # 这里实现与图灵机器人的交互
8 # 构造了要发送给服务器的数据
9 apiUrl = 'http://www.tuling123.com/openapi/api'
10 data = {
11 'key' : KEY,
12 'info' : msg,
13 'userid' : 'wechat-robot',
14 }
15 try:
16 r = requests.post(apiUrl, data=data).json()
17 # 字典的get方法在字典没有'text'值的时候会返回None而不会抛出异常
18 return r.get('text')
19 # 为了防止服务器没有正常响应导致程序异常退出,这里用try-except捕获了异常
20 # 如果服务器没能正常交互(返回非json或无法连接),那么就会进入下面的return
21 except:
22 # 将会返回一个None
23 return
24
25# 这里实现微信消息的获取
26@itchat.msg_register(itchat.content.TEXT)
27def tuling_reply(msg):
28 # 为了保证在图灵Key出现问题的时候仍旧可以回复,这里设置一个默认回复
29 defaultReply = 'I received: ' + msg['Text']
30 # 如果图灵Key出现问题,那么reply将会是None
31 reply = get_response(msg['Text'])
32 # a or b的意思是,如果a有内容,那么返回a,否则返回b
33 # 有内容一般就是指非空或者非None,你可以用`if a: print('True')`来测试
34 return reply or defaultReply
35
36# 为了让实验过程更加方便(修改程序不用多次扫码),我们使用热启动
37itchat.auto_login(hotReload=True)
38itchat.run()
itchat不仅仅能够实现自动回复,还有其他的相关功能比如群发助手,好友单删检测,获取微信好友信息等功能,后续会慢慢去体验各种玩法。
小提示:不要频繁操作,否则会禁止登录web微信。
原文发布时间为:2018-11-30
本文作者:Ahab
本文来自云栖社区合作伙伴“Python中文社区”,了解相关信息可以关注“python-china”微信公众号