# 组织列表与联系人

列表可以将您的联系人进行分组，以便您向合适的人发送合适的消息——例如“新潜在客户”列表、“VIP 客户”列表、“通讯订阅者”列表等。

本指南涵盖了如何查找和管理您的列表、浏览列表内的联系人、编辑联系人，以及从主表格中批量管理联系人。


---

## 在哪里查找您的列表

两者都位于同一个**联系人**区域内，通过页面顶部的两个标签页进行切换：

- **联系人标签页** — 表格上方有一个紧凑的列表选择器，旁边还有一个始终可见的**+ 创建列表**按钮。
- **列表标签页**（点击**联系人**旁边的**列表**） — 一个专门用于创建、重命名、删除和浏览每个列表的页面，每行显示成员数量以及**“为 N 个营销活动/广播提供数据”**的指示器。


### 列表选择器（联系人标签页）

1. 在左侧边栏中，点击**联系人**。
2. 在表格上方，点击**列表选择器**胶囊。它会打开一个包含所有列表的下拉菜单，每个列表显示其名称和联系人数量。选择一个列表以将表格筛选为仅显示该列表，或选择**所有联系人**以清除筛选。
3. 选择列表后，再次点击其下拉菜单可进行**编辑列表**、**复制列表 ID**、**删除列表**以及**删除列表及联系人**操作——这些操作与下文所述相同，且无需离开“联系人”页面。


选择器旁边是一个常驻的**+ 创建列表**按钮——无需先选择任何内容。

### 列表页面

