飞书多维表格接入WorkBuddy教程 API自动化任务上报指南

想要将WorkBuddy的任务执行结果自动同步到飞书多维表格，却发现数据无法连通？这通常是由于飞书多维表格的API权限未开启，或WorkBuddy侧缺少相应的应用凭证所致。无需担忧，实现自动化上报存在多种成熟的技术方案，您可以根据团队的技术偏好与场景复杂程度灵活选择。

一、通过飞书开放平台创建多维表格应用并授权API

这是最官方、最标准的对接方式，完全基于飞书开放的API体系。它能赋予WorkBuddy对目标多维表格稳定且安全的读写权限，尤其适用于需要长期、稳定进行数据同步，并对权限隔离有明确要求的业务场景。

具体实施步骤，可以按以下流程进行：

首先，请使用企业管理员账号登录飞书开放平台，进入“开发者后台”。

接着，点击“创建企业自建应用”，为应用命名，例如“WorkBuddy-数据同步助手”，并在核心能力模块中务必勾选“多维表格”。

随后，进入应用详情页的“权限管理”部分，找到“批量导入/导出权限”功能。清空输入框后，将以下最小必要权限集代码粘贴进去：{"scopes": {"tenant": ["bitable:app:readonly","bitable:table:readonly","bitable:record:read","bitable:record:write"]}}，点击确认完成添加。

权限配置完成后，返回“凭证与基础信息”页面，复制生成的App ID、App Secret以及Verification Token这三项关键凭证。

最后，打开WorkBuddy客户端，进入“集成设置”下的“飞书”配置页面，将上一步复制的三个凭证分别填入对应字段，保存设置即可完成授权。

二、在WorkBuddy内配置自动化上报流程

如果您倾向于在WorkBuddy内部一站式完成所有配置，此方法将非常便捷。它利用WorkBuddy内置的低代码流程编排功能，将任务结果数据封装为JSON格式，直接调用飞书API进行推送，无需额外部署调度服务，简化了操作链路。

具体操作指南如下：

在WorkBuddy主界面，定位左下角的“自动化”菜单，点击“新建流程”，选择“自定义HTTP请求触发”模板。

然后，在“触发条件”中，设置为“任务完成事件”，并勾选需要上报的具体任务类型，例如“客户回访完成”或“工单处理完毕”。

关键步骤：在“操作步骤”中，添加一个“调用外部API”节点。需要填写的接口地址是飞书创建多维表格记录的官方API端点：https://www.php.cn/link/127f75906618c4a0d33d9188ac6df110/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records。

请务必在请求头中添加认证信息。在Headers中新增：Authorization: Bearer {access_token}。此access_token需使用之前获取的App ID和App Secret，调用飞书的获取令牌接口来获得，并建议做好本地缓存，以避免频繁重复申请。

最后，在请求体部分，选择JSON格式，将WorkBuddy中的任务字段与飞书多维表格的列进行映射。示例格式如下：{"fields": {"任务ID": "{{task_id}}", "执行状态": "{{status}}", "完成时间": "{{finish_time}}", "负责人": "{{assignee}}"}}。

三、借助飞书多维表格Webhook反向触发WorkBudty任务上报

前两种方案属于“主动推送”模式，而本方案则是“事件驱动”的“主动拉取”模式，采用Webhook架构。当飞书多维表格中有记录被创建或更新时，会自动触发一个Webhook通知到WorkBuddy，从而驱动后续操作执行。这种方式特别适合需要双向实时联动的协同场景。

配置流程如下：

首先，进入您的目标飞书多维表格，在视图右上角点击“更多”->“设置”->“自动化”->“添加规则”。将触发条件设置为“记录创建时”或“当字段更新时”。

然后，添加一个“发送Webhook”的动作。URL需要填写WorkBuddy能够接收请求的地址，例如：http://localhost:3001/webhook/feishu-bitable（前提是已开启WorkBuddy的远程访问或Webhook监听功能）。

配置Webhook时，建议勾选“包含记录全部字段数据”，并启用签名验证，将系统生成的Signing Secret妥善保存。

接着，回到WorkBuddy客户端，在“集成设置”的“飞书多维表格”页面，粘贴上一步获取的Signing Secret，并开启“接收Webhook回调”开关。

最后，在WorkBuddy的自动化流程模块中，新建一个“Webhook接收”类型的触发器，绑定之前设置的端点地址。此后，您便可以在该流程中设计后续动作，例如解析飞书传来的字段数据、调用内部其他接口、或反过来更新多维表格中的记录，从而构建一个完整的数据协同闭环。