n8n 是非常老牌的工作流平台,唯一的缺陷恐怕就是对于国内的软件生态支撑不足了吧。
但是,咱也是有办法解决了,今天,详细介绍如何在n8n平台上,一步一步配置 n8n 连接飞书多维表格,完成创建表格和添加记录的操作。
整个过程分为两大步:
-
飞书设置:在飞书开放平台创建一个应用,获取连接 n8n 所需的凭证(App ID & App Secret),并为应用开启相应权限。
-
n8n 设置:在 n8n 中配置飞书凭证,并搭建工作流来实现具体操作。
这是最关键的一步,你需要先从飞书获取“钥匙”,n8n 才能操作你的多维表格。
- 登录飞书开放平台
-
访问 飞书开放平台 (https://open.feishu.cn/)。
-
使用你的飞书账号登录。
- 创建企业自建应用
-
进入“开发者后台”,点击“创建应用”,然后选择“企业自建应用”。
-
填写应用的名称(例如 “n8n 数据同步”)和描述,然后点击“创建”。
- 获取 App ID 和 App Secret
-
创建成功后,在应用详情页的左侧菜单中,点击 凭证与基础信息。
-
在这里你就能看到 App ID 和 App Secret。请妥善保管这两个值,稍后在 n8n 中会立刻用到。
- 开通接口权限
-
这是决定你的应用“能做什么”的一步。
-
在左侧菜单中,点击 权限管理。
-
在权限搜索框中,搜索并开通以下权限。这是确保你能创建表格、读写数据所必需的:
-
bitable:app - 读写多维表格、创建多维表格、新建多维表格的字段
-
bitable:record:readonly - 查看评论和导出多维表格
-
drive:read:meta - 查看云空间(飞书文档、多维表格等)元信息 (为了能把表格创建在指定文件夹)
-
drive:list - 查看云空间中文件列表
- 发布应用
-
在左侧菜单中,点击 版本管理与发布。
-
点击“创建新版本”,然后按照提示填写信息并“保存”。
-
保存后,点击“申请线上发布”。这通常需要企业管理员审核,如果是你自己,可以立即通过。应用只有在发布后,权限才会生效。
我们的 n8n 工作流现在至少需要两个节点:
-
第一个
HTTP Request
节点:用来获取飞书 API 的访问令牌 (Access Token)。 -
第二个
HTTP Request
节点:使用上一步获取的令牌,来执行具体操作(例如创建表格或添加记录)。
A. 获取 Access Token
所有对飞书 API 的调用,都需要一个 tenant_access_token。我们需要先用 App ID 和 App Secret 换取这个 token。
在 n8n 工作流中,添加一个 HTTP Request 节点。
- 给节点重命名,例如叫做 "获取飞书token",方便后续引用。
- 配置节点参数:
-
Method: POST
-
URL: https://open.feishu.cn/open-apis/auth/v3/tenant\_access\_token/internal/
-
Send Body: true
-
Body Content Type: JSON
-
Body:
{
"app\_id": "YOUR\_APP\_ID",
"app\_secret": "YOUR\_APP\_SECRET"
}
注意: 将 YOUR_APP_ID 和 YOUR_APP_SECRET 替换成你在第一步中获取到的真实值。
- 执行这个节点。如果成功,你应该能在右侧的输出中看到一个 JSON 对象,其中包含 tenant_access_token。
B. 添加记录到多维表格
现在我们有了 token,可以执行真正的操作了。
准备工作:
- 务必将你的飞书应用添加为该表格的“可编辑”协作者。
- 和之前一样,你需要获取目标表格的
App Token
和Table ID
(从表格的 URL 中获取)。
我的飞书多维表格地址是这个: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 节点:
-
在工作流中,添加第二个 HTTP Request 节点。
-
配置节点参数:
-
Method: POST
-
URL: https://open.feishu.cn/open-apis/bitable/v1/apps/【你的 App Token】/tables/【你的 Table ID】/records
注意: 将 【你的 App Token】 和 【你的 Table ID】 替换成你准备好的真实值。
这个是我替换后的真实值:
-
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。
-
Send Body: true
-
Body Content Type: JSON
-
Body:
{
"fields": {
"业务问题": "要写入的值1",
"SQL答案": "要写入的值2",
"SQL 查数结果": "要写入的值3"
}
}
重要:
"你要写入的列名1"
必须和你的多维表格中的字段名(列名)完全一致*。
- 值的类型要匹配,文本就用引号,数字就直接写。
- 现在,执行这个节点。如果一切配置正确,新的记录就会被添加到你的飞书多维表格中。
-
权限是关键:确保飞书应用有足够的权限,并且已经发布。
-
添加协作者:向已有表格写数据时,别忘了把你的飞书应用添加为表格的“可编辑”应用。
-
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,还有其他想了解的内容,欢迎大家评论区留言。