自定义字段、潜在客户资料与备注 #

每个联系人都包含基础信息——姓名、电话、电子邮件、渠道。但你通常还会了解更多关于联系人的信息：他们所在的公司、生日、上次购买的内容、他们通过哪个会议渠道而来。本页面介绍了你可以附加到联系人的额外信息，以及每项信息存放的位置。

概览 #

如果你已经使用该应用一段时间了： 过去两个独立的功能——长篇的“潜在客户资料 (Lead Profile)”和按日期堆叠的“备注 (Notes)”列表——现在已合并为一个字段，在联系人的完整记录中标记为备注 (Notes)。现在不再有带标题的独立时间戳备注日志；你关于联系人要写的一切内容都放在这一个框中。请参阅下方的 备注 (Notes) 以了解其实际含义。

定义自定义字段 #

自定义字段可在所有联系人中重复使用。一旦创建了像 company 这样的字段，它就会成为您账户架构的一部分，并出现在每个联系人的编辑表单中。

字段类型 #

每个自定义字段都有一个类型，该类型决定了字段可以容纳什么内容以及如何输入——无论是您在应用中输入、通过导入或 API 输入，还是 AI 在聊天中学习到信息并保存时输入：

类型化字段在写入的任何地方都会经过验证：联系人表单不会将 February 1st 保存到日期字段中，API 会返回一个指明字段名称及其预期值的错误，文件导入会跳过该行并在结果屏幕上列出，AI 会预先获知格式，如果它发送了其他内容，则会收到更正。以可识别的人类格式输入的值会自动为您转换 —— 01/02/1990 会根据您账户的日期格式（日在前或月在前，可在 设置 → 账户 中设置）转换为 1990-02-01，yes 会变为勾选的复选框，如果 newsletter 是您拼写的选项，则会存储为 Newsletter。由于所有日期都以相同的方式存储，智能列表或自动化条件中的“生日在 1990-01-01 之前”比较的是真实的日期，而不是同一天的三种不同拼写。

创建和管理字段 #

1. 在左侧边栏中，点击 联系人。
2. 打开任意联系人并点击 编辑（或点击 新建联系人）。
3. 在 自定义字段 部分，在 添加字段 中输入名称，选择其 类型（下拉菜单需要输入选项），然后点击 添加。该字段将为整个账户创建，并立即出现在此联系人页面上。
4. 若要稍后更改字段的类型或选项，请勿重命名——点击同一部分中的 管理字段。管理器会列出每个字段及其类型；您可以选择新类型、编辑下拉菜单选项或从列表中删除字段。

更改类型会保留现有值。 如果在您将其切换为“日期”之前，birthday 中存储的是自由文本 1 Feb 1990，该值将保留，直到下次编辑（由您、API 或 AI 执行）时，届时它必须是一个有效的日期。系统不会在后台自动重写任何内容。要一次性转换旧值，请使用下方的 规范化现有值。

规范化现有值 #

在您为字段指定类型后，旧值将保持其保存时的拼写方式。日期字段在一位联系人上可能仍存储为 01/02/1990，而在另一位联系人上存储为 1 February 1990，而智能列表或自动化日期规则仅匹配存储为 YYYY-MM-DD 的日期。规范化现有值可将它们一次性全部转换。

1. 打开 管理字段（见上文）。每个日期、数字、下拉菜单和复选框字段下方都有一个 规范化现有值 链接。文本字段没有此链接，因为文本是按原样存储的。
2. 点击它。此时不会有任何更改：应用程序会检查您的联系人并告知您将更改多少个值，显示一个示例（例如 "01/02/1990" becomes "1990-02-01"），并列出无法读取的值。
3. 点击 更改 N 个值 进行转换，或点击 取消 以保持原样。

温馨提示：

• 仅更改可以被读取为该字段类型的值。使用斜杠书写的日期遵循您账户的日期格式（从 设置 → 账户 设置为“日优先”或“月优先”）。无法读取的值（例如日期字段中的 next spring）将保持不变，并显示在列表中，以便您可以在该联系人上手动修复它。
• 已经是正确格式的值和空值不会被触动。多次运行此操作是安全的。
• 如果您刚刚更改了字段类型，请先点击 保存字段。该链接仅在保存新类型后才会出现。
• 它适用于您当前所在账户的所有联系人。在代理机构设置中，请在拥有这些联系人的子账户内运行。
• 相同的操作在 API 中可用，即 POST /users/me/custom-fields/{key}/normalize，并带有 dry_run 用于预览。

从列表中删除字段会将其从编辑表单和 AI 的字段选择器中隐藏；已存储在联系人上的值会被保留，如果重新添加相同名称的字段，它们会再次显示。若要彻底清除所有联系人中的某个字段值，请使用 API 的 删除自定义字段 调用。

命名规则：

