---
title: "用标签细分联系人"
description: "创建和重命名标签，通过手动操作或使用添加标签和移除标签节点为联系人附加标签，并查看删除标签后会留下什么。"
canonical: https://docs.afp.monster/zh-cn/guides/tags
updated: 2026-08-19
pageType: guide
---

标签是附加在联系人上的简短标识符 —— 一个最多 50 个字符的名称，除此之外别无其他。标签有两种来源：你手动为联系人选择，或者在活动期间由 **Add tag** 或 **Remove tag** 节点应用。一旦联系人携带某个标签，你就可以按该标签筛选联系人列表，这正是维护标签的价值所在。

![标签列表，显示多个标签以及创建和重命名标签的控件](../../../../assets/screenshots/guides/tags/tag-manager.webp)

## 你需要先准备什么

- 一个要打标签的联系人。联系人会在有人与已连接主页互动时首次出现 —— 参见 [与联系人互动](/zh-cn/guides/contacts)。
- 对于自动打标签，需要一个在画布上打开的活动，且触发节点和条件节点已连接。参见 [在画布上构建活动](/zh-cn/guides/build-a-campaign)。

## 我如何创建标签？

AFP 中的每个标签选择器都可以创建新标签，所以你无需离开当前操作即可添加标识符。选择器出现在联系人上、收件箱的会话旁边，以及 **Add tag** 或 **Remove tag** 节点的设置面板中。

1. 在联系人、收件箱会话或 **Add tag** 节点上打开标签选择器。
2. 输入新标签的名称。
3. 确认。标签被保存并立即出现在每个标签选择器中，按名称排序列入列表。

标签名称受两条规则约束，违反其中任何一条都会拒绝保存，而不是存储奇怪的内容。

| 你设置的项 | 规则 | 违反时的后果 |
|---|---|---|
| 标签名称 | 1 到 50 个字符之间 | 空名称或超过 50 个字符的名称会在标签创建前被拒绝 |
| 标签名称唯一性 | 在标签创建的所属权限范围内必须唯一 | 保存会被拒绝，并提示已存在同名标签 |

标签没有其他设置：没有颜色、没有描述、没有自己的规则。在它附加到联系人之前，它什么都不做。

如果你的账户属于主账户，每个选择器会列出该主账户拥有的标签以及你的个人标签。重复名称的检查范围比选择器更窄：你在主账户下创建的标签只与该主账户的标签进行比较，所以旧的个人标签不会阻止同名标签的创建。这就是为什么一个选择器中会出现两个同名条目的原因 —— 它们是两个不同的标签，应用其中一个不会应用另一个。

## 我如何重命名标签？

1. 打开列出你所有标签的标签管理对话框。
2. 就地编辑标签的名称。
3. 确认更改。

重命名是安全的。每个携带该标签的联系人仍然携带它，每个应用该标签的节点仍然应用它，不需要重新保存任何活动 —— 新名称会在旧名称出现的所有地方显示。

将标签重命名为同一权限范围内另一个标签已使用的名称会被拒绝，与创建重复标签的处理方式相同。尝试重命名不属于你编辑权限的标签也会被拒绝，标签本身不会发生任何变化。

## 我如何手动为联系人打标签？

1. 打开 **Contacts** 并点击目标联系人，或在收件箱中打开该联系人的会话。
2. 打开标签选择器。
3. 选择联系人应该携带的所有标签。
4. 保存。

选择器提交的是完整的标签集合，而不是你做的单个更改。你保存的内容会替换原有内容，所以如果你想保留现有的选择，就不要清除它们 —— 清除一个标签并保存就会从联系人身上移除它。重复选择同一个标签会合并为一个，选择的顺序不会被存储。

提交中的每个标签都必须是你的账户可见的。单个未知标签会拒绝整个更改，所以不会部分保存。

## 我如何自动为联系人打标签？

**Add tag** 节点会为执行记录背后的联系人添加一个或多个标签；**Remove tag** 节点会移除列出的标签。这两个节点都可以放在条件节点之后的任何位置，都从相同的标签选择器中选择标签列表，且都只有一个输出让执行记录继续往下走。

1. 在画布上打开活动。
2. 将 **Add tag** 节点拖到画布上，并连接到应该给人员打标签的分支 —— 通常是条件节点的 **Match** 输出。
3. 点击节点并选择要应用的标签。
4. 点击 **Save** 以写入活动图的新版本。
5. 使用 **Active** 切换开关开启活动。

```d2 title="A campaign that adds a tag on a keyword match before sending a DM"
direction: down
arrives: "已连接主页收到评论"
trigger: "触发节点"
cond: "条件节点\n关键词匹配" {shape: diamond}
tag: "添加标签\n感兴趣"
dm: "发送私信"
nothing: "无操作"
arrives -> trigger -> cond
cond -> tag: 匹配
tag -> dm
cond -> nothing: 不匹配
```

