# 连接 Lark Base

连接一个 Lark（飞书）Base 数据表后，每位进入你的 Flow 智能体的客户都会在表中拥有一行。客户作答时这一行会持续更新，而每项信息写入哪一列由你决定。

## 连接

1. 前往 **Settings → Integrations → Lark Base**。
2. 填写你的 Lark 应用的 **Lark App ID** 和 **Lark App Secret**。
3. 填写 **Base token** 和 **Table ID**，两者都在 Base 的网址中：`/base/<Base token>?table=<Table ID>`。
4. 选择 **Region**：**Lark (global)** 或 **Feishu (China)**。
5. 点击 **Connect**。

## 选择列

连接后，**Field mapping** 会列出数据表的所有列，方便你决定每项信息写入哪里。

1. 点击 **Add mapping**，然后选择一个 **Lark column**。
2. 在 **Data to send** 下选择要写入的内容（见下文）。
3. 为每一列重复以上步骤。
4. 在 **Match customers by** 下，选择用来识别客户的列。请先把某一列映射到联系人的电话号码或电子邮件，再在这里选择它。
5. 点击 **Save mapping**。

点击 **Test mapping** 进行检查：系统会向数据表写入一行测试数据并随即删除；不匹配的列会被指出，方便你修正。

## 每一列可以发送的数据

* **Contact fields** — Contact name、Contact phone number、Contact email、First chatted at、Contact ID、Company、City 和 Country。
* **Inbox** — Inbox name、Inbox ID、Channel，以及 Inbox phone number：客户发来消息的 WhatsApp 或 SMS 号码。没有号码的渠道（例如 Instagram 或你的网站）此项留空。
* **Assignment** — Assigned agent name、Assigned agent email、Team，以及与客户对话的 Flow agent。
* **Conversation** — Conversation ID、Conversation link（在 Mampu AI 中打开该对话）、Status、Priority、Labels、Conversation started at 和 Last activity at。
* **Contact custom attributes** 和 **Conversation custom attributes** — 在 **Settings → Custom Attributes** 中设置的所有属性。
* **Ad source** — 客户通过广告进来时的 Ad / post ID。
* **Flow answers** — 你的 Flow 智能体收集到的答案。

日期写入 Date 列、数字写入 Number 列，映射会自动使用正确的格式。每位客户只有一行，因此 Inbox、Assignment 和 Conversation 列显示的是该客户最近一次对话的信息。

## 何时更新

* 客户一进入你的 Flow 智能体，就会新增一行，并随着客户作答持续更新。
* 当有人把对话分配给某位客服或某个团队，或更改其中之一时，这一行会在几秒内更新，无需等待客户的下一条消息。
* 当对话被取消分配或移除团队时，映射到 **Assigned agent name**、**Assigned agent email** 和 **Team** 的列会被清空，让数据表与你在 Mampu AI 中看到的一致。
* 其他空值永远不会覆盖表中已有的内容。

## 断开连接

在 **Lark Base** 页面点击 **Delete** 并确认。Flow 答案将停止同步；数据表会保留目前已收集的所有内容。

## 相关文章

* [Integrations 概览](/settings/integrations)
* [连接 Google Sheets](/settings/connecting-google-sheets)
* [标签、属性与自动化](/settings/labels-attributes-and-automation)

---
Source: https://help.mampuai.com/zh/settings/connecting-lark-base