菜单

任务-创建导入任务

1. 功能说明

创建将本地文件（如 Word、TXT、Markdown、Excel 等格式）导入为飞书在线云文档的异步任务，并返回任务 ID。需配合【查询导入任务结果】指令获取最终导入结果，底层基于飞书开放平台【创建导入任务】API（https://open.feishu.cn/document/server-docs/docs/drive-v1/import_task/create）实现。


2. 配置参数


配置项必填默认值说明
飞书访问凭证是-选择已配置的飞书访问凭证，需确保对应应用已开通云文档相关权限（参考：https://open.feishu.cn/document/faq/trouble-shooting/how-to-add-permissions-to-app）。
文件 Token是-待导入文件的飞书file_token，需先通过【素材 - 上传素材】指令将本地文件上传至飞书并获取该 Token。
文件扩展名是-待导入文件的格式后缀（如docx、txt、md、xlsx），需与实际文件格式一致。
目标云文档格式是-导入后生成的飞书云文档类型，对应飞书 API 的type参数，可选值参考飞书 API 文档（如docx对应新版文档、sheet对应电子表格）。
导入后的云文档名称是-导入后在飞书云文档中显示的文件名（如项目需求文档）。
导入的文件夹 Token是-飞书云空间中用于存放导入后文档的文件夹token，需提前获取目标文件夹的唯一标识。
生成的变量 - 任务 ID是-存储导入任务的唯一标识（ticket），用于后续【查询导入任务结果】指令的入参。
返回结果是-存储任务创建请求的结果（字典类型），包含任务创建状态、错误信息等，格式参考下方 “返回结果示例”。

返回结果示例

  • 创建成功：
{
    "success": true,
    "data": {
        "ticket": "task_1234567890abcdef"
    },
    "task_id": "task_1234567890abcdef"
}
  • 创建失败：
{
    "success": false,
    "code": 1061005,
    "msg": "权限不足",
    "log_id": "log_abc123",
    "raw_response": "{\"code\":1061005,\"msg\":\"权限不足\",\"log_id\":\"log_abc123\"}"
}

3. 示例场景

将本地 Excel 文件导入为飞书电子表格：

  1. 飞书访问凭证：选择已配置的tenant_access_token；
  2. 文件 Token：填写通过【素材 - 上传素材】获取的file_token（如boxcnrHpsg1QDqXAAAyachabcef）；
  3. 文件扩展名：填写xlsx；
  4. 目标云文档格式：选择sheet；
  5. 导入后的云文档名称：填写2026年销售数据；
  6. 导入的文件夹 Token：填写目标文件夹的token（如fldcn1234567890abcdef）；
  7. 生成的变量 - 任务 ID：设置为import_task_id；
  8. 返回结果：设置为create_task_result。
  9. 执行后，import_task_id将存储任务 ID，后续需通过【查询导入任务结果】指令获取最终导入状态。


4. 注意事项

常见错误

错误类型可能原因解决方案
权限不足（API 错误码 1061005）飞书应用未开通云文档相关权限参考飞书权限配置文档，为应用添加 “云文档编辑”“导入文件” 等权限。
文件 Token 无效文件 Token 不存在、已过期，或未通过飞书上传获取重新执行【素材 - 上传素材】指令获取有效的文件 Token。
文件扩展名不匹配填写的扩展名与实际文件格式不一致核对文件实际格式，修正 “文件扩展名” 配置项（如 Excel 文件填写xlsx而非docx）。
文件夹 Token 无效目标文件夹 Token 不存在、已被删除重新获取目标飞书文件夹的有效 Token，确保文件夹未被移除。


上一个
移动云空间文档到知识库
下一个
素材-上传素材
最近修改: 2026-02-06