# 自定义字段、潜在客户资料与备注 每个联系人都包含基础信息——姓名、电话、电子邮件、渠道。但你通常还会了解更多关于联系人的信息：他们所在的公司、生日、上次购买的内容、他们通过哪个会议渠道而来。本页面介绍了你可以附加到联系人的额外信息，以及每项信息存放的位置。 --- ## 概览 | 内容 | 适用场景 | 存放位置 | |---|---|---| | **自定义字段** | 简短的结构化事实（公司、职位、生日、计划等） | 联系人上的一系列键/值对 | | **备注（= 潜在客户资料）** | 关于此人是谁及其重要性的自由格式描述——AI 在个性化回复时会读取此内容 | 联系人上的单个文本区域 | | **状态** | 跟踪联系人所处的旅程阶段，包括将其标记为垃圾邮件 | 联系人上的单个值 | > **如果你已经使用该应用一段时间了：** 过去两个独立的功能——长篇的“潜在客户资料 (Lead Profile)”和按日期堆叠的“备注 (Notes)”列表——现在已合并为**一个字段**，在联系人的完整记录中标记为**备注 (Notes)**。现在不再有带标题的独立时间戳备注日志；你关于联系人要写的一切内容都放在这一个框中。请参阅下方的 [备注 (Notes)](#notes-lead-profile) 以了解其实际含义。 --- ## 定义自定义字段 自定义字段可在所有联系人中重复使用。一旦你创建了一个字段（如 `company`），它就会成为你账户架构的一部分，并在你编辑其他联系人时作为建议出现。 **字段类型：** 自定义字段仅支持自由文本——没有下拉菜单、单选按钮或多选类型。如果你希望某个字段仅包含几个固定值中的一个（例如“时事通讯”、“推荐”或“广告”等潜在客户来源），请始终输入相同的值，或者通过电子表格导出/重新导入进行批量填充，以确保每个联系人都使用你想要的精确措辞。 **命名规则：** - 字段名称必须仅使用小写字母、数字和下划线，且必须以字母或下划线开头（例如 `lead_source`，而不是 `Lead Source`）。 - **仅限无重音的英文字母** — 空格、大写字母以及带重音或非拉丁字符将被拒绝。即使您的账户其余部分使用其他语言，也请将字段命名为 `cumpleanos` 或 `birthday`，而不是 `cumpleaños`。仅名称受到限制；您存储在其中的值可以使用任何语言。 - 一个账户最多可以拥有 **50 个自定义字段**。 - 请谨慎选择名称 — 一旦字段在模板或营销活动中使用，除非先删除这些引用，否则您将无法删除该字段。 --- ## 在联系人上填写自定义字段 1. 在左侧边栏中，点击 **Contacts**（联系人）。 2. 点击联系人所在的行以打开[快速查看面板](creating-contacts.md)，然后点击 **Edit**（编辑）—— 或者点击 **New contact**（新建联系人）以创建一个新的联系人。 3. 在联系人表单中，找到 **Custom Fields**（自定义字段）部分。 4. 在 **Add a field**（添加字段）中输入名称（现有字段名称会作为建议显示 — 点击其中一个即可复用），点击 **Add**（添加），然后输入值。 5. 点击表单上的 **Save**（保存）以进行存储。 已经有值的字段会在快速查看面板和完整联系人记录中显示为只读行——要更改值，请重新打开 **编辑**。 从编辑表单中**删除字段**会从该联系人中移除该值。如果某个字段仍被模板或营销活动引用，则无法将其从所有联系人及账户架构中彻底删除。 --- ## 让 AI 为您填充自定义字段 您的 AI 智能体可以在对话中随时保存信息（例如生日、伴侣姓名、饮食要求、餐桌偏好），以便您稍后在广播或后续跟进中使用。此功能默认处于关闭状态，且它只会写入您明确选择的字段。 必须满足两个条件，且**两者缺一不可** — 这是用户发现信息未保存的最常见原因： **1. 先创建字段。** AI 只能写入您账户中已存在的字段。请按常规方式添加它们（参见上文的[在联系人上填充自定义字段](#filling-in-custom-fields-on-a-contact)） — 例如 `customer_birthday`、`partner_name`、`dietary_notes`。请记住命名规则：仅限小写字母、数字和下划线。 **2. 授予智能体权限并选择字段。** 1. 点击侧边栏中的 **AI Agents** 并打开该 Agent。 2. 前往 **AI abilities** 选项卡。 3. 在 **Contact updates** 下，开启 **Allow AI to collect extra info**。 4. 此时会出现一张名为 **Collect extra info during booking** 的卡片，列出您的自定义字段。为您希望 AI 填写的**每个**字段开启开关——仅创建字段是不够的，任何未开启的字段都会被静默忽略。（如果卡片显示您尚未创建任何自定义字段，请先返回并创建它们。） 5. 点击 **Save**，然后 **Publish** 该 Agent。更改会保留在草稿中，直到您发布为止，因此未发布的更改不会影响实时对话。发布操作会推送**所有**待处理的草稿更改，而不仅仅是这一项，因此如果您之前一直在进行编辑，请先浏览一下其他选项卡。 **值得注意：** - **它在整个对话过程中都有效，而不仅仅是在预订时。** 尽管卡片上的措辞如此——该功能最初确实是用于预订场景——但只要联系人提到相关信息，AI 就会立即保存该值，无论是否涉及预约。您甚至完全不需要开启预订功能。 - **每个字段都可以标记为必填。** “必填”仅意味着“在 AI 确认预约之前必须收集该信息”——它绝不会阻碍正常的对话，并且在不接受预约的 Agent 上也不会有任何作用。 - **AI 说它“记下了”某事并不等同于已保存。** 如果字段未创建且未开启，AI 仍然可以礼貌地回复说它已记录，但联系人资料中不会有任何内容。请检查联系人记录以确认值是否已实际保存。 - **告诉 Agent 何时询问。** 在 Agent 的指令中，描述每个字段的适用场景（例如“如果客人提到过敏或饮食偏好，请将其保存到 `dietary_notes`”）。AI 会以通俗易懂的语言读取这些指令，因此它不会用同样的列表去盘问每个人。 - **不会回填任何信息。** 只有从您发布的那一刻起的对话才会被捕获——过去聊天中已经提到的详细信息不会被追溯填充。 - **在拥有联系人的账户上进行设置。** 自定义字段属于单个账户，因此在代理机构设置中，请在进行对话的子账户内创建它们，而不是在父级代理账户上创建。 - **自由格式的备注也应放在字段中。** 对话式 AI 无法写入联系人的 **Lead profile / Notes** 框（见下文）——该框供您和您的团队使用，尽管 [Automations](../automations/automations.md) 和 API 可以写入它。如果您希望 AI 自己记录诸如“要求提供无麸质餐点”之类的内容，请将其设为自定义字段，例如 `dietary_notes`。 --- ## AI 在对话期间可以读取的内容 如果您正在决定将信息存放在哪里以便 AI 能够在**聊天时根据其采取行动**，那么以下区别至关重要： - **自定义字段：AI 在每次回复时都会读取它们。** 联系人的所有自定义字段值在整个对话过程中都对 AI 可用——无论该字段是如何填写的（由您填写、由 AI 之前填写、通过导入或 API 填写）。因此，您在智能体指令中设置的类似“用他们的 `preferred_barber` 向回头客问候”的规则是有效的，因为 AI 可以在那一刻看到该值。 - **标签：AI 在聊天时看不到它们。** 标记是在 AI 回复发送后的一个单独步骤中运行的——AI 会根据您的描述应用标签，但在对话期间不会向其显示联系人已有的标签。类似“如果联系人拥有 VIP 标签，则提供折扣”的指令将**不会**生效。 经验法则：任何 AI 需要在对话中读取并据此采取行动的内容都应放入**自定义字段**中。**标签**适用于对话之外发生的一切——筛选和细分联系人、定位广播，以及在 AI 应用标签的那一刻触发 [标签 Webhook](../integrations/webhooks.md) 到您的其他系统中。 --- ## 批量导入自定义字段 导入向导的列映射仅识别 **名字 (first name)、姓氏 (last name)、电话 (phone)、电子邮件 (email)、标签 (tags) 和备注 (notes)** —— 没有“将此电子表格列映射到自定义字段”的步骤（相比之下，标签确实可以作为真正的标签导入）。若要批量加载自定义字段值，请使用 API —— 具体采用哪种路径取决于联系人是否已存在。 **添加全新的联系人？** API 的批量联系人导入端点可以在同一次调用中直接获取自定义字段值，因此您无需进行第二次操作。在每条记录中，除了姓名、电话和电子邮件外，还需包含一个 `custom_fields` 对象，这样联系人在导入时就会自动填好自定义字段。请求格式记录在 API 参考文档的“联系人 (Contacts)”部分中。 **填充您已有的联系人？** 1. 通过 API 列出您的联系人以获取每个联系人的 ID。CSV 导出文件不包含联系人 ID 列或任何自定义字段列。请参阅 [API 访问](../integrations/api-access.md) 以了解如何获取密钥并调用端点。 2. 在您的电子表格中填入这些值。 3. 使用 API 的联系人更新端点（请参阅 [API 访问](../integrations/api-access.md)）按联系人回写数据，因为导入向导本身尚不支持自定义字段列映射。每次更新仅会修改您发送的键值 —— 您未包含的任何自定义字段将保留其当前值。 --- ## 备注（= 潜在客户资料） 在联系人的 **完整记录** 中（从快速查看面板点击 **Open full record**），**Notes** 面板是一个单一的自由文本框——在其他地方也被称为“潜在客户资料 (Lead profile)”，其底层字段是同一个。在联系人的 **Edit** 表单中，同一个框被标记为 **Lead profile**，描述为“关于此联系人的内部备注”，所以不要去寻找第二个字段。写下任何与对话相关的内容：业务类型、痛点、公司规模、近期活动，以及任何有助于个性化外联的信息。 **AI 如何使用它：** 在消息模板（广播消息、后续跟进、AI 代理的指令）中，您可以包含类似 `{{personal_context|write a one-line opener that references their business}}` 的占位符。当该模板发送给特定联系人时，AI 会读取他们的备注，并利用其中的内容撰写个性化语句。如果联系人没有备注，该占位符将直接从消息中移除。 AI **不会**为您填写此内容——由您或您的团队填写。可以将其视为您希望销售代表在打电话前阅读的“小抄”。如果您希望 AI 自己记录在对话中学到的内容，请改用自定义字段——请参阅 [让 AI 为您填写自定义字段](#letting-the-ai-fill-custom-fields-for-you)。 编辑非常简单：在框中输入内容，然后点击**保存备注**（或点击**放弃**以丢弃未保存的更改）。每个条目没有单独的标题或日期——每个联系人只有一个连续的文本块，因此如果您想要带日期的日志，请自行在每次添加内容前加上日期。 --- ## 状态 每个联系人都有一个**状态**徽章，显示他们所处的旅程阶段： | 状态 | 含义 | |---|---| | **新联系人** | 刚进入系统，尚未互动。 | | **已互动** | 正在积极对话中。 | | **潜在客户** | 表现出购买意向。 | | **客户** | 已转化。 | | **流失** | 曾是客户，但不再活跃。 | | **垃圾信息** | 从您的主要列表中隐藏；AI 机器人不会与他们互动，已开启“请勿打扰”，且他们会被排除在营销活动之外。 | 直接点击联系人列表中的**状态**徽章即可进行内联更改——适用于除“垃圾信息”以外的任何状态。由于“垃圾信息”具有额外的副作用，必须通过批量**标记为垃圾信息**操作（及其确认）来设置。取消标记垃圾信息的操作方式相同，即选择**取消标记为垃圾信息**。 --- ## 将联系人分配给团队成员 所有权分配——即将联系人分配给一名团队成员，以防其他人意外回复——是在**聊天 (Chats)** 屏幕而非“联系人”页面设置的：打开对话并使用其中的分配控制项。请参阅 [聊天界面 (Chat Interface)](../chats/chat-interface.md) 获取完整指南。只有账户所有者和拥有相应权限的用户才能更改分配。 --- ## 在广播和模板中使用自定义字段 自定义字段在传出消息中非常有用。在任何可以编写消息的地方——广播消息、WhatsApp 模板、AI 代理指令——您都可以插入如下占位符： ``` Hey {{first_name}}, hope things are going well at {{company}}! ``` 当消息发出时，`{{first_name}}` 和 `{{company}}` 会被每个联系人的值所替换。如果联系人没有填写该字段，则占位符将留空。 一些小贴士： - **使用小写、下划线风格的名称** — 占位符必须与字段名称完全匹配（`{{company}}`，而不是 `{{Company}}`）。 - **内置字段同样适用** — `{{first_name}}`、`{{last_name}}`、`{{email}}` 和 `{{phone_number}}` 无需设置为自定义字段即可使用。 - **结合备注使用** — 对于 AI 个性化内容，请使用 `{{personal_context|your instruction}}` 代替固定的自定义字段；AI 会根据联系人的“备注”撰写全新的内容。 - **无法删除正在使用的字段** — 如果某个模板使用了 `{{company}}`，系统会阻止删除 `company`，直到您将其从这些模板中移除。 --- ## 需要帮助？ 关于如何选择存放位置的经验法则： - **您需要筛选或合并的简短、结构化事实** → 自定义字段。 - **供 AI 或您的团队阅读的背景段落** → 备注。 - **谁负责对话** → 负责人，在“聊天”中设置。 还有疑问？请联系支持团队，我们将协助您进行设置。 --- ## 后续步骤 - [添加新联系人](creating-contacts.md)——一次添加一个联系人，以及“联系人”屏幕的完整导览。 - [从文件导入联系人](importing-contacts.md)——导入电子表格。 - [聊天界面](../chats/chat-interface.md)——联系人分配所在的位置。