Python微信库:itchat ——实现微信自动回复

参考文章  http://www.nulll.me/index.php/archives/72.html

                 https://blog.csdn.net/mdpsdhr/article/details/61195817

我一个同学向我表示人类的本质是复读机,就一直重复我的话,然后我就一”怒“之下搜了一下微信自动回复机器人,然后发现了神奇的itchat库,利用这个库可以很简单实现自动回复的功能

开始之前,感觉有必要先介绍一下itchat的注册消息类型

  • itchat要注册消息类型,比如注册了TEXT(itchat.content.text),就会接收文本消息,其他消息不会触发函数。消息类型见库中的content.py文件
  • 消息类型判断,msg[‘Type’]
  • 消息发起者,msg[‘FromUserName’]
  • 消息接收者,msg[‘ToUserName’]
  • 文本消息,msg[‘Content’]
  • 文件名字,msg[‘FileName’],注:如果是自带的表情就会显示表情
  • 发送文件时,文件名字应该是unicode编码(这是python内部默认的编码风格)

    发送其他消息

  • 给自己发送消息只需要发出消息,不指定发送者,默认发给自己(登陆者)
    itchat.send_msg(‘nice to meet you’)
  • 发送图片,ToUser不指定时发给自己
    itchat.send_image(ImageName.decode(‘utf-8’),ToUser) # 发送图片
  • 发送视频
    itchat.send_video(VideoName.decode(‘utf-8’),ToUser) # 发送图片
  • 发送文件
    itchat.send_file(path.decode(‘utf-8’)) # 图片(文件)

我先放一下我运行成功的代码吧(我随机生成了三个机器人)

# -*- coding=utf-8 -*-
import requests
import itchat
import random

KEY = '04f44290d4cf462aae8ac563ea7aac16'


def get_response(msg):
    apiUrl = 'http://www.tuling123.com/openapi/api'
    data = {
        'key': KEY,
        'info': msg,
        'userid': 'wechat-robot',
    }
    try:
        r = requests.post(apiUrl, data=data).json()
        return r.get('text')
    except:
        return


@itchat.msg_register(itchat.content.TEXT)
def tuling_reply(msg):
    defaultReply = 'I received: ' + msg['Text']
    robots = ['——By1', '——By2', '——By3']
    reply = get_response(msg['Text'])+random.choice(robots)
    return reply or defaultReply


itchat.auto_login(hotReload=True)
# itchat.auto_login(enableCmdQR=True)这个只能生成一行行二维码,不能生成图片
itchat.run()

1、start

最简单的回复

通过如下代码,可以完成回复所有文本信息(包括群聊)。

import itchat
from itchat.content import TEXT

@itchat.msg_register
def simply_reply(msg):
    if msg['Type'] == TEXT:
       return 'I received: %s' % msg['Content']

itchat.auto_login()
itchat.run()

常用消息的配置

itchat支持所有的消息类型与群聊,下面的示例中演示了对于这些消息类型简单的配置。

import itchat
from itchat.content import *

@itchat.msg_register([TEXT,MAP,CARD,NOTE,SHARING])
def text_reply(msg):
    itchat.send('%s:%s'%(msg['Type'],msg['Text']),msg['FromeUserName'])

# 以下四类的消息的Text键下存放了用于下载消息内容的方法,传入文件地址即可
@itchat.msg_register([PICTURE, RECORDING, ATTACHMENT, VIDEO])
def download_files(msg):
    msg['Text'](msg['FileName'])
    return '@%s@%s' % ({'Picture':'img','Video':'vid'}.get(msg['Type'], 'fil'), msg['FileName'])

# 收到好友邀请自动添加好友
@itchat.msg_register(FRIENDS)
def add_friend(msg):
    itchat.add_friend(**msg['Text']) # 该操作会自动将新好友的消息录入,不需要重载通讯录
    itchat.send_msg('Nice to meet you!', msg['RecommendInfo']['UserName'])

# 在注册时增加isGroupChat=True将判定为群聊回复
@itchat.msg_register(TEXT, isGroupChat = True)
def groupchat_reply(msg):
    if msg['isAt']:
        itchat.send(u'@%s\u2005I received: %s' % (msg['ActualNickName'], msg['Content']), msg['FromUserName'])

