一、指令概述
该 RPA 指令用于将本地图片上传至飞书,通过飞书访问凭证完成认证,上传成功后会生成图片在飞书的唯一标识 ImageKey 及运行结果,便于后续流程(如 “发送消息” 指令中引用图片)使用。
飞书官方开发文档参考:https://open.feishu.cn/document/server-docs/im-v1/image/create
二、调用参数配置示意
参数名称 | 示例 / 默认值 | 说明 |
指令 | 上传图片 | 固定选择 “上传图片”,表示执行飞书图片上传操作。 |
飞书访问凭证 | 飞书访问凭证 | 配置飞书开放平台的访问凭证(需具备图片上传权限,可通过 “获取飞书访问凭证” 指令生成),支持变量(界面显示 “{x}” 标识)。 |
图片路径 | (如 “C:\Images\report.png”) | 输入要上传的本地图片文件路径;可点击「选择文件」按钮选取本地图片,支持变量。 |
生成的变量 - 运行结果 | 变量(自定义变量名) | 存储图片上传的执行结果(如成功状态、错误信息等,对应飞书 API 返回的完整响应),需配置为自定义变量,后续流程可调用,支持变量。 |
生成的变量 - ImageKey | ImageKey(自定义变量名) | 存储上传后图片在飞书的唯一标识(对应飞书 API 返回的image_key字段),用于后续发送图片消息等场景引用该图片,需配置为自定义变量,支持变量。 |
三、使用示例(上传报表截图场景)
场景:将本地路径为 “C:\Reports\2025Q3_sales.png” 的报表截图上传至飞书,获取 ImageKey 用于后续发送。
参数配置:
• 指令:上传图片
• 飞书访问凭证:feishuAuthToken(通过 “获取飞书访问凭证” 指令生成的变量)
• 图片路径:C:\Reports\2025Q3_sales.png(或通过「选择文件」选取)
• 运行结果:uploadResult(自定义变量,存储上传结果的完整 API 响应)
• ImageKey:salesReportImgKey(自定义变量,存储图片唯一标识image_key)
执行流程:
调用该 RPA 指令后,RPA 会通过 feishuAuthToken 完成飞书 API 认证,读取本地路径的报表截图并上传至飞书;上传完成后,将飞书 API 返回的完整响应存入 uploadResult,并提取响应中的image_key赋值给 salesReportImgKey。后续可在 “发送消息” 指令中,引用 salesReportImgKey 作为 “文件 / 图片 Key” 发送该图片。
四、返回结果说明
1. 飞书 API 标准响应示例(成功场景):
指令执行后,“运行结果” 变量(如uploadResult)会存储飞书 API 返回的完整 JSON 响应,格式如下:
{ "code": 0, "data": { "image_key": "img_v2_xxx" // 图片在飞书的唯一标识,与RPA中的ImageKey变量对应 }, "msg": "success"} |
2. 响应字段含义:
• code:状态码,0 表示上传成功,非 0 为失败(具体错误码含义可参考飞书官方开发文档)。
• msg:提示信息,success 表示上传成功,失败时会返回具体错误描述(如 “权限不足”“文件格式错误”)。
• data:核心返回数据,包含 image_key 字段 —— 即图片在飞书的唯一标识,RPA 会自动提取该字段值存入 “生成的变量 - ImageKey”(如salesReportImgKey)。
3. ImageKey 结果:
“生成的变量 - ImageKey”(如salesReportImgKey)会被直接赋值为响应中的image_key字符串(如img_v2_xxx),后续可通过该标识在飞书内定位并使用这张图片。
五、注意事项
1. 访问凭证有效性:“飞书访问凭证” 需具备图片上传权限且未过期(建议通过 “获取飞书访问凭证” 指令动态生成有效凭证),否则会因权限不足或凭证失效导致上传失败(对应 API 响应code≠0,msg会提示具体原因)。
2. 图片路径合法性:“图片路径” 需指向本地真实存在的图片文件(格式支持 PNG、JPG、JPEG 等飞书 API 兼容格式,具体可参考官方文档),否则会因 “文件不存在”“格式不支持” 报错。
3. 变量与 API 响应关联:“生成的变量 - ImageKey” 是从 API 响应的data.image_key字段提取的,需确保变量配置正确,避免因字段匹配错误导致无法获取标识。
4. 后续场景联动:上传成功后,ImageKey(即image_key)可直接用于 “发送消息” 指令的 “文件 / 图片 Key” 参数,实现 “上传图片 → 发送图片消息” 的自动化闭环,无需额外转换格式。
六、延伸应用
可结合 RPA 的 “发送消息” 指令与 “定时触发” 指令,实现定时上传 + 发送图片的自动化流程:例如每日凌晨自动读取本地生成的业务报表截图(如 “C:\DailyReports\20250930_sales.png”),调用本指令上传至飞书并获取ImageKey,再通过 “发送消息” 指令将图片发送至指定飞书群组(如 “销售数据同步群”),同时附带文本说明(如 “2025 年 9 月 30 日销售日报”),替代人工手动上传和发送操作,提升办公效率。