功能简介

切换到指定聊天对象的主窗口会话。

使用场景

• 需要在读取消息或发送消息前切换到目标会话时。

参数说明

输入参数

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

输出参数

无

注意事项

• 如果聊天对象不存在或未命中，会直接抛出异常。
• 若名称中含空格或首尾空格，须与微信中显示的名称原样一致；建议通过前置步骤（如获取会话列表）取得名称后传入。名称仅单个字符时，也建议先获取再传入，避免搜索匹配不稳定。