• 字段名称必须仅使用小写字母、数字和下划线，并且必须以字母或下划线开头（例如 lead_source，而不是 Lead Source）。
• 仅限无重音的英文字母 —— 空格、大写字母以及带重音或非拉丁字符将被拒绝。即使您的账户其余部分使用其他语言，也请将字段命名为 cumpleanos 或 birthday，而不是 cumpleaños。仅名称受到限制；您存储在其中的值（以及下拉菜单的选项）可以使用任何语言。
• 一个账户最多可以有 50 个自定义字段；一个下拉菜单最多可以有 100 个选项。
• 请谨慎选择名称——一旦字段在模板或 AI 代理中使用，如果不先删除这些引用，您将无法删除该字段。

在联系人上填写自定义字段 #

1. 在左侧边栏中，点击 联系人。
2. 点击联系人所在的行以打开快速查看面板，然后点击 编辑 —— 或者点击 新建联系人 以创建一个新的联系人。
3. 在联系人表单中，找到 自定义字段 部分。您账户上的每个字段都会列出，并配有与其类型相匹配的控件：文本框或数字框、日期选择器、下拉菜单，或者用于复选框字段的“是/否”下拉菜单。
4. 填写值，然后点击表单上的 保存 以存储它们。不符合字段类型的值会立即被标记，在修复之前表单无法保存。

已经有值的字段会在快速查看面板和完整联系人记录中显示为只读行——要更改值，请重新打开 编辑。

清除值： 一旦字段中有了内容，编辑表单的框内会出现一个小 ×。点击它即可仅为该联系人清除该值；字段本身仍保留在您的账户和所有其他联系人上。只要字段仍被模板或 AI 代理引用，就无法将其从所有联系人和账户架构中彻底删除。

让 AI 为您填充自定义字段 #

您的 AI 智能体可以在对话中随时保存信息（例如生日、伴侣姓名、饮食要求、餐桌偏好），以便您稍后在广播或后续跟进中使用。此功能默认处于关闭状态，且它只会写入您明确选择的字段。

必须满足两个条件，且两者缺一不可 — 这是用户发现信息未保存的最常见原因：

1. 先创建字段。 AI 只能写入您账户中已存在的字段。请从联系人的编辑表单中添加（请参阅上方的填写联系人的自定义字段），或者直接在下方第 4 步的 Agent 中添加。对于还没有联系人的新账户，这是最快捷的方法——例如 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 填写的每个字段开启旁边的开关——仅创建字段是不够的，任何未开启的字段都会被静默忽略。需要列表中没有的字段，或者目前还没有任何字段？点击同一卡片上的 Manage custom fields，添加字段及其类型并保存：它会立即出现在列表中（处于关闭状态），并且从那时起在每个联系人上都可用。
5. 点击 Save，然后 Publish 该 Agent。更改会保留在草稿中，直到您发布为止，因此未发布的更改不会影响实时对话。发布操作会推送所有待处理的草稿更改，而不仅仅是这一项，因此如果您一直在进行编辑，请先浏览一下其他选项卡。

值得注意：

• AI 会被告知每个字段的类型。 对于“日期”字段，它会将联系人所说的任何内容（例如“el 1 de febrero del 90”）转换为 1990-02-01 后再保存；对于“下拉菜单”，它只能从您的选项中选择一个；对于“复选框”，它会保存“是”或“否”。如果它发送的内容仍不符合要求，保存操作将被拒绝并返回预期的格式，AI 会再次询问或自行更正——无法解析的值永远不会保存到联系人信息中。
• 它在整个对话过程中都有效，而不仅仅是在预订时。 尽管卡片上的措辞如此——预订是该功能的起点——但只要联系人提到某个值，AI 就会立即保存它，无论是否涉及预约。您根本不需要开启预订功能。
• 每个字段都可以标记为必填。 “必填”仅意味着“必须在 AI 确认预约之前收集”——它绝不会阻碍正常的对话，并且在不接受预约的智能体（Agent）上也不会有任何作用。
• AI 说它“记录”了某事并不等同于保存了它。 如果字段未创建并开启，AI 仍然可以礼貌地回复说它已记录，但没有任何内容会保存到联系人信息中。请检查联系人记录以确认值是否已实际保存。
• 告诉智能体何时询问。 在智能体的指令中，描述每个字段的适用场景（“如果客人提到过敏或饮食偏好，请将其保存到 dietary_notes”）。AI 会以通俗易懂的语言阅读这些指令，因此它不会用同样的列表去盘问每个人。
• 不会回填任何内容。 只有从您发布的那一刻起的对话才会被捕获——过去聊天中已经提到的详细信息不会被追溯填充。
• 在拥有联系人的账户上进行设置。 自定义字段属于单个账户，因此在代理机构设置中，请在执行对话的子账户内创建它们，而不是在父级代理账户上创建。
• 自由格式的备注也应放在字段中。 对话式 AI 无法写入联系人的 潜在客户资料 / 备注 框（见下文）——该框供您和您的团队使用，尽管 自动化 和 API 可以写入它。如果您希望 AI 本身记录诸如“要求提供无麸质餐点”之类的内容，请将其设为一个自定义字段，例如 dietary_notes。

AI 在对话期间可以读取的内容 #

如果您正在决定将信息存放在哪里以便 AI 能够在聊天时根据其采取行动，那么以下区别至关重要：

