企业官网建设流程全解析

ItChat群管理进阶：批量建群、拉人入群与踢人删人的自动化技巧

【免费下载链接】ItChatA complete and graceful API for Wechat. 微信个人号接口、微信机器人及命令行微信，三十行即可自定义个人号机器人。项目地址: https://gitcode.com/gh_mirrors/it/ItChat

ItChat 是一个开源的微信个人号接口，让你用 Python 快速实现微信机器人和群聊自动化。本文介绍 ItChat 群管理的四大核心能力：批量建群、拉人入群、踢人删人，以及配套的改名与成员列表更新操作，帮你用不到三十行代码完成一套完整的微信群自动化流程。

一、4 个核心群管理 API 速览 🗂️

ItChat 把群聊操作封装成了直观的实例方法，实现代码都集中在 itchat/components/contact.py 中：

方法签名与参数说明可在 docs/api.md 中查到，入门示例见 docs/intro/contact.md。

二、批量建群：create_chatroom 一步到位

想批量建群？只需传入成员信息字典列表和群名：

import itchat itchat.auto_login(True) # 好友列表第一位是自己，去掉自己后作为初始成员 memberList = itchat.get_friends()[1:5] chatroomUserName = itchat.create_chatroom(memberList, '项目协作群')

💡 两个要点：

• 创建群聊的调用频率被微信严格限制，批量建群时建议间隔调用，避免触发风控；
• 群聊如果不保存到通讯录，无法在设备间同步，ItChat 也读取不到它——所以批量建群后最好手动保存一次。

三、拉人入群：直接拉人 vs 发送邀请 🚪

add_member_into_chatroom支持两种入群方式：

• 直接拉入（useInvitation=False）：成员直接进群，无确认步骤；
• 发送邀请（useInvitation=True）：成员收到邀请卡片，需确认后才入群。

# 把某位好友直接拉进群 itchat.add_member_into_chatroom(chatroomUserName, [friend])

⚠️ 关键规则（源码中已自动处理）：

1. 群人数超过 40 人时，微信只允许使用邀请方式，ItChat 会自动强制切换为邀请模式，你无需判断；
2. 不能把自己或已在群内的成员加入群，否则整批操作不会生效；
3. 同样存在频率限制，批量拉人请控制节奏。

方法实现见 itchat/components/contact.py#L466-L492，其中可以看到自动判断群人数并切换邀请逻辑。

四、踢人删人：delete_member_from_chatroom 的权限要点 🧹

批量移出群成员的写法非常直接：

# 注意 memberList 必须传入“列表”，即使只踢一个人 itchat.delete_member_from_chatroom(chatroomUserName, [memberA, memberB])

使用前的三个权限要点：

方法实现位于 itchat/components/contact.py#L453-L464。

五、配套操作：改群名 + 刷新成员列表 ✍️

1. 修改群名——set_chatroom_name支持随时更新群名称，方便批量建群后统一命名：

itchat.set_chatroom_name(chatroomUserName, '2026届同学会')

2. 刷新成员列表—— 群聊首次获取时不带成员列表，操作成员前必须先调用update_chatroom更新：

chatroom = itchat.update_chatroom(chatroomUserName, detailedMember=True) memberList = chatroom['MemberList'] # 群内所有成员

detailedMember=True会连带头像、昵称等详细信息一起拉取，源码逻辑见 itchat/components/contact.py#L28-L76。群聊搜索可用search_chatrooms按名字或UserName定位目标群，示例见 docs/intro/contact.md#L85-L98。

六、自动化实战：串起一条完整的群管理流程 🤖

把上面的方法组合起来，就是一个可复用的"自动建群机器人"流程：

1. 搜好友：search_friends(name='...')找到目标成员；
2. 建群：create_chatroom(memberList, '群名')；
3. 改名：set_chatroom_name(...)统一规范群名；
4. 补人：add_member_into_chatroom(...)追加遗漏成员；
5. 清退：delete_member_from_chatroom(...)移出无关人员。

每一步之间加time.sleep()控制节奏即可。更多进阶玩法（如利用入群返回的状态值检测好友是否删除了你）可以参考 docs/tutorial/tutorial2.md#L209-L226。

七、避坑清单 ✅

• 🔒频率限制：建群、拉人、踢人三个操作均被微信严格限频，自动化脚本务必加入延时；
• 📌保存通讯录：不保存的群聊无法跨设备同步，ItChat 也读不到；
• 🔄先更新再操作：对成员列表做任何处理前，先update_chatroom拿到最新数据；
• 🔥热重启：长时间运行的脚本建议auto_login(hotReload=True)，掉线后可免扫码恢复。

掌握这组群管理 API，ItChat 的微信自动化能力就完整了——更多方法签名与参数说明，欢迎查阅 docs/api.md 和 README.md。

【免费下载链接】ItChatA complete and graceful API for Wechat. 微信个人号接口、微信机器人及命令行微信，三十行即可自定义个人号机器人。项目地址: https://gitcode.com/gh_mirrors/it/ItChat