功能简介

将指定消息转发给一个或多个目标对象。

使用场景

• 需要把某条消息再次分发给其他对象时。

参数说明

输入参数

参数名	类型	必填	说明
消息序号	整数	是	消息在最近一次消息列表中的序号。
转发对象	字符串	是	转发目标。多人时用英文逗号分隔（如 张三,工作群）。建议与流程中已从微信读取的名称（例如上一步消息列表中的对方显示名，或相关指令输出的称呼）保持一致，避免手打遗漏或多余字符。填写内容须与在微信「选择联系人」中能唯一匹配到的名称一致（通常与备注或会话列表显示一致）；若备注或显示名首尾含空格，须原样填写。
附加消息	字符串	否	要附带发送的消息内容。
超时时间	整数	否	等待转发完成的秒数。

输出参数

参数名	类型	必填	说明
是否成功	布尔值	是	表示本指令的执行判定结果：调用过程中未抛出异常，且底层未返回明确失败值时为 True；若底层抛出异常或返回明确失败值，则判定为失败。

注意事项

• 「附加消息」是否随转发一并发送取决于当前微信客户端及运行环境；对附加内容有强依赖时，须在目标环境中先行验证。
• 消息序号基于最近一次【获取当前消息】、【获取历史消息】或【获取下一个新消息】的输出结果。
• 若消息序号来自【获取历史消息】，通常仅对获取完成后当前聊天窗口底部可见的一屏历史消息范围内的消息更稳定。
• 「是否成功」为执行层判定；是否真正转发成功以微信客户端为准。