• 自定义字段：AI 在每次回复时都会读取它们。 联系人的所有自定义字段值在整个对话过程中都对 AI 可用——无论该字段是如何填写的（由您填写、由 AI 之前填写、通过导入或 API 填写）。因此，您在智能体指令中设置的类似“用他们的 preferred_barber 向回头客问候”的规则是有效的，因为 AI 可以在那一刻看到该值。
• 标签：AI 在聊天时看不到它们。 标记是在 AI 回复发送后的一个单独步骤中运行的——AI 会根据您的描述应用标签，但在对话期间不会向其显示联系人已有的标签。类似“如果联系人拥有 VIP 标签，则提供折扣”的指令将不会生效。

经验法则：任何 AI 需要在对话中读取并据此采取行动的内容都应放入自定义字段中。标签适用于对话之外发生的一切——筛选和细分联系人、定位广播，以及在 AI 应用标签的那一刻触发 标签 Webhook 到您的其他系统中。

批量导入自定义字段 #

导入向导可将电子表格列直接映射到自定义字段。标题为字段名称的列（大小写和重音符号无关紧要）会自动为您匹配，任何其他列都可以手动指向一个字段，并且在导入过程中，新建自定义字段可以根据列创建字段。

要添加全新的联系人吗？ 在文件中为每个自定义字段设置一列并导入。新联系人导入时，这些字段就已经填好了。

填充您已有的联系人？

1. 导出您的联系人：联系人 CSV 导出文件为每个自定义字段提供一列。
2. 在电子表格中填写值。保持电话号码列不变，因为这是匹配联系人的依据。
3. 在“检查”步骤中开启更新现有联系人并导入文件。每一行仅更新文件中包含值的自定义字段；空单元格将保持当前值不变。

如果您更愿意通过自己的工具进行操作，API 的批量联系人导入端点在每条记录上采用与 custom_fields 对象相同的值（请参阅 API 访问）。

备注（= 潜在客户资料） #

在联系人的 完整记录 中（从快速查看面板点击 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 为您填写自定义字段。

编辑非常简单：在框中输入内容，然后点击保存备注（或点击放弃以丢弃未保存的更改）。每个条目没有单独的标题或日期——每个联系人只有一个连续的文本块，因此如果您想要带日期的日志，请自行在每次添加内容前加上日期。

在 Chats（聊天）中，联系人侧边栏的“备注”旁边有一个 Research（研究）部分。当开启 在首次回复前研究新联系人 功能时，它会显示智能体自动撰写的简报，并提供一个 Research now（立即研究）按钮，以便手动运行或刷新该简报。

状态 #

每个联系人都有一个状态徽章，显示他们所处的旅程阶段：

直接点击联系人列表中的状态徽章即可进行内联更改——适用于除“垃圾信息”以外的任何状态。由于“垃圾信息”具有额外的副作用，必须通过批量标记为垃圾信息操作（及其确认）来设置。取消标记垃圾信息的操作方式相同，即选择取消标记为垃圾信息。

将联系人分配给团队成员 #

所有权分配——即将联系人分配给一名团队成员，以防其他人意外回复——是在聊天 (Chats) 屏幕而非“联系人”页面设置的：打开对话并使用其中的分配控制项。请参阅 聊天界面 (Chat Interface) 获取完整指南。只有账户所有者和拥有相应权限的用户才能更改分配。

在广播和模板中使用自定义字段 #

自定义字段在传出消息中非常有用。在任何可以编写消息的地方——广播消息、WhatsApp 模板、AI 代理指令——您都可以插入如下占位符：

Hey {{first_name}}, hope things are going well at {{company}}!

当消息发出时，{{first_name}} 和 {{company}} 会被每个联系人的值所替换。如果联系人没有填写该字段，则占位符将留空。

一些小贴士：

• 使用小写、下划线风格的名称——占位符必须与字段名称完全匹配（{{company}}，而不是 {{Company}}）。
• 类型化字段按您的书写方式呈现——日期字段会以您账户的日期格式显示（01/02/1990 或 02/01/1990，取决于 设置 → 账户），复选框显示为 Yes 或 No，下拉菜单显示为选项的确切措辞。
• 内置字段也适用——{{first_name}}、{{last_name}}、{{email}} 和 {{phone_number}} 无需设置为自定义字段即可使用。
• 结合备注使用——对于 AI 个性化内容，请使用 {{personal_context|your instruction}} 而不是固定的自定义字段；AI 会根据联系人的备注编写全新的内容。
• 无法删除正在使用的字段——如果模板使用了 {{company}}，系统会阻止删除 company，直到您从这些模板中将其移除。

需要帮助？ #

关于如何选择存放位置的经验法则：

• 您需要筛选或合并的简短、结构化事实 → 自定义字段。
• 供 AI 或您的团队阅读的背景段落 → 备注。
• 谁负责对话 → 负责人，在“聊天”中设置。

还有疑问？请联系支持团队，我们将协助您进行设置。

后续步骤 #

• 添加新联系人——一次添加一个联系人，以及“联系人”屏幕的完整导览。
• 从文件导入联系人——导入电子表格。
• 聊天界面——联系人分配所在的位置。