如何用 30 行代码实现微信自动回复机器人？

article/2025/8/23 8:06:14

640?wx_fmt=gif

640?wx_fmt=jpeg

作者 | Ahab

责编 | 胡巍巍

写在前面

很多朋友对itchat非常感兴趣，近日又学到了itchat另一种有趣的玩法——微信自动回复机器人。

程序很简单仅仅三十行代码左右，实现了机器人自动与你的微信好友聊天，下面是我的机器人小笼包跟自己微信好友聊天的截图。

640?wx_fmt=png

640?wx_fmt=jpeg

640?wx_fmt=png

再给大家看看两个机器人的对话。

640?wx_fmt=jpeg

程序介绍

本程序通过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()