功能简介
向指定聊天对象或当前聊天窗口发送文本消息。
使用场景
- 需要向指定会话发送文本时。
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 消息内容 | 字符串 | 是 | 要发送的文本内容。 |
| 聊天对象 | 字符串 | 否 | 目标聊天对象;留空时作用于当前聊天窗口。名称须与微信会话列表/搜索时可匹配到的文字完全一致;若显示名或备注中含空格或首尾空格,须原样填写,否则可能切换聊天对象失败。 |
| 发送后清空 | 布尔值 | 否 | 发送后是否清空输入框。 |
| @对象 | 字符串 | 否 | 需要 @ 的联系人,名称需与微信里可 @ 到的显示名一致(如昵称、备注)。不 @ 则留空。仅一人时直接填写即可;多人时用英文逗号分隔(如 张三,李四)。 |
| 精确匹配 | 布尔值 | 否 | 搜索聊天对象时是否精确匹配。 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 是否成功 | 布尔值 | 是 | 表示本指令的执行判定结果:调用过程中未抛出异常,且底层未返回明确失败值时为 True;若底层抛出异常或返回明确失败值,则判定为失败。 |
注意事项
- 「是否成功」为执行层判定;是否真正发送成功以微信客户端为准。
- 填写「聊天对象」时,若名称中含空格或首尾空格,须与微信中显示的名称原样一致;建议通过前置步骤获取联系人或会话名称后传入。
- 若名称仅单个字符,也建议先通过前置步骤获取再传入,避免搜索匹配不稳定。