添加是合并操作：联系人原有的标签保留，列出的标签会被添加，联系人已携带的标签不会重复。移除操作只减去节点上列出的标签，保留联系人其余的标签不变。

标签节点永远不会创建联系人。当执行记录属于还没有联系人记录的人时，节点不会做任何更改，记录它已运行，执行记录继续到下一个节点。

:::note
测试执行会记录标签步骤但不应用它。要确认标签节点确实会写入联系人，请使用真实评论在已连接主页上触发活动，然后打开联系人。参见 [测试和调试活动](/zh-cn/guides/test-and-debug-campaigns)。
:::

## 标签会出现在哪里？

| 位置 | 标签的作用 |
|---|---|
| 联系人卡片和联系人列表 | 显示联系人携带的标签；卡片上的选择器是编辑标签的地方 |
| 收件箱 | 显示会话中人员的标签，让你在回复时看到所属细分 |
| 联系人列表筛选器 | 将列表缩小到携带指定标签的联系人 |
| **Add tag** 和 **Remove tag** 节点设置 | 选择活动要应用的标签 |

标签选择器一次性列出所有标签，按名称排序，没有分页。它们为几十个标签而非数千个标签设计，所以请保持标签数量足够少以便快速浏览。

## 删除标签后，已打标签的联系人会怎样？

删除操作并不安全，AFP 也不会阻止你。无论联系人或活动是否使用该标签，删除永远不会被拒绝，没有撤销功能，用相同名称重新创建标签会产生新标签而不是恢复旧的分配。

删除标签时会发生两件事：

- 标签不再出现在携带它的联系人上。AFP 只显示它能找到的标签，所以该标识符会从联系人列表、联系人卡片和收件箱中消失。按该标签筛选联系人也不再可能，因为已删除的标签已从筛选器中移除。
- 节点仍然指向你删除的内容。引用已删除标签的 **Add tag** 节点仍然会运行，仍然将该引用写入联系人，只是没有任何地方可以显示它。手动保存联系人的标签会替换整个集合并清除残留。

:::caution
删除标签之前，请打开所有使用 **Add tag** 或 **Remove tag** 节点引用该标签的活动，选择其他标签或移除节点，然后保存每个活动。从运行中的活动下删除标签会导致该活动悄悄地什么标签都不打。
:::

## 为什么标签没有出现在联系人上？

| 症状 | 原因 | 解决方法 |
|---|---|---|
| 保存选择器后，你未触碰的标签消失了 | 选择器会替换联系人的整个标签集合，所以保存时未选中的标签会被移除 | 重新打开选择器，选择联系人应该携带的所有标签，然后保存 |
| 保存标签选择器没有任何变化 | 提交中的一个标签对你的账户不可见，单个未知标签会拒绝整个更改 | 重新打开联系人让标签列表重新加载，然后重新选择并保存 |
| **Add tag** 节点已运行但联系人没有新标签 | 该人员还没有联系人记录，所以节点没有地方可写 | 在 **Contacts** 中确认联系人是否存在 —— 参见 [与联系人互动](/zh-cn/guides/contacts) |
| 测试执行显示标签步骤但联系人没有变化 | 测试执行会记录标签步骤而不是应用它们 | 用真实评论触发活动，然后重新打开联系人 |
| 创建标签被拒绝 | 名称为空、超过 50 个字符或已被同一权限范围内的标签使用 | 缩短或更改名称 |
| 一个标签在所有联系人上同时消失 | 该标签被删除了，删除操作不会询问使用该标签的联系人或活动 | 重新创建标签并重新应用；旧的分配不会恢复 |
| 选择器中有两个相同的名称 | 一个标签是个人拥有的，另一个属于主账户 | 检查你的活动和筛选器使用的是哪一个，然后停用另一个 |
| 按标签筛选联系人返回空结果 | 标签筛选器与日期范围筛选器组合在一起，默认是最近 30 天 | 将日期范围设置为 **All**，然后再次按标签筛选 |

## 相关

- [与联系人互动](/zh-cn/guides/contacts) —— 你打标签的联系人来自哪里，以及如何按标签筛选它们。
- [节点类型](/zh-cn/reference/node-types) —— 每个节点接受的配置，包括标签节点。
- [将评论路由到私信](/zh-cn/guides/route-comments-to-dm) —— 标签节点通常挂接的活动。
- [用关键词列表匹配评论](/zh-cn/guides/keyword-lists) —— 决定哪些人到达你的标签节点。