导入文件为云文档

​

1. 功能说明

将本地的 Word、TXT、Markdown（含.md/.mark/.markdown）或 HTML 文件，一键导入为飞书在线云文档。该指令内部封装了 “上传文件至飞书素材库→创建导入任务” 的完整流程，是【任务 - 创建导入任务】的简化版，同样为异步任务，需配合【任务 - 查询导入任务结果】获取最终导入状态。

​

2. 配置项说明

配置项必填说明飞书访问凭证是选择已配置的飞书访问凭证，需确保对应应用已开通云文档 “导入” 和 “上传” 相关权限。文件路径是填写本地待导入文件的完整路径（如 C:\docs\项目需求.docx），或点击「选择文件」按钮直接选取文件。支持格式：.docx/.doc/.txt/.md/.mark/.markdown/.html。上传位置 Token是飞书云空间中目标文件夹的 token，导入后的云文档将存放在此文件夹下。任务 ID是存储内部生成的导入任务唯一标识（ticket），用于后续【查询导入任务结果】的入参。 该指令是对飞书两个核心 API 的封装：上传素材 API：将本地文件上传至飞书素材库，获取 file_token。创建导入任务 API：使用 file_token 创建异步导入任务，返回 task_id。指令会自动完成上述两步，无需手动拆分操作。 指令执行后，主要通过生成的变量返回关键信息：任务 ID：存储导入任务的唯一标识（如 task_1234567890abcdef），用于后续查询任务结果。

​

3. 示例场景

将本地 Markdown 文档导入飞书云文档：飞书访问凭证：选择已配置的凭证。文件路径：填写 C:\notes\产品说明.md（或点击「选择文件」选取该文件）。上传位置 Token：填写目标文件夹的 token（如 fldcn1234567890abcdef）。任务 ID：设置为 import_task_id。执行指令后，import_task_id 存储任务 ID，后续通过【查询导入任务结果】获取最终状态。

​

4. 注意事项

常见问题错误类型可能原因解决方案文件不存在或无权限填写的文件路径错误，或 RPA 机器人无文件读取权限核对文件路径准确性，确保机器人对目标文件有读权限。文件格式不支持上传的文件不在支持的格式列表中仅上传 Word、TXT、Markdown、HTML 格式的文件。上传位置 Token 无效目标文件夹 token 不存在或已被删除重新获取目标文件夹的有效 token。权限不足飞书应用未开通云文档上传 / 导入权限参考飞书权限配置文档，为应用添加对应权限。网络异常网络波动导致文件上传或任务创建失败检查网络连接，并重试指令。