打开聊天窗口
功能简介
切换到指定聊天对象的主窗口会话。
使用场景
- 需要在读取消息或发送消息前切换到目标会话时。
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 聊天对象 | 字符串 | 是 | 要打开的聊天对象名称。名称须与微信会话列表/搜索时可匹配到的文字完全一致；若显示名或备注中含空格或首尾空格，须原样填写，否则可能搜不到或切换失败。 |
| 精确匹配 | 布尔值 | 否 | 搜索时是否按名称精确匹配。 |
输出参数
无
注意事项
警告
- 如果聊天对象不存在或未命中，会直接抛出异常。
- 若名称中含空格或首尾空格，须与微信中显示的名称原样一致；建议通过前置步骤（如获取会话列表）取得名称后传入。名称仅单个字符时，也建议先获取再传入，避免搜索匹配不稳定。