功能简介

为指定聊天对象注册消息监听；新产生的消息摘要写入当前流程的监听记录，供【读取监听消息】等指令使用。

使用场景

• 需要为指定会话建立监听时。

参数说明

输入参数

参数名	类型	必填	说明
聊天对象	字符串	是	要监听的聊天对象名称。名称须与微信会话列表/搜索时可匹配到的文字完全一致；若显示名或备注中含空格或首尾空格，须原样填写，否则可能注册监听失败。

输出参数

参数名	类型	必填	说明
是否成功	布尔值	是	注册监听成功时返回 True。

注意事项

1. 填写「聊天对象」时，若名称中含空格或首尾空格，须与微信中显示的名称原样一致；建议通过前置步骤获取会话名称后传入。名称仅单个字符时，也建议先获取再传入，避免搜索匹配不稳定。
2. 监听记录最多保留 200 条；超出时将丢弃较早的记录。