金数据 X 飞书多维表格

介绍如何通过 Webhook 和 HTTP 请求,在金数据表单与飞书多维表格之间推送数据。

通过 Webhook 和 HTTP 请求,可以在金数据表单与飞书多维表格之间推送数据。本文分别介绍两个方向的配置方法。

通过金数据收集到的数据,怎么推送到飞书多维表格?

第一步:在飞书多维表格中获取 Webhook 地址

  1. 打开需要接收数据的飞书多维表格,点击右上角「自动化」。

    PC|飞书多维表格|数据表页面右上角的「自动化」入口被红框标注

  2. 在自动化中心点击「创建自定义流程」。

    PC|飞书多维表格自动化中心|推荐流程中的「创建自定义流程」卡片被红框标注

  3. 在触发条件中选择「接收到 Webhook 时」。

    PC|飞书多维表格自动化流程|触发条件列表中的「接收到 Webhook 时」被红框标注

  4. 系统会生成一个 Webhook 地址。点击「复制」并妥善保存该地址,后续在金数据中配置 Webhook 推送时需要使用。在右侧「执行操作」区域选择「新增记录」,并选择需要写入数据的多维表格。

    PC|飞书多维表格自动化流程|「接收到 Webhook 时」触发条件中生成 Webhook 地址,「复制」按钮被红框标注

第二步:在金数据表单中配置 Webhook

  1. 打开需要推送数据的金数据表单,进入「设置」→「提醒推送」,点击「新建提醒推送」。

    PC|金数据表单设置|顶部「设置」、左侧「提醒推送」和「新建提醒推送」按钮被红框标注

  2. 在「新建提醒推送」中,将触发条件设置为「有数据新增」,执行操作设置为「发 Webhook」。在「Webhook 地址」中粘贴第一步复制的地址,然后点击「保存并启用」。

    PC|金数据提醒推送|触发条件「有数据新增」、执行操作「发 Webhook」和 Webhook 地址输入框被红框标注,底部显示「保存并启用」按钮

第三步:发送测试数据并匹配字段

  1. 回到飞书多维表格的自动化流程页面,确认左侧显示「正在监听请求」。请保持该页面打开。

    PC|飞书多维表格自动化流程|「接收到 Webhook 时」触发条件显示「正在监听请求」,「生成」按钮位于提示区域下方

  2. 打开已发布的金数据表单,提交一条完整的测试数据。姓名、手机号等需要推送到飞书多维表格的字段都要填写。

  3. 返回飞书多维表格的自动化流程页面,点击左侧的「生成」。生成请求数据后,在右侧「新增记录」中点击「设置字段值」,选择需要写入数据的字段。

    PC|飞书多维表格自动化流程|右侧「新增记录」操作展开「设置字段值」菜单,并显示姓名、幼儿园学校名称、班级、性别、手机号和微信号字段

  4. 点击每个字段输入框右侧的「+」,选择该字段对应的数据来源。

    PC|飞书多维表格自动化流程|「姓名」字段输入框右侧的「添加值」按钮和「第 1 步发送请求的返回值」入口被红框标注

  5. 选择「第 1 步发送请求的返回值」,展开 entry,再根据金数据字段的 API Code 选择对应字段。例如,幼儿园学校名称对应 field_1。

    PC|飞书多维表格自动化流程|左侧请求体显示金数据字段 API Code,右侧依次选择「第 1 步发送请求的返回值」、entry 和 field_1

  6. 按照相同方法完成所有字段的匹配,确认每个飞书多维表格字段都对应正确的金数据字段,然后点击「保存并启用」。

    PC|飞书多维表格自动化流程|幼儿园学校名称、班级、姓名、手机号、微信号和性别均已匹配对应的 entry 字段,右下角「保存并启用」按钮被红框标注

也可以手动设置 JSON

在飞书自动化流程的「输出设置」中,也可以选择「手动设置」。在「示例请求体(Request body)」中输入与金数据 Webhook 推送数据一致的 JSON,具体格式可参考Webhook 数据格式。设置完成后,在右侧「新增记录」中点击「设置字段值」,选择需要写入数据的字段,并按照前文方法完成字段匹配。

PC|飞书多维表格自动化流程|输出设置选择「手动设置」,示例请求体填写 JSON,右侧新增记录已匹配对应字段

如果输入内容不符合 JSON 格式,页面会提示「出参内容不符合 JSON 格式」。请检查括号、引号、逗号等符号是否完整且符合 JSON 语法。

PC|飞书多维表格自动化流程|手动设置的示例请求体格式错误,页面提示「出参内容不符合 JSON 格式」

  1. 返回自动化中心的「管理」页面,确认自动化流程处于启用状态,然后点击「运行日志」。

    PC|飞书多维表格自动化中心|管理页面显示自动化流程已启用,右上角「运行日志」按钮和流程开关被红框标注

  2. 在运行日志中查看最新记录。显示「运行成功」表示数据已经正常推送到飞书多维表格。

    PC|飞书多维表格运行日志|多条自动化流程记录的运行状态均显示「运行成功」

飞书特殊字段无法选择怎么办?

飞书多维表格中的部分特殊字段不会显示在自动化选择器中,因此无法直接匹配和推送。例如,字段类型为「电话号码」的手机号字段可能显示为「已隐藏不支持的内容」。

PC|飞书多维表格自动化流程|手机号字段的数据来源选择器提示「已隐藏不支持的内容」,无法选择对应返回值

