n8n 配置飞书多维表格读取和记录方法

向量数据库大模型云通信

n8n 是非常老牌的工作流平台,唯一的缺陷恐怕就是对于国内的软件生态支撑不足了吧。

但是,咱也是有办法解决了,今天,详细介绍如何在n8n平台上,一步一步配置 n8n 连接飞书多维表格,完成创建表格和添加记录的操作。

picture.image

整个过程分为两大步:

  1. 飞书设置:在飞书开放平台创建一个应用,获取连接 n8n 所需的凭证(App ID & App Secret),并为应用开启相应权限。

  2. n8n 设置:在 n8n 中配置飞书凭证,并搭建工作流来实现具体操作。

第一步:在飞书开放平台创建应用并获取凭证

这是最关键的一步,你需要先从飞书获取“钥匙”,n8n 才能操作你的多维表格。

  1. 登录飞书开放平台

picture.image

  1. 创建企业自建应用

  • 进入“开发者后台”,点击“创建应用”,然后选择“企业自建应用”。

  • 填写应用的名称(例如 “n8n 数据同步”)和描述,然后点击“创建”。

picture.image

  1. 获取 App ID 和 App Secret

  • 创建成功后,在应用详情页的左侧菜单中,点击 凭证与基础信息。

  • 在这里你就能看到 App ID 和 App Secret。请妥善保管这两个值,稍后在 n8n 中会立刻用到。

picture.image

  1. 开通接口权限

  • 这是决定你的应用“能做什么”的一步。

  • 在左侧菜单中,点击 权限管理。

  • 在权限搜索框中,搜索并开通以下权限。这是确保你能创建表格、读写数据所必需的:

  • bitable:app - 读写多维表格、创建多维表格、新建多维表格的字段

  • bitable:record:readonly - 查看评论和导出多维表格

  • drive:read:meta - 查看云空间(飞书文档、多维表格等)元信息 (为了能把表格创建在指定文件夹)

  • drive:list - 查看云空间中文件列表

picture.image

picture.image

  1. 发布应用
  • 在左侧菜单中,点击 版本管理与发布。

  • 点击“创建新版本”,然后按照提示填写信息并“保存”。

  • 保存后,点击“申请线上发布”。这通常需要企业管理员审核,如果是你自己,可以立即通过。应用只有在发布后,权限才会生效。

picture.image

第二步:在 n8n 中使用 HTTP Request 节点配置工作流

我们的 n8n 工作流现在至少需要两个节点:

  1. 第一个 HTTP Request 节点:用来获取飞书 API 的访问令牌 (Access Token)。

  2. 第二个 HTTP Request 节点:使用上一步获取的令牌,来执行具体操作(例如创建表格或添加记录)。

A. 获取 Access Token

所有对飞书 API 的调用,都需要一个 tenant_access_token。我们需要先用 App ID 和 App Secret 换取这个 token。

在 n8n 工作流中,添加一个 HTTP Request 节点。

  1. 给节点重命名,例如叫做 "获取飞书token",方便后续引用。

picture.image

  1. 配置节点参数:
  
 {  
 "app\_id": "YOUR\_APP\_ID",  
"app\_secret": "YOUR\_APP\_SECRET"  
}

注意: 将 YOUR_APP_ID 和 YOUR_APP_SECRET 替换成你在第一步中获取到的真实值。

picture.image

  1. 执行这个节点。如果成功,你应该能在右侧的输出中看到一个 JSON 对象,其中包含 tenant_access_token。

picture.image

B. 添加记录到多维表格

现在我们有了 token,可以执行真正的操作了。

准备工作:

  • 务必将你的飞书应用添加为该表格的“可编辑”协作者。

picture.image

picture.image

picture.image

  • 和之前一样,你需要获取目标表格的 App TokenTable ID (从表格的 URL 中获取)。

picture.image

我的飞书多维表格地址是这个:https://djacd0dmko.feishu.cn/base/QtXebEnKIazZsrsOdzSchyUxnvd?table=tblskLb9Ax5sAsBv&view=vewmAGt4DZ

对应的 App Token和TableID 分别是:

  • App Token: QtXebEnKIazZsrsOdzSchyUxnvd

  • Table ID: tblskLb9Ax5sAsBv

它们有什么规律? 这个规律非常固定,您可以把飞书多维表格的 URL 结构记下来:

https://<你的域名>.feishu.cn/base/【这里是 App Token】?table=【这里是 Table ID】&...

配置 n8n 节点:

  1. 在工作流中,添加第二个 HTTP Request 节点。

  2. 配置节点参数:

注意: 将 【你的 App Token】 和 【你的 Table ID】 替换成你准备好的真实值。

这个是我替换后的真实值:

https://open.feishu.cn/open-apis/bitable/v1/apps/QtXebEnKIazZsrsOdzSchyUxnvd/tables/tblskLb9Ax5sAsBv/records

picture.image

  • Send Headers: true

  • Header Details: 点击 "Add Header",添加一个认证头。

  • Name: Authorization

  • Value: Bearer (注意 Bearer 后面有一个空格)。然后点击右侧的 "Add Expression" 按钮,选择 Nodes -> Get Feishu Token -> OutputData -> JSON -> tenant_access_token。最终的值看起来像这样:

Bearer {{ $('获取飞书token').item.json.tenant_access_token }}

这个表达式会自动从上一个节点的输出中提取 token。

picture.image

  • Send Body: true

  • Body Content Type: JSON

  • Body:

  
{  
"fields": {  
"业务问题": "要写入的值1",  
 "SQL答案": "要写入的值2",  
"SQL 查数结果": "要写入的值3"  
}  
}

picture.image

重要:

"你要写入的列名1" 必须和你的多维表格中的字段名(列名)完全一致*。

  • 值的类型要匹配,文本就用引号,数字就直接写。
  1. 现在,执行这个节点。如果一切配置正确,新的记录就会被添加到你的飞书多维表格中。

picture.image

picture.image

总结与注意要点
  • 权限是关键:确保飞书应用有足够的权限,并且已经发布。

  • 添加协作者:向已有表格写数据时,别忘了把你的飞书应用添加为表格的“可编辑”应用。

  • ID 和 Token 要分清:

  • App ID / Secret:是应用的身份凭证。

  • Folder Token:是文件夹的地址。

  • App Token:是整个多维表格文件(Base)的地址。

  • Table ID:是 Base 中具体某个工作表(Table)的地址。

  • 字段名匹配:添加记录时,n8n 里的 Key 必须和表格里的列名(字段名)一字不差。

按照以上步骤操作,你就可以成功在 n8n 中玩转飞书多维表格了。

如果遇到问题,请优先检查权限和各个 Token/ID 是否填写正确。

也可以到飞书开放平台的 API 调试台上调整通过后,再 配置到n8n平台上。

调试台地址:

https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-record/create

好的,以上就是今天的介绍内容了。关于n8n,还有其他想了解的内容,欢迎大家评论区留言。

0
0
0
0
关于作者
关于作者

文章

0

获赞

0

收藏

0

相关资源
云原生机器学习系统落地和实践
机器学习在字节跳动有着丰富业务场景:推广搜、CV/NLP/Speech 等。业务规模的不断增大对机器学习系统从用户体验、训练效率、编排调度、资源利用等方面也提出了新的挑战,而 Kubernetes 云原生理念的提出正是为了应对这些挑战。本次分享将主要介绍字节跳动机器学习系统云原生化的落地和实践。
相关产品
评论
未登录
看完啦,登录分享一下感受吧~
暂无评论