点击**联系人**旁边的**列表**标签页。每个列表都显示为一行，包含其名称、成员数量以及**“为 N 个营销活动/广播提供数据”**指示器——这表示有多少个活动的广播或营销活动会自动向加入该列表的任何新成员发送消息（请参阅 [将联系人添加到列表](#adding-contacts-to-a-list) 以了解其重要性）。


打开列表的**行菜单**（“⋯”）以执行相关操作：

| 选项 | 功能 |
|---|---|
| **编辑列表** | 重命名列表并允许您更改其中的联系人。 |
| **复制列表 ID** | 将列表的内部 ID 复制到剪贴板（适用于 API 或 Webhook）。 |
| **删除列表** | 删除列表本身，但**保留账户中的所有联系人**——他们只是被从该列表中移除。 |
| **删除列表及联系人** | 删除列表并**永久删除其中的所有联系人**。此操作无法撤销。 |

这两个删除选项均以红色标出，且每个选项都会打开各自的确认窗口——删除列表和删除列表中的联系人始终是两个独立的“您确定吗？”步骤，因此您不会在只想删除列表时误删列表中的联系人。

> **如果某个列表正被广播使用**，您暂时无法将其删除——对话框中会显示该广播的名称。请打开**广播**页面并在该处解除关联（通过删除广播或将其指向另一个列表），然后再回来重试。

---

## 创建新列表

您可以从列表选择器（“联系人”选项卡）或“列表”页面顶部的 **+ 新建列表 (+ New List)** 按钮进行操作：

1. 点击 **+ Create list** / **+ New List**。
2. 在 **List type** 下，保持选中 **Static list** — 这是普通列表，你需要自行选择联系人。（**Smart list** 则根据规则自动填充 — 请参阅下方的 [Smart Lists](#smart-lists-auto-updating)。）
3. 输入名称（例如 `Summer Sale Contacts`）。
4. *(可选)* 如果对话框提示，可以直接添加联系人。
5. 点击 **Create list**。


新列表会立即出现在选择器和“列表”页面中。

> **如果找不到“创建列表”：** 说明您的账户没有编辑联系人的权限。请联系您的账户所有者更新您的团队角色。

---

## 智能列表 (Smart Lists) (自动更新)

**智能列表 (Smart list)** 是无需你手动填充的列表。你只需设置一次规则 — 例如“拥有标签 `hot-lead` 且在过去 90 天内活跃” — 列表就会自动保持最新状态：符合条件的联系人会自动加入，不再符合条件的联系人会自动移出，无需你进行任何操作。

普通 (**静态**) 列表则相反：无论你将谁放入其中，他们都会一直留在列表里，直到你手动将其移除。这两种列表在其他方面的功能完全相同 — 你可以向智能列表发送广播、按列表过滤“联系人”表格，以及导出列表，操作方式与任何其他列表完全一致。

### 创建智能列表

1. 在 **Lists** 选项卡上，点击 **+ New list**。
2. 在 **List type** 下，选择 **Smart list**。
3. 为其命名（例如 `Hot leads (active)`）。
4. 在 **Rules** 下，选择 **Match: All rules**（匹配所有规则）或 **Any rule**（匹配任一规则）（见下文），然后构建你的第一条规则：选择要检查的内容、比较方式以及数值。
5. 每增加一个条件，点击 **+ Add rule**。一个智能列表最多可以使用 20 条规则。
6. 查看规则下方的行 — 它会实时统计当前匹配的联系人数量（例如“≈ 3 contacts match”）并列出其中几位，这样你在保存前就能确认规则是否抓取到了你想要的目标。
7. 点击 **Create list**。


列表在创建的那一刻即被填充，因此打开时成员已经包含在内。

### 匹配所有规则 (Match All Rules) 与匹配任一规则 (Any Rule)

- **All rules** — 只有当 *所有* 规则都为真时，联系人才会在列表中。使用此选项可缩小范围（“标签为 `hot-lead` **且** 在过去 90 天内活跃”）。
- **Any rule** — 只要 *至少有一条* 规则为真，联系人就会在列表中。使用此选项可汇总数据（“标签为 `newsletter` **或** 标签为 `webinar`”）。

### 你可以基于哪些条件构建规则

| 分组 | 您可以检查的内容 |
|---|---|
| **他们是谁** | **标签**（包含任意一个 / 包含所有 / 不包含任何一个）、**列表**（在列表中 / 不在列表中 — 仅限普通列表）、**渠道**（WhatsApp、短信、Instagram 等）、**状态** |
| **他们做了什么** | **添加时间**、**最后活动**、**最后收到的消息**、**最后发送的消息**、**首次 AI 对话**、**最后 AI 对话** — 每一项都可以设置为“在过去 N 小时/天内”、“不在过去 N 小时/天内”（这也包括从未进行过该操作的人）、在特定日期之前或之后（可选具体时间），以及一个<strong>现在</strong>按钮，用于填入当前时刻（例如，在进行大规模导入前，这对于仅捕获从现在起添加的联系人非常方便），或者简单地设置为已填写 / 为空。此外还有<strong>与 AI 对话过</strong>，可设置为开启或关闭 |
| **设置** | **AI 回复**开启或关闭、**请勿打扰**、**私有联系人**、**曾经回复过** |
| **他们的交易** | **交易阶段** — 在您选择的任何（或没有）流水线阶段中拥有[交易](../deals/sales-pipeline.md)，或者简单地设置为<strong>拥有任何交易</strong> / <strong>没有任何交易</strong> |
| **详细信息** | **电子邮件**、**电话号码**、**名字**、**姓氏** — 已填写、为空、包含或不包含某些文本；**已分配的营销活动**和**已分配的团队成员**；以及您自己的任何<strong>自定义字段</strong>（按名称） |

在文本比较中，大小写不敏感。此外，要求“不在过去 30 天内”的规则也会匹配那些从未发生过该操作的联系人。

#### AI 实际处理过的联系人

**与 AI 对话过**对于 AI 至少发送过一条消息的每位联系人均为“是”，对于其他人则为“否” — 包括仅由您的团队回复过的人。该状态在 AI 首次向某人发送消息时设置，之后不会消失，即使您随后关闭了该联系人的 AI 回复功能或将其移动到另一个营销活动中也是如此。

如果您需要 AI 在**特定时期内**处理过的联系人 — 这是代理机构通常需要此功能的原因 — 请改用 **最后 AI 对话时间** 并设置为“在过去 30 天内”。这是一个滚动窗口，始终反映最近一个月的情况。

人们经常混淆的两个规则：

- **AI 回复**（在“设置”下）是一个开关：它表示 AI *被允许*回复此联系人，并不代表它曾经回复过。
- **曾回复过**是指*联系人*写回消息 — 针对任何人，包括您的团队。

您也可以通过同样的方式筛选“联系人”表格，而无需创建列表：打开 **筛选器** 并将 **与 AI 对话过** 设置为“开启”，或者点击表格上方的 **与 AI 对话过** 快速筛选标签。同样的筛选器也位于 [聊天页面](../chats/chat-interface.md#chat-filters) 上，显示为 **与 AI 对话过** 标签，供您在需要查看对话而非联系人记录时使用。



### 识别智能列表

在“列表”页面上，智能列表会带有 **Smart** 徽章，名称下方会显示其规则的简明英语摘要，以及上次更新的时间（例如“Updated 4 minutes ago”）。其成员数量显示的是实时统计结果。


### 智能列表何时更新

- **当联系人发生变化时立即更新。** 为某人添加标签、更改其状态、填写自定义字段 — 如果这使他们符合（或不再符合）条件，列表会在几秒钟内更新。将交易拖动到另一个流水线阶段也算数：**交易阶段**规则会在看板变更的瞬间做出反应。
- **基于时间的规则每 15 分钟更新一次。** 像“过去 30 天内无活动”这样的规则会随着时间推移而生效，无需任何人操作联系人，因此每个智能列表也会以每刻钟为周期进行重新检查。
- **按需更新。** 打开列表的 **⋯** 菜单并点击 **立即刷新** 以立即重新运行规则，列表的成员数量和“更新于……”行会立即同步。

### 您无法手动添加或移除人员

这正是智能列表的意义所在：其成员资格是根据规则计算得出的，因此您手动进行的任何操作都会在下次检查时被撤销。实际上：

- 展开后的列表没有 **添加联系人** 按钮，成员列表也没有 **移除** 选项——取而代之的是显示 *“成员由该列表的规则计算得出”*。
- 智能列表不会出现在“联系人”页面的 **列表** 批量操作中，也不会出现在联系人自身的列表选择器中，或作为导入目标。

若要更改列表成员，请打开其 **⋯** 菜单并点击 **编辑规则**。

### 智能列表与广播

广播可以像定位其他列表一样定位智能列表，这正是它们最实用的地方：将广播指向“已标记 `hot-lead`，7 天内无回复”的列表，受众群体即可自动维护。

> **注意：这可能会自动发送消息。** 如果该列表上的实时广播或营销活动开启了 **发送给新列表成员**，那么每个新符合您规则的联系人都会自动收到开场消息——这正是将它们结合使用的目的，但这也意味着无需您点击任何内容即可向用户发送消息，且每条消息都会消耗额度。在扩大规则范围之前，请检查列表的供稿情况（“列表”页面上的 **供稿** 列）。

---

## 浏览和搜索列表成员

在“列表”页面上，点击列表所在的行以展开它并查看其中的所有成员。您可以使用搜索框按姓名、电话或电子邮件查找某人。在此处，您可以**从列表中移除单个联系人**——这只会将他们从该列表中移除，不会删除该联系人，也不会影响他们的其他列表。

在 [智能列表](#smart-lists-auto-updating) 上，相同的面板是只读的：您可以浏览和搜索其成员，但没有“移除”选项，因为其成员资格源自其规则。

---

## 将联系人添加到列表

您可以从展开的列表视图、联系人的快速查看面板或完整记录中，或者使用下方的 **添加到列表** 批量操作将联系人添加到列表中。[智能列表](#smart-lists-auto-updating) 不会出现在上述任何位置——它们会根据自身规则自动填充成员。

> **请注意：将某人添加到列表中可能会向其发送消息。** 如果该列表上的某个实时广播开启了 **发送给新列表成员** 功能，那么添加联系人会立即向其发送该广播的开场消息，扣除额度，并将他们的回复转交给该广播的代理。
>
> 在此操作发生前，您会看到警告。无论您通过何种方式添加联系人——无论是批量 **添加到列表** 操作、列表自身的 **添加成员** 界面，还是在联系人详情页切换列表开关——界面都会告知您将发送哪个广播，并要求您确认。从列表中移除某人绝不会发送任何消息，因此该操作始终是即时的。
>
> 如果同一列表上有 **多个** 实时广播开启了该开关，新联系人将收到 **来自每个广播的一条开场消息**，并分别扣费。警告信息会说明具体数量。您可以在广播的“受众”步骤中停止此操作——请参阅 [广播](../broadcasts/broadcasts.md)。

---

## 编辑联系人

1. 在“联系人”表格中，点击联系人**行**上的任意位置以打开[快速查看面板](creating-contacts.md)。
2. 点击**编辑**。
3. 更新他们的姓名、电话号码、电子邮件、渠道、标签或备注。
4. 点击**保存**。

> **点击行与点击名称的区别。** 点击某一行会打开快速查看面板。点击联系人的**名称**则会直接与他们开启聊天 — 请参阅 [添加新联系人](creating-contacts.md)。

列表成员资格是在快速查看面板的**列表**部分进行编辑的，而不是在编辑表单本身中——点击面板中**列表**旁边的 **+** 号，然后勾选或取消勾选列表即可。

---

## 批量操作（一次选择多个联系人）

1. 勾选联系人行开头的复选框。您可以根据需要勾选任意数量的联系人，也可以使用表头复选框选择当前显示的所有联系人。当勾选整页后，**表格行上方会出现一条蓝色横条**，提供**选择所有符合筛选条件的 N 个联系人**选项——只需点击一下，即可将选择范围扩展到所有匹配项，而不仅仅是当前可见页面，因此一次操作即可覆盖数千个联系人。该横条仅用于选择*对象*；执行操作的按钮位于下方的操作栏中。
2. **屏幕底部会出现一个浮动操作栏**，包含：
   - **开启机器人 / 关闭机器人** — 为所有选定的联系人切换 AI 机器人。
   - **设为私有 / 设为公开** — 切换隐私状态。
   - **开启免打扰 / 关闭免打扰** — 切换“免打扰”模式。
   - **标记为垃圾信息 / 取消标记为垃圾信息**。
   - **归档 / 取消归档** — 关闭所有选定联系人的聊天并将其移至聊天归档，或将其全部恢复。这与“聊天”页面的归档相同——请参阅 [关闭对话](../chats/chat-interface.md#closing-a-conversation-when-youre-done)。
   - **分配营销活动** — 将选定对象分配至某个营销活动。**仅限经典营销活动账户** — 请参阅下方的说明。
   - **添加到列表**。
   - **标签** — 为所有选定的联系人应用标签。
   - **自动标签** — 让每个联系人的 AI 代理读取整个对话并应用其自身的标签规则，或为所有选定对象选择一个代理的规则。价格与实时标记相同：每个应用的标签扣除 1 个积分，未获得新标签的联系人不扣费。每次运行最多支持 500 个联系人。请参阅 [按需标记对话](../get-started/creating-tags.md#tagging-a-conversation-on-demand)。
   - **自动化** — 将选定对象添加到自动化流程中。仅当您的账户拥有“自动化”功能时才会显示。
   - **导出** — 将选定内容下载为文件。
   - **删除** — 永久删除所有选定的联系人。
3. 点击您想要执行的操作。破坏性操作（删除、标记为垃圾信息）会先请求确认。

> **没有“分配营销活动”按钮？这是 AI 代理账户的正常现象。** 如果您的菜单显示 **AI 代理** 而没有 **营销活动** 条目，则说明将联系人分配给营销活动的功能不再适用。请改为将联系人放入**列表**，然后通过 [广播](../broadcasts/broadcasts.md) 发送给该列表，或者让 [入口点](../ai-agents/entry-points.md) 将新的对话交给合适的代理处理。旧方式到新方式的完整映射请参考：[从营销活动迁移到广播与代理](../moving-from-campaigns.md)。

点击操作栏末尾的小 **×** 号，或取消勾选复选框，即可清除您的选择。

> **与“聊天”页面不同。** 在**联系人**页面，批量操作栏浮动在屏幕底部。在**聊天**页面，对应的操作栏位于*聊天列表上方*，在列表列内，并配有自己的主复选框——请参阅 [收件箱批量操作](../chats/chat-interface.md#bulk-inbox-actions)。当可见页面被完全勾选时，两个页面都会在行上方显示相同的“选择所有 N 个”条带。

> **提示：将联系人拆分为等量批次。** 虽然没有自动“拆分为 50 个一组”的按钮，但表格本身可以帮您快速实现：它正好显示**每页 50 个联系人**，且表头的复选框可以选中整页。因此，勾选表头复选框，点击 **Add to list**，在弹窗中点击 **+ New list** 并为其命名（例如“批次 1”）——创建列表的瞬间，您选中的联系人就会自动添加到其中。然后转到下一页并重复此操作。几百个联系人只需几分钟即可拆分为每组 50 个的等量列表——无需逐个添加联系人。如果您仅需为了*发送*（而非整理）而进行分批，则完全可以跳过列表：**Drip mode**（滴灌模式）下的 [Broadcast](../broadcasts/broadcasts.md) 会自动为您将一个大型列表分批处理。

---

## 后续步骤

- [添加新联系人](creating-contacts.md) — 逐个添加联系人，并全面了解联系人屏幕。
- [从文件导入联系人](importing-contacts.md) — 上传包含联系人的电子表格。
- [导出您的联系人](exporting-contacts.md) — 将您的联系人下载到文件中。