功能简介
向指定群聊或当前聊天窗口发送 @所有人 消息。
使用场景
- 需要在群聊中通知所有成员时。
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 消息内容 | 字符串 | 是 | 要发送的消息内容。 |
| 聊天对象 | 字符串 | 否 | 目标群聊名称;留空时作用于当前聊天窗口。名称须与微信会话列表/搜索时可匹配到的文字完全一致;若群名称中含空格或首尾空格,须原样填写,否则可能搜不到或切换失败。 |
| 精确匹配 | 布尔值 | 否 | 搜索聊天对象时是否精确匹配。 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 是否成功 | 布尔值 | 是 | 表示本指令的执行判定结果:调用过程中未抛出异常,且底层未返回明确失败值时为 True;若底层抛出异常或返回明确失败值,则判定为失败。 |
注意事项
- 群聊中「@所有人」受微信权限与会话类型限制:通常为群主或群管理员;无相应权限、目标非群聊或当前客户端规则不允许时,操作可能失败。
- 「是否成功」为执行层判定;是否真正发送成功以微信客户端为准。
- 填写「聊天对象」(群聊名称)时,若名称中含空格或首尾空格,须与微信中显示的名称原样一致;建议通过前置步骤获取群聊名称后传入。群名仅单个字符时,也建议先获取再传入,避免搜索匹配不稳定。
