30行代码实现微信自动回复机器人

一、写在前面

很多朋友对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

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