系统接入飞书多维表格 | Feishu Bitable Integration: Webhook Sync & API Operations

1. 将多维表格填写的数据自动同步到系统，实现数据创建

虽然可以通过轮询多维表格 API 实现同步，但如果创建数据为低频操作，不推荐使用轮询方式。

1. 系统侧创建 Webhook API，用于接收飞书回调
2. 在飞书多维表格中配置「自动化」，当用户新增记录时，触发调用该 Webhook API，实现系统数据创建。

2. 系统数据写入飞书多维表格

1. 创建自建飞书应用

前往 开发者后台 - 飞书开放平台

• 在权限管理中添加应用身份权限: 查看、评论、编辑和管理多维表格 bitable:app
• 记录 App ID 和 App Secret
• 发布

2. 获取 tenant_access_token

根据 App ID 和 App Secret 获取 tenant_access_token

• 文档参考: tenant_access_token - 服务端 API - 开发文档 - 飞书开放平台

3. 获取参数: app_token(obj_token)

如果多维表格创建在知识库下, url则是: https://xxx.feishu.cn/wiki/Aagpw88sViXHwnVe?table=tblYS3mqZRktA&view=vewf4ii4

• 可通过 API 获取 obj_token：
  • 参考: 获取知识空间节点信息 - 服务端 API - 开发文档 - 飞书开放平台
  • 参数: obj_type=wiki, token (token来自多维表格的url)
  • 返回的 obj_token 即 app_token

4. 更新记录数据

• 文档参考更新记录 - 服务端 API - 开发文档 - 飞书开放平台

• 所需参数:

  • app_token: 多维表格obj_token
  • table_id: 来自多维表格url中, 表示访问的数据表id
  • record_id: 当前记录id, 当新创建记录时调用系统的webhook API时, 会携带
  • fields: 传入需更新的字段

5. 权限

在多维表格中配置「自动化」时，... > ...More > Add Applications，确保应用有权限调用多维表格 API。