itchat.auto_login(True)
itchat.run()

当然这里不需要深究为什么这些东西可以这么写,我在这里放出了示例程序只是为了给你一个该sdk相关代码大概样子的概念。

有了大概的模式的了解之后我们就可以进入下一部分的介绍。

2、login

在上一部分中你看到了基本的注册与登陆,而显然登陆使用的是itchat提供了auto_login方法,调用即可完成登录。

一般而言,我们都会在完成消息的注册后登陆。

当然这里需要特别强调的是三点,分别是短时间关闭重连、命令行二维码与自定义登陆内容。 itchat提供了登陆状态暂存,关闭程序后一定时间内不需要扫码即可登录。 为了方便在无图形界面使用itchat,程序内置了命令行二维码的显示。 * 如果你需要就登录状态就一些修改(例如更改提示语、二维码出现后邮件发送等)。

**0x01-1 短时间关闭程序后重连**

这样即使程序关闭,一定时间内重新开启也可以不用重新扫码。

最简单的用法就是给 auto_login 方法传入值为真的 hotReload 。

该方法会生成一个静态文件 itchat.pkl ,用于存储登陆的状态。

import itchat
from itchat.content import TEXT

@itchat.msg_register(TEXT)
def simple_reply(msg):
    print(msg['Text'])

itchat.auto_login(hotReload = True)
itchat.run()
itchat.dump_login_status()

通过设置statusStorageDir可以将静态文件指定为其他的值。

这一内置选项其实就相当于使用了以下两个函数的这一段程序:

import itchat
from itchat.content import TEXT

if itchat.load_login_status():
   @itchat.msg_register(TEXT)
   def simple_reply(msg):
       print(msg['Text'])
   itchat.run()
   itchat.dump_login_status()
else:
   itchat.auto_login()
   itchat.dump_login_status()
   print('Config stored, so exit.')

其中load_login_status与dump_login_status分别对应读取与导出设置。

通过设置传入的fileDir的值可以设定导入导出的文件。

**0x01-2 命令行二维码显示**

通过以下命令可以在登陆的时候使用命令行显示二维码:

itchat.auto_login(enableCmQR=True)

部分系统可能字幅宽度有出入,可以通过将enableCmdQR赋值为特定的倍数进行调整:

# 如部分的linux系统,块字符的宽度为一个字符(正常应为两字符),故赋值为2
itchat.auto_login(enableCmdQR=2)

默认控制台背景色为暗色(黑色),若背景色为浅色(白色),可以将enableCmdQR赋值为负值:

itchat.auto_login(enableCmdQR=-1)

**0x01-2 自定义登录过程**

如果需要控制登录的过程,可以阅读下面的内容。

同时itchat也提供了登陆所需的每一步的方法,登陆的过程按顺序为: 获取二维码uuid->获取二维码->判断是否已经登陆成功->获取初始化数据->更新微信相关信息(通讯录、手机登陆状态)->循环扫描新信息(开启心跳)

获取二维码uuid

获取生成二维码所需的uuid,并返回。

  • 方法名称: get_QRuuid
  • 所需值:无
  • 返回值:成功->uuid,失败->None

获取二维码

根据uuid获取二维码并打开,返回是否成功。

  • 方法名称: get_QR
  • 所需值:uuid
  • 返回值:成功->True,失败->False

判断是否已经登陆成功

判断是否已经登陆成功,返回扫描的状态码。

  • 方法名称: check_login
  • 所需值:uuid
  • 返回值:登陆成功->'200',已扫描二维码->'201',二维码失效->'408',未获取到信息->'0'

获取初始化数据

获取微信用户信息以及心跳所需要的数据。

  • 方法名称: web_init
  • 所需值:无
  • 返回值:存储登录微信用户信息的字典

获取微信通讯录

获取微信的所有好友信息并更新。

  • 方法名称: get_contract
  • 所需值:无
  • 返回值:存储好友信息的列表

更新微信手机登陆状态

在手机上显示登录状态。

  • 方法名称: show_mobile_login
  • 所需值:无
  • 返回值:无

循环扫描新信息(开启心跳)

循环扫描是否有新的消息,开启心跳包。

  • 方法名称: start_receiving
  • 所需值:无
  • 返回值:无

EG

一个登录例子:

