功能简介

轮询或获取下一个有待处理新消息的会话，并返回会话标识及该批消息内容（已序列化为字典列表）。

使用场景

• 客服或群消息监控，按队列处理新会话
• 需要区分聊天类型与备注名时

参数说明

输入参数

参数名	类型	必填	说明
过滤免打扰	布尔值	否	是否忽略免打扰会话，默认 False
保留系统消息	布尔值	否	默认 True；为 False 时在本批消息中去掉「属性」为 system 的条
保留自己消息	布尔值	否	默认 True；为 False 时去掉 self
保留对方消息	布尔值	否	默认 True；为 False 时去掉 friend、other

输出参数

参数名	类型	必填	说明
新消息结果	字典	是	无新消息时为 {}；有消息时字段含义见下文「新消息结果（字典）字段说明」

新消息结果（字典）字段说明

有下一条新消息时，新消息结果 为字典，各字段含义如下。

字段名	类型	说明
聊天名称	字符串	产生新消息的会话名称
聊天类型	字符串	会话种类，如好友、群聊等，具体取值以实际结果为准
备注名	字符串	存在群备注等场景时可能有值；无备注时可能为空字符串
消息列表	列表	该批新消息列表；元素为单条消息字典，结构见下文「消息列表（单条）字段说明」

无新消息时，输出为空字典 {}，上述键均不存在。

消息列表（单条）字段说明

消息列表 中每条元素与【获取当前消息】【获取历史消息】的规则一致，单条消息各字段含义如下。

字段名	类型	说明
序号	整数	本批消息内从 0 起
发送者	字符串	该条消息的发送者显示名
内容	字符串	消息正文或系统提示等可见文本
类型	字符串	消息内容类型，常见取值见下表「消息内容类型常见取值」
属性	字符串	消息来源类型（己方/对方/系统等），常见取值见下表「消息来源类型常见取值」
发送者群昵称	字符串	仅部分群消息存在：发送人在本群设置的昵称；无此信息时字典中不包含该键
其余扩展字段	视类型而定	与【获取全部消息】一致

有新消息时对本批消息按「属性」筛选后再写入「消息_序号」缓存，与 消息列表 序号一致；若全部筛掉则列表为空，但仍可能保留聊天名称等外层字段。

消息内容类型常见取值

取值	含义
time	时间分隔（时间轴提示）
text	文本
quote	引用
voice	语音
image	图片
video	视频
file	文件
location	位置
link	链接
emotion	表情
merge	合并转发
personal_card	个人名片
note	笔记
other	其他或未细分类型

消息来源类型常见取值

取值	含义
system	系统侧（如时间、系统提示等）
self	当前账号自己发送
friend	对方/群友发送
other	其他

注意事项

• 需要先运行【初始化微信】指令。
• 指令执行前会尝试切回微信主窗口的「聊天」视图，以提高在旧版本或界面异常时的稳定性。
• 若出现「事件无法调用任何订户」等自动化相关报错，多与当前不在聊天视图、窗口被最小化，或办公类软件插件干扰有关。请保持微信窗口可见、处于聊天界面，必要时关闭可能冲突的插件后重试。
• 若你的业务是持续收消息，优先使用【添加监听聊天】→【开始监听】→【获取监听到的消息】的监听模式，通常比【获取下一个新消息】更稳定。
• 若微信版本或界面更新，个别字段取值可能与上表略有差异，以实际运行得到的结果为准。