处理方法:

  1. 返回飞书多维表格,点击无法推送的字段名称右侧菜单,选择「修改字段/列」。

    PC|飞书多维表格|手机号字段的列菜单展开,「修改字段/列」被红框标注

  2. 将字段类型从「电话号码」修改为「文本」(单行文字),然后点击「确定」。修改后返回自动化流程,重新生成请求数据并匹配该字段。

    PC|飞书多维表格|手机号字段的修改面板展开字段类型菜单,「电话号码」和「文本」被红框标注

在金数据表单后台查看推送日志

完成配置后,你也可以在金数据表单后台进入「设置」→「提醒推送」,在「发送日志」中查看 Webhook 的推送状态。状态显示「成功」表示该次推送已成功发送。

PC|金数据提醒推送|「发送日志」区域列出多条 Webhook 推送记录,状态栏均显示「成功」

通过飞书多维表格收集到的数据,怎么推送到金数据?

可以在飞书多维表格中创建自动化流程,在新增记录时发送 HTTP 请求,将数据写入金数据表单。

第一步:在飞书多维表格中创建自动化流程

  1. 打开需要推送数据的飞书多维表格,点击右上角「自动化」。

    PC|飞书多维表格|数据表页面右上角的「自动化」入口被红框标注

  2. 在自动化中心点击「创建自定义流程」。

    PC|飞书多维表格自动化中心|推荐流程中的「创建自定义流程」卡片被红框标注

  3. 将触发条件设置为「添加新记录时」,选择需要推送数据的表单。根据推送要求,在「且已选字段不为空时」选择必须填写的字段。

    PC|飞书多维表格自动化流程|触发条件选择「添加新记录时」,并在「且已选字段不为空时」选择需要有值的字段

  4. 在右侧「执行操作」区域选择「发送 HTTP 请求」。

    PC|飞书多维表格自动化流程|右侧执行操作列表中的「发送 HTTP 请求」被红框标注

接下来,需要获取对应金数据表单的请求地址(URL)、请求头(Headers)、请求体(Request body)和响应体(Response body),用于配置飞书的 HTTP 请求。

第二步:获取并填写金数据 API 请求参数

  1. 打开新增单条数据 API 文档,根据文档确认目标表单的请求地址、请求头、请求体和响应体。

  2. 进入金数据 API 设置,创建 Access Token。创建后请立即复制并妥善保存,关闭页面后将无法再次查看。

    注意:Access Token 相当于账户访问凭证,请勿发送给 AI 软件、他人或写入公开文档和截图。

  3. 返回飞书多维表格的自动化流程,在「发送 HTTP 请求」中按照开放平台文档填写以下内容:

    • 请求方法:选择 POST。
    • 请求地址(URL):填写 https://jinshuju.net/api/v1/forms/FORM_TOKEN/entries,并将 FORM_TOKEN 替换为目标表单的 Token。
    • 请求头(Headers):添加 Content-Type: application/json、Accept: application/json 和 Authorization: Bearer YOUR_ACCESS_TOKEN,并将 YOUR_ACCESS_TOKEN 替换为已创建的 Access Token。
    • 请求体(Request body):选择「Raw 格式(JSON)」,以金数据字段的 API Code 作为键,通过输入框右侧的「+」选择对应的飞书多维表格字段作为值。
    • 响应体(Response body):选择「Raw 格式(JSON)」,参考开放平台文档中的 Response 示例填写。

    PC|飞书多维表格自动化流程|发送 HTTP 请求的请求体和响应体均选择「Raw 格式(JSON)」,输入框中显示空 JSON

  4. 检查请求体中的每个金数据字段 API Code 是否与飞书多维表格字段正确对应,并确认请求体和响应体均为有效的 JSON 格式。填写完成后,点击「保存并启用」。

    PC|飞书多维表格自动化流程|请求体中的金数据字段 API Code 已匹配飞书多维表格字段,响应体填写了接口返回示例

如果你不熟悉 API 配置,可以将金数据开放平台文档链接、已创建表单的公开填写链接和字段说明发送给 AI 软件,请其协助生成配置内容。请勿提供 Access Token、登录凭证或表单中的真实敏感数据。

保存并启用自动化流程后,当飞书多维表格中新增符合触发条件的记录时,系统会向金数据发送 HTTP 请求并新增一条表单数据。

第三步:启用自动化并查看运行日志

  1. 自动化流程创建完成后,返回自动化中心的「管理」页面,开启流程右侧的开关,然后点击「运行日志」。

    PC|飞书多维表格自动化中心|管理页面中的自动化流程开关和「运行日志」按钮被红框标注

  2. 在运行日志中查看流程当前的运行状态。点击对应记录右侧的「详情」,可以查看该次运行的详细情况。

    PC|飞书多维表格运行日志|日志列表显示多条运行成功记录,每条记录右侧均有「详情」入口

  3. 进入详情后,可以查看「添加新记录时」和「发送 HTTP 请求」等步骤的执行状态。

    PC|飞书多维表格运行日志详情|右侧详情面板显示「添加新记录时」和「发送 HTTP 请求」均执行成功

  4. 展开「发送 HTTP 请求」,可以按需查看「流程设置」「运行结果」和「报错」,了解请求配置、返回结果或失败原因。

    PC|飞书多维表格运行日志详情|发送 HTTP 请求步骤展开,显示「流程设置」「运行结果」和「报错」三个查看入口

资费介绍

两种数据推送方式的资费介绍如下:

免费版专业版专业增强版企业基础版企业协作版企业高级版
价格免费599 元/年2,399 元/年、299 元/月4,399 元/年7,399 元/年23,999 元/年
自动化推送 Webhook 数据记录❌✅✅✅✅✅
v1 API 新增单条数据✅✅✅✅✅✅

本页内容