import itchat, time, sys

def output_info(msg):
    print('[INFO] %s' % msg)

def open_QR():
    for get_count in range(10):
        output_info('Getting uuid')
        uuid = itchat.get_QRuuid()
        while uuid is None: uuid = itchat.get_QRuuid();time.sleep(1)
        output_info('Getting QR Code')
        if itchat.get_QR(uuid): break
        elif get_count >= 9:
            output_info('Failed to get QR Code, please restart the program')
            sys.exit()
    output_info('Please scan the QR Code')
    return uuid

uuid = open_QR()
waitForConfirm = False
while 1:
    status = itchat.check_login(uuid)
    if status == '200':
        break
    elif status == '201':
        if waitForConfirm:
            output_info('Please press confirm')
            waitForConfirm = True
    elif status == '408':
        output_info('Reloading QR Code')
        uuid = open_QR()
        waitForConfirm = False
userInfo = itchat.web_init()
itchat.show_mobile_login()
itchat.get_contract()
output_info('Login successfully as %s'%userInfo['NickName'])
itchat.start_receiving()

# Start auto-replying
@itchat.msg_register
def simple_reply(msg):
    if msg['Type'] == 'Text':
        return 'I received: %s' % msg['Content']
itchat.run()

3、register

注册消息方法

itchat将根据接收到的消息类型寻找对应的已经注册的方法。
如果一个消息类型没有对应的注册方法,该消息将会被舍弃。
在运行过程中也可以动态注册方法,注册方式与结果不同

注册

你可以通过两种方式注册消息方法

import itchat
from itchat.content import *

#不带参数注册,所有消息类型都将调用该方法(包括群消息)
@itchat.msg_register
def simple_reply(msg):
    if msg['Type'] == 'Text':
        return 'I received: %s' % msg['Text']

#带参数注册,该类消息类型将调用该方法
@itchat.msg_register([TEXT, MAP, CARD, NOTE, SHARING])
def text_reply(msg):
    itchat.send('%s: %s' % (msg['Type'], msg['Text']), msg['FromUserName'])

消息类型:在这里在叙述一遍,感觉我们处理微信消息的时候麻烦一点的应该也就是分类型回复了

向注册方法传入的msg包含微信返回的字典的所有内容。

本api增加Text、Type(也就是参数)键值,方便操作。

itchat.content中包含所有的消息类型参数,内容如下表所示:

参数 类型 Text键值
TEXT 文本 文本内容
MAP 地图 位置文本
CARD 名片 推荐人字典
NOTE 通知 通知文本
SHARING 分享 分享名称
PICTURE 图片/表情 下载方法
RECODING 语音 下载方法
ATTACHMENT 附件 下载方法
VIDEO 小视频 下载方法
FRIENDS 好友邀请 添加好友所需参数
Useless 无用信息 ‘UselessMsg'

比如你需要存储发送给你的附件:

@itchat.msg_register(ATTACHMENT)
def download_files(msg):
    msg['Text'](msg['FileName'])

值得注意的是,群消息增加了三个键值: isAt: 判断是否@本号 ActualNickName: 实际NickName * Content: 实际Content

可以通过本程序测试:

import itchat
from itchat.content import TEXT

