5. 群、好友管理

5.1 群、好友通用管理

消息免打扰

wx.MuteNotifications

参数：

参数	类型	默认值	说明
mute	bool	True	对当前聊天对象开启或关闭消息免打扰，True开启免打扰，False关闭免打扰

示例：

who = '张三'
is_mute = True   # True为开启免打扰，False为关闭免打扰

wx.ChatWith(who)   # 先将微信主窗口切换到指定群聊天页面，详见 7.1`ChatWith`方法
wx.MuteNotifications(is_mute)

返回值：无

获取当前聊天信息

wx.CurrentChat

参数：

参数	类型	默认值	说明
details	bool	False	是否获取当前聊天对象详情信息，默认为False

示例：

details = True

chat_details = wx.CurrentChat(details)

返回值(两种情况)：

• details == False -> str

  当不获取详情信息的时候，返回当前聊天页面对象的名字

• details == False -> Dict

  当获取详情信息的时候，返回值为dict，例如：{'group_member_count': 264, 'chat_type': 'group', 'chat_name': '交流群'}

5.2 群管理相关

邀请入群

wx.AddGroupMembers

参数：

参数	类型	说明
group	str	群名或者群备注名
members	list	成员列表，可以是昵称、备注名、微信号；最好是微信号或者唯一的备注名

示例：

members = [
    '好友1',
    '好友2',
    '好友3'
]
group = '交流群'
wx.AddGroupMembers(group, members)

返回值：无

修改群聊名、备注、群公告、我在本群的昵称

wx.ManageGroup

参数：

参数	类型	默认值	说明
name	str	None	修改群名称
remark	str	None	修改备注名
myname	str	None	修改我的群昵称
notice	str	None	修改群公告
quit	bool	False	是否退出群，当该项为True时，其他参数无效

示例：

remark = '工作群（不要发错）'
wx.ManageGroup(remark=remark)
# 返回值：dict
# {
#     'remark': True   # 如果未成功则为False
# }

返回值(Dict[str, bool])：

返回值为一个dict，key为设置项目的名，str格式，value为该项是否设置成功，bool格式

获取群好友列表

wx.GetGroupMembers

参数：

参数	类型	默认值	说明
add_friend_mode	bool	False	是否开启添加好友模式，默认False

示例：

who = '工作群'
wx.ChatWith(who)  # 先将微信主窗口切换到指定群聊天页面，详见 7.1`ChatWith`方法
member_list = wx.GetGroupMembers()

返回值(两种情况)：

• add_friend_mode == False -> List[str]

  当未开启添加好友模式时，返回值的list中为str格式的群成员昵称或备注名

• add_friend_mode == True -> List[GroupMemberElement]

  当开启添加好友模式时，返回值的list中为GroupMemberElement对象，可用该对象的add_friend方法来进行添加群好友的操作，详见 8.4GroupMemberElement相关说明

5.3 好友管理相关

管理好友

wx.ManageFriend

参数：

参数	类型	默认值	说明
remark	str	None	修改备注名
tags	list	None	要增加的标签列表

示例：

who = '张三'
wx.Chatwith(who)  # 先将微信主窗口切换到指定群聊天页面，详见 7.1`ChatWith`方法

remark = '同事张三'
tags = ['同事']
wx.ManageFriend(remark=remark, tags=tags)
# 返回值：bool，是否成功修改备注名或标签

返回值(bool)：

返回值为bool格式，是否修改成功