# 3Chat 访客信息同步至飞书多维表格｜WorkFlow配置教程

**URL:** <https://group.3chatai.cn/t/topic/458>\
**Category:** 开放平台\
**Tags:** 最佳实践\
**Created:** [2026 年10 月 16 日 10:29 UTC](https://group.3chatai.cn/t/topic/458 "2026-10-16T10:29:25Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![nct\_liuhaonan](https://yyz2.discourse-cdn.com/flex012/user_avatar/group.3chatai.cn/nct_liuhaonan/32/179_2.png) [@nct\_liuhaonan](https://group.3chatai.cn/u/nct_liuhaonan)\
发布日期： [2026 年10 月 16 日 10:29 UTC](https://group.3chatai.cn/t/topic/458/1 "2026-10-16T10:29:25Z")

</div>

通过导入预配置工作流，将 3Chat 后台的 **创建访客、更新访客** 事件同步到指定的飞书多维表格，实现访客信息的自动新增与更新。

**配置流程：** 导入工作流 → 填写运行配置 → 发布工作流 → 配置 Webhook → 添加飞书应用并设置表格字段 → 测试同步。

## 一、导入工作流

1. 打开 **工作流构建台** @[工作流构建台](https://app.3chatai.cn/workflow-builder/builder/runs)，点击\*\*「导入」\*\*。
2. 选择预配置文件并完成导入。
3. 打开导入后的工作流，准备填写运行配置。  
 ![image](https://canada1.discourse-cdn.com/flex012/uploads/x3chat/original/2X/e/e3e39fd16f9c1b8645c8aef2a689699a6d544650.png)

**预配置文件：**

## 二、填写运行配置

进入工作流的\*\*「运行配置」\*\*，填写以下内容：

| 配置项 | 填写内容 |
| --- | --- |
| `feishu.table_url` | 需要同步到的飞书多维表格完整链接（包含 `table=` 参数） |
| `feishu.app_id` | 飞书应用的 App ID |
| `feishu.app_secret` | 飞书应用的 App Secret |

**说明：** App ID 和 App Secret 可向管理员获取，也可通过相关文档或教程创建者获取。请妥善保管 App Secret。

工作流会从多维表格链接中自动识别目标数据表，无需另外填写 `app_token` 或 `table_id`。填写完成后保存运行配置。

 ![image](https://canada1.discourse-cdn.com/flex012/uploads/x3chat/original/2X/5/510eb166fc7d47ce8e8ce355056295694ebdea7e.png)

## 三、发布工作流

1. 在工作流构建台中 **发布工作流** 。
2. **记录发布后提供的请求地址和请求头，留作后续配置 Webhook 使用。**  
 ![image](https://canada1.discourse-cdn.com/flex012/uploads/x3chat/original/2X/0/0dacaa4df4361f0bb938ea2191b94c2455e12d5c.png)

## 四、在 3Chat 后台配置 Webhook

1. 进入 **3Chat 后台 → Webhook** ，创建 **一个 Webhook 监听任务** 。
2. 在同一个任务中，同时选择\*\*「创建访客」 **、** 「更新访客」\*\*两个事件。
3. 将任务的 **请求地址** 填写为第三步发布工作流后获得的请求地址，确保两个事件都发送到 **同一个请求地址** 。
4. 完成请求头配置后，保存 Webhook 任务。

![20261016182753](https://canada1.discourse-cdn.com/flex012/uploads/x3chat/original/2X/0/040572f880c905eeee3ef3734073f04205b6db0a.gif)

### Webhook 请求头配置（外网）

```auto
{
  "X-Tenant-Id": [
    "{从发布的工作流中取}"
  ],
  "Authorization": [
    "Bearer {从@https://app.3chatai.cn/user-hub/multiview/core_openapi_app 中创建永久token并填入}"
  ]
}

```

### Webhook 请求头配置（内网）

请求地址：将`https://app.3chatai.cn`替换为`http://workflow-builder-api-svc:8080`

```auto
{
  "X-Tenant-Id": [
    "{从发布的工作流中取}"
  ]
}

```

## 五、在飞书多维表格中添加应用

1. 打开需要接收访客信息的 **飞书多维表格** 。
2. 为该多维表格 **添加应用** 。
3. 为该应用配置 **可管理** 权限。

**应用名称：**

base\_table\_data\_processing

![20261016182428](https://canada1.discourse-cdn.com/flex012/uploads/x3chat/original/2X/5/504a960d9d8deb6eb11ba97dc72149002b7cf2e2.gif)

## 六、配置飞书多维表格字段

工作流按 **字段名称** 自动匹配：飞书多维表格的列名必须与 Webhook 中的 API 字段名 **完全一致（区分大小写）** ；没有同名列的字段会被跳过。

可参考以下示例创建需要同步的列：

| 字段名 | 用途 |
| --- | --- |
| `id` | 访客业务 ID |
| `accountId` | 访客账号 ID |
| `name` | 访客名称 |
| `totalVisits` | 访问次数 |
| `has_spoken_c` | 是否开口 |
| `has_left_contact_c` | 是否留资 |

> **重要：`id` 和 `accountId` 至少需要配置其中一个。** 更新访客时，工作流先根据 `data.id` 查找原记录；如果 `id` 不可用或未找到，再根据 `data.accountId` 查找。因此，飞书表格至少需要有一个对应的定位字段，且事件数据中应提供该字段的非空值。建议两个字段都保留，并避免定位值重复。

**字段同步原理：** 工作流读取 Webhook 中 `data` 的第一层字段，以及 `extendMap` 的第一层字段，将它们与飞书表格的同名列匹配后写入。创建访客时新增记录；更新访客时定位已有记录并更新。

**测试同步：** 完成配置后，可使用 **沙盒** 分别测试一次「创建访客」和「更新访客」，确认飞书多维表格能新增访客，并在原记录上更新信息。
