一、指令概述
该 RPA 指令用于通过飞书开放平台 API 向指定接收者发送消息（支持文本、图片、文件三种类型），需配置飞书访问凭证、接收者标识及消息相关参数，执行后返回运行结果，适用于飞书消息的自动化触达（如告警通知、报表推送等场景）。
飞书官方开发文档参考：https://open.feishu.cn/document/server-docs/im-v1/message/create
二、调用参数配置示意
| 参数名称 | 示例 / 默认值 | 说明 |
| 指令 | 发送消息 | 固定选择 “发送消息”，表示执行飞书消息发送操作。 |
| 飞书访问凭证 | 飞书访问凭证 | 使用获取飞书访问凭证指令生成 |
| 接收者 Id 类型 | open_id / union_id / user_id / email / chat_id | 选择接收者标识的类型，下拉可选：- open_id：飞书内用户 / 群组的开放标识；- union_id：多租户场景下用户的唯一标识；- user_id：飞书用户 ID；- email：用户邮箱；- chat_id：飞书群组 ID。 |
| 接收者 Id | ou_xxx / user123 / group@example.com / oc_xxx | 根据 “接收者 Id 类型”，输入对应的接收者标识（如open_id对应的ou_xxx字符串），支持变量。 |
| 消息类型 | 文本 / 图片 / 文件 | 选择要发送的消息类型，下拉可选：- 文本：发送纯文本消息；- 图片：发送图片消息（需配置 “文件 / 图片 Key”）；- 文件：发送文件消息（需配置 “文件 / 图片 Key”）。 |
| 文件 / 图片 Key | ImageKey / FileKey | 根据 “消息类型” 配置：- 若为图片：输入飞书存储图片的 Key（需提前上传图片获取 Key）；- 若为文件：输入飞书存储文件的 Key（需提前上传文件获取 Key）；- 若为文本：无需配置该字段。支持变量。 |
| 生成的变量 - 运行结果 | 发消息运行结果 | 存储消息发送的结果（如成功状态、消息 ID 等），需配置为自定义变量，后续流程可调用，支持变量。 |
三、使用示例（发送图片消息场景）
场景：通过飞书向指定用户（以open_id为ou_123abc标识）发送产品截图（图片 Key 为img_456def）。
参数配置：
• 指令：发送消息
• 飞书访问凭证：feishuAuthToken（提前配置的飞书访问凭证变量）
• 接收者 Id 类型：open_id
• 接收者 Id：ou_123abc
• 消息类型：图片
• 文件 / 图片 Key：img_456def
• 运行结果：msgSendResult（自定义变量，存储发送结果）
执行流程：
调用该 RPA 指令后，RPA 会通过飞书访问凭证认证，向open_id为ou_123abc的接收者发送图片（Key 为img_456def），并将发送结果（如成功时返回消息 ID，失败时返回错误原因）存入msgSendResult变量。
四、返回结果说明
指令执行后，“运行结果” 变量会存储飞书 API 返回的 JSON 结果（示例为成功发送图片的响应，关键参数可参考官方文档）：
| { "code": 0, "msg": "success", "data": { "message_id": "om_dc13264520392913993dd051dba21dcf", "root_id": "om_40eb06e7b84dc71c03e009ad3c754195", "parent_id": "om_d4be107c616aed9c1da8ed8068570a9f", "thread_id": "omt_d4be107c616a", "msg_type": "interactive", "create_time": "1615380573411", "update_time": "1615380573411", "deleted": false, "updated": false, "chat_id": "oc_5ad11d72b830411d72b836c20", "sender": { "id": "cli_9f427eec54ae901b", "id_type": "app_id", "sender_type": "app", "tenant_key": "736588c9260f175e" }, "body": { "content": "{\"text\":\"@_user_1 test content\"}" }, "mentions": [ { "key": "@_user_1", "id": "ou_155184d1e73cbfb8973e5a9e698e74f2", "id_type": "open_id", "name": "Tom", "tenant_key": "736588c9260f175e" } ], "upper_message_id": "om_40eb06e7b84dc71c03e009ad3c754195" }} |
• code：状态码，0表示成功，非0为失败（具体错误码含义见官方文档）。
• msg：提示信息，success表示发送成功。
五、注意事项
1. 访问凭证有效性：“飞书访问凭证” 需具备消息发送权限且未过期，否则会因权限不足导致发送失败。
2. 接收者 Id 类型与标识匹配：“接收者 Id 类型” 需与 “接收者 Id” 严格对应（如选email则 “接收者 Id” 需填有效邮箱），否则无法定位接收者。
3. 消息类型与 Key 的对应：
◦ 若 “消息类型” 为图片/文件，需确保 “文件 / 图片 Key” 是飞书已存储资源的有效 Key（可通过飞书 “上传文件 / 图片” 类指令提前获取）；
◦ 若 “消息类型” 为文本，无需配置 “文件 / 图片 Key”，否则可能报错。
1. 变量配置规范性：“飞书访问凭证”“接收者 Id”“文件 / 图片 Key”“运行结果” 需配置为合法变量（如提前定义变量名、确保数据类型匹配），否则无法正确传递 / 存储数据。
六、延伸应用
可结合 RPA 的「定时触发」「数据读取」指令，实现定时推送个性化消息（如每日向团队发送报表截图）；或结合「条件判断」指令，根据业务结果（如订单异常）触发告警消息发送，实现飞书消息与业务流程的自动化联动。