@itchat.msg_register(TEXT, isGroupChat = True)
def text_reply(msg):
    print(msg['isAt']
    print(msg['ActualNickName'])
    print(msg['Content'])

itchat.auto_login()
itchat.run()

注册消息的优先级

优先级分别为:后注册消息先于先注册消息,带参数消息先于不带参数消息。

以下面的两个程序为例:

import itchat
from itchat.content import *

itchat.auto_login()

@itchat.msg_register(TEXT)
def text_reply(msg):
    return 'This is the old register'

@itchat.msg_register(TEXT)
def text_reply(msg):
    return 'This is a new one'

itchat.run()

在私聊发送文本时将会回复This is a new one。

import itchat
from itchat.content import*

itchat.auto_login()

@itchat.msg_register
def general_reply(msg):
    return 'I received a %s' % msg['Type']

@itchat.msg_register(TEXT)
def text_reply(msg):
    return 'You said to me one to one: %s' % msg['Text']

itchat.run()

仅在私聊发送文本时将会回复You said to me one to one,其余情况将会回复I received a ...。

动态注册信息

动态注册时可以选择将 itchat.run() 放入另一线程或使用 configured_reply() 方法处理消息。

两种方法分别是:

# 使用另一线程,但注意不要让程序运行终止
import thread

thread.start_new_thread(itchat.run, ())

# 使用configured_reply方法
while 1:
    itchat.configured_reply()
    # some other functions
    time.sleep(1)

以下给出一个动态注册的例子

#coding=utf8
import thread

import itchat
from itchat.content import *

replyToGroupChat = True
functionStatus = False

def change_function():
    if replyToGroupChat != functionStatus:
        if replyToGroupChat:
            @itchat.msg_register(TEXT, isGroupChat = True)
            def group_text_reply(msg):
                if u'关闭' in msg['Text']:
                    replyToGroupChat = False
                    return u'已关闭'
                elif u'开启' in msg['Text']:
                    return u'已经在运行'
                return u'输入"关闭"或者"开启"测试功能'
        else:
            @itchat.msg_register(TEXT, isGroupChat = True)
            def group_text_reply(msg):
                if u'开启' in msg['Text']:
                    replyToGroupChat = True
                    return u'重新开启成功'
        functionStatus = replyToGroupChat

thread.start_new_thread(itchat.run, ())

while 1:
    change_function()
    time.sleep(.1)

4、reply

回复

itchat提供五种回复方法,建议直接使用send方法。

send方法

  • 方法:

    send(msg='Text Message', toUserName=None)

  • 所需值:
1.msg:消息内容
2.'@fil@文件地址'将会被识别为传送文件,'@img@图片地址'将会被识别为传送图片,'@vid@视频地址'将会被识别为小视频
3.toUserName:发送对象,如果留空将会发送给自己
  • 返回值:发送成功->True, 失败->False
    import itchat
    
    itchat.aauto_login()
    itchat.send('Hello world!')
    # 请确保该程序目录下存在:gz.gif以及xlsx.xlsx
    itchat.send('@img@%s' % 'gz.gif')
    itchat.send('@fil@%s' % 'xlsx.xlsx')
    itchat.send('@vid@%s' % 'demo.mp4')

    send_msg方法

  • 方法:

    send_msg(msg='Text Message', toUserName=None)

  • 所需值:

    msg:消息内容
     toUserName:发送对象,如果留空将会发送给自己
  • 返回值:发送成功->True, 失败->False

  • 程序示例:

    import itchat
    
    itchat.auto_login()
    itchat.send_msg('Hello world')

    send_file方法

  • 方法:

    send_file(fileDir, toUserName=None)

  • 所需值:

    fileDir:文件路径(不存在该文件时将打印无此文件的提醒)
     toUserName:发送对象,如果留空将会发送给自己
  • 返回值:发送成功->True, 失败->False

  • 程序示例:

    import itchat
    
    itchat.auto_login()
    #请确保该程序目录下存在:xlsx.xlsx
    itchat.send_file('xlsx.xlsx')

    send_img方法

  • 方法:

    send_img(fileDir, toUserName=None)

  • 所需值:

    fileDir:文件路径(不存在该文件时将打印无此文件的提醒)
     toUserName:发送对象,如果留空将会发送给自己
  • 返回值:发送成功->True, 失败->False

  • 程序示例:

    import itchat
    
    itchat.auto_login()
    # 请确保该程序目录下存在:gz.gif
    itchat.send_img('gz.gif')

    send_video方法

  • 方法:

    send_video(fileDir, toUserName=None)

  • 所需值:
fileDir:文件路径(不存在该文件时将打印无此文件的提醒)
 toUserName:发送对象,如果留空将会发送给自己
  • 返回值:发送成功->True, 失败->False

需要保证发送的视频为一个实质的mp4文件

import itchat

itchat.auto_login()
#请确保该程序目录下存在:demo.mp4
itchat.send_file('demo.mp4')

5、Memmber stuff

在使用个人微信的过程当中主要有三种账号需要获取,分别为: 好友 公众号 * 群聊

itchat为这三种账号都提供了整体获取方法与搜索方法。

而群聊多出获取用户列表方法以及创建群聊、增加、删除用户的方法。

这里我们分这三种分别介绍如何使用。

好友

好友的获取方法为 get_friends ,将会返回完整的好友列表。 其中每个好友为一个字典 列表的第一项为本人的账号信息 * 传入update键为True将可以更新好友列表并返回

好友的搜索方法为 search_friends ,有四种搜索方式: 1. 仅获取自己的用户信息 2. 获取特定 UserName 的用户信息 3. 获取备注、微信号、昵称中的任何一项等于 name 键值的用户 4. 获取备注、微信号、昵称分别等于相应键值的用户

其中三、四项可以一同使用,下面是示例程序:

# 获取自己的用户信息,返回自己的属性字典
itchat.search_friends()
# 获取特定UserName的用户信息
itchat.search_friends(userName='@abcdefg1234567')
# 获取任何一项等于name键值的用户
itchat.search_friends(name='littlecodersh')
# 获取分别对应相应键值的用户
itchat.search_friends(wechatAccount='littlecodersh')
# 三、四项功能可以一同使用
itchat.search_friends(name='LittleCoder机器人', wechatAccount='littlecodersh')

公众号

公众号的获取方法为 get_mps ,将会返回完整的公众号列表。 其中每个公众号为一个字典 传入update键为True将可以更新公众号列表并返回

公众号的搜索方法为 search_mps ,有两种搜索方法: 1. 获取特定 UserName 的公众号 2. 获取名字中含有特定字符的公众号

如果两项都做了特定,将会仅返回特定 UserName 的公众号,下面是示例程序:

# 获取特定UserName的公众号,返回值为一个字典
itchat.search_mps(userName='@abcdefg1234567')
# 获取名字中含有特定字符的公众号,返回值为一个字典的列表
itcaht.search_mps(name='LittleCoder')
# 以下方法相当于仅特定了UserName
itchat.search_mps(userName='@abcdefg1234567', name='LittleCoder')

群聊

群聊的获取方法为 get_chatrooms ,将会返回完整的群聊列表。 其中每个群聊为一个字典 传入update键为True将可以更新群聊列表并返回

群聊的搜索方法为 search_chatrooms ,有两种搜索方法: 1. 获取特定UserName的群聊 2. 获取名字中含有特定字符的群聊

如果两项都做了特定,将会仅返回特定UserName的群聊,下面是示例程序:

# 获取特定UserName的群聊,返回值为一个字典
itchat.search_chatrooms(userName='@abcdefg1234567')
# 获取名字中含有特定字符的群聊,返回值为一个字典的列表
itcaht.search_chatrooms(name='LittleCoder')
# 以下方法相当于仅特定了UserName
itchat.search_chatrooms(userName='@abcdefg1234567', name='LittleCoder')

群聊用户列表的获取方法为 update_chatroom 。 群聊在首次获取中不会获取群聊的用户列表,所以需要调用该命令才能获取群聊的成员 该方法需要传入群聊的UserName,返回特定群聊的用户列表

memberList = itchat.update_chatroom('@abcdefg1234567')

创建群聊、增加、删除群聊用户的方法如下所示: 由于之前通过群聊检测是否被好友拉黑的程序,目前这三个方法都被严格限制了使用频率 删除群聊需要本账号为群管理员,否则会失败

memberList = itchat.get_friends()[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])

6、QAQ

Q: 为什么我在设定了itchat.auto_login()的enableCmdQR为True后还是没有办法在命令行显示二维码?

A: 这是由于没有安装可选的包 pillow ,可以使用右边的命令安装: pip install pillow

7、eg

def signin():
        # 查找公众号,进行签到
        user = itchat.search_mps(name='Nulll.me')
        UserName = user[0]['UserName']
        itchat.send(msg=u'3', toUserName=UserName)
        itchat.dump_login_status()
        pickleDumps('flag', localDay)  # 如果执行成功写入标致文件
        exit()


if __name__ == '__main__':
        # 如果不是在登陆状态,就循环登陆
        while not itchat.load_login_status():
                sendMail()
                itchat.auto_login(hotReload=True)
                itchat.dump_login_status()
                signin()  # 签到
                time.sleep(3600)
        signin()  # 签到

好了,大致内容就是这些了,玩得愉快

发布了8 篇原创文章 · 获赞 21 · 访问量 7万+

猜你喜欢

转载自blog.csdn.net/sinat_41895958/article/details/82942656