---
title: "管理联系人"
description: "联系人由已连接主页上的交互自动创建。筛选和搜索目录，读取和标记联系人，以及删除一个。"
canonical: https://docs.afp.monster/zh-cn/guides/contacts
updated: 2026-08-19
pageType: guide
---

联系人是 AFP 对与你一个已连接主页交互的某人的记录：他们的平台名称和照片、他们来自哪个平台、上次活跃时间、他们留下了多少条评论，以及他们身上的标签。AFP 为你创建联系人——没有人手动添加——在 **Contacts** 下你可以筛选、搜索、打标签和删除它们。

![联系人目录：一个可筛选的联系人列表，显示每个联系人来自哪个主页以及附加的标签](../../../../assets/screenshots/guides/contacts/contact-directory.webp)

## 准备工作

- 一个 AFP 正在接收事件的已连接主页。没有来自未连接主页的内容会到达联系人目录。参见 [连接主页](/zh-cn/start/connect-a-page)。
- 该主页上至少一次真实交互。一个没有评论的主页有一个空的联系人目录，没有方法可以填充它。

## 联系人来自哪里？

当 AFP 第一次处理一个来自它在该主页和平台上未见过社交账号的评论时，会创建联系人。评论被存储，其背后的联系人也在同一时刻创建，不带标签，最后活跃时间设置为该交互的时间。

来自同一人的每次后续交互都会更新现有记录而不是添加另一个。最后活跃时间更新为当前时间，名称刷新为平台报告的用户名，如果记录仍然没有头像则获取头像。

```d2 title="What happens when a comment arrives, depending on whether AFP already holds a contact for that person"
direction: down
comments: "某人在已连接主页上评论"
known: "AFP 是否已有\n该人在此平台上的联系人？" {shape: diamond}
created: "创建新联系人：\n名称、平台、主页、\n最后活跃时间当前、无标签"
photo: "在后台获取头像"
updated: "更新现有联系人：\n最后活跃时间、名称、\n如果缺少头像则获取"
comments -> known
known -> created: 否
created -> photo
known -> updated: 是
```

来自从未在你的主页上评论过的人的私信不会创建联系人。

一个联系人属于一个平台。同一人在你的 Facebook 主页和 Instagram 账户上评论是两条联系人，因为两个平台使用不同的社交账号 ID 识别他们，两条记录分别携带它们的标签和评论计数。

## 联系人记录包含什么？

| 记录包含的内容 | 含义 | 如何到达 |
|---|---|---|
| 姓名 | 平台为该人报告的用户名 | 在联系人创建时写入，在每次后续交互时刷新 |
| 平台 | Facebook 或 Instagram | 在联系人创建时设置，永不更改 |
| 头像 | 该人平台头像的副本，由 AFP 存储 | 在联系人创建后不久获取；只要仍然缺失就在下次交互时重试 |
| 最后活跃 | AFP 上次处理该人交互的时间 | 每次交互时更新；对联系人列表排序并驱动日期范围过滤器 |
| 评论数 | 联系人在你的主页上留下了多少条评论 | 每次读取记录时从链接到记录的评论中计数 |
| 标签 | 附加到此联系人的标签 | 手动应用，或由 **Add tag** 或 **Remove tag** 节点应用——参见 [用标签细分联系人](/zh-cn/guides/tags) |
| 主页 | 看到该人的已连接主页 | 在联系人创建时记录，在后续交互时保持当前 |

联系人记录不携带自己的消息历史。会话在收件箱中，公开评论在评论活动 feed 中；联系人是这两个挂在其上的稳定身份。在活动 feed 中点击评论者的名称会通过其平台社交账号查找他们来打开其联系人记录。[联系人字段](/zh-cn/reference/contact-fields) 列出了记录携带的每个字段及其值的来源。

## 如何在列表中查找一个联系人？

列表按最后活动排序，最新的在前，每次到达 20 个联系人。四个控件缩小范围，它们组合使用——一个联系人必须满足所有控件才能出现。

| 控件 | 匹配内容 | 值得知道 |
|---|---|---|
| 平台 | Facebook 联系人、Instagram 联系人或两者 | 默认两者 |
| 标签 | 携带你选择的标签的联系人 | 一次一个标签，不是一组 |
| 日期范围 | 在最近 *n* 天内活跃的联系人 | **默认最后 30 天。** 设置为 **All** 以搜索整个目录 |
| 搜索 | 联系人名称的一部分，不区分大小写 | 仅匹配名称——不匹配消息文本、不匹配标签、不匹配社交账号 ID |

30 天默认值解释了大多数看起来缺失的联系人。在得出结论认为记录不存在之前，先扩大日期范围。

搜索匹配名称中的任何位置，因此 `mar` 同时找到 `Marta Nowak` 和 `Omar Haddad`。当常见片段返回太多时，将其与标签组合使用。

点击联系人打开其完整记录，带有列表显示的相同评论计数。在列表加载后删除的记录打开为未找到而不是错误。

如果你的账户位于一个主账户之下，该主账户拥有的联系人会与你自己的联系人一起出现在此列表中，并响应相同的过滤器。没有此共享范围时，你只能看到你自己账户拥有的主页的联系人，即使同事的主页曾与同一个人有过交流。

## 如何给联系人打标签？

1. 打开 **Contacts** 并点击联系人，或在收件箱中打开此人的会话。
2. 打开记录上的标签选择器。
3. 选择联系人应携带的每个标签。
4. 保存。

选择器提交整个标签集而不是你做出的单个更改，因此你清除然后保存的标签会从联系人中移除。选择同一标签两次会合并为一个条目，你选择它们的顺序不会存储。

你保存的每个标签都必须是你的账户可以看到的。单个未知标签会拒绝整个更改，联系人保留其原有的标签。

联系人上的标签下次加载会话列表时显示在该人会话旁边，并成为联系人列表的过滤器。[用标签细分联系人](/zh-cn/guides/tags) 涵盖创建标签、重命名它们以及从活动应用它们。

## 我可以自己添加或导入联系人吗？

不可以。没有创建联系人的按钮，没有 CSV 导入，没有方法从另一个工具复制目录——联系人仅因为某人交互了已连接主页而存在。增长目录的方法是获得更多交互，这正是评论到私信活动所做的。参见 [将评论路由到私信](/zh-cn/guides/route-comments-to-dm)。

同一规则适用于活动内部。**Add tag** 节点从不创建联系人：当其运行的人还没有记录时，该节点不写入任何内容，记录其已运行，执行记录继续到下一个节点。

## 删除联系人时会发生什么？

删除会立即移除记录。没有归档、没有恢复、没有回收站可以从中恢复，因此将确认视为最终的。

删除的范围比看起来窄。它**不**做的：

- 它不会删除此人的评论。它们保留在你帖子和评论活动 feed 中的位置，不再链接到任何联系人记录。
- 它不会删除联系人上的标签。标签是一个账户级别的标签；只有此联系人对该标签的副本消失。删除标签是一个单独的操作——参见 [用标签细分联系人](/zh-cn/guides/tags)。
- 它不会屏蔽此人或阻止未来交互。他们在已连接主页上的下一次评论会创建一个全新的联系人记录，不带标签、没有照片、评论计数从该评论开始，因为旧评论不再链接到任何东西。
- 它不会从收件箱中移除会话。该会话保留在列表中；从列表中消失的是标签，因为收件箱从联系人记录读取这些标签。

:::caution
删除联系人会丢弃此人的标签以及他们与他们留下的每条评论之间的链接。如果目标是缩短工作列表，请按日期范围或标签筛选目录。
:::

删除一个已被移除的联系人——在另一个标签中，或由主账户的另一名成员——会报告没有移除任何内容而不是抛出错误。重新加载列表以查看当前状态。

## 为什么联系人在列表中缺失？

| 症状 | 原因 | 修复 |
|---|---|---|
| 你上个月合作过的联系人不见了 | 日期范围过滤器默认为最后 30 天 | 将日期范围设置为 **All** |
| 有人评论但没有联系人出现 | 评论到达于 AFP 没有接收事件的主页，因此没有处理 | 在 **Accounts** 下检查主页，如果需要则重新链接。参见 [连接主页](/zh-cn/start/connect-a-page) |
| 有人发送私信但没有联系人出现 | 联系人记录在评论路径上创建 | 今天无需更改。参见 [联系人来自哪里？](#联系人来自哪里) 下方的说明 |
| 搜索此人写的词汇没有找到任何内容 | 搜索仅匹配联系人名称 | 按名称搜索，或在收件箱中查找会话。参见 [在收件箱中处理会话](/zh-cn/guides/inbox) |
| 同一人出现两次 | 每个平台一条记录——Facebook 和 Instagram 身份是分开的联系人 | 如果你的细分需要覆盖此人在两个平台上的情况，给两条记录都打标签 |
| 记录上的名称已过时 | 名称仅在 AFP 处理该人的新交互时刷新 | 等待他们的下一次评论；记录会自动更新 |
| 联系人没有头像 | 照片获取尚未完成，或该人的平台社交账号不公开照片 | 无需操作。AFP 在该人的下次交互时重试 |
| 按标签筛选返回空 | 标签过滤器与日期范围组合，且该标签可能从未被应用 | 将日期范围设置为 **All**，然后在联系人记录上确认标签 |
| 打开联系人显示未找到 | 记录在列表加载后被删除 | 返回 **Contacts** 并重新加载列表 |
| 活动发送了私信但收件人不在目录中 | 活动按执行记录所在的平台社交账号查找联系人，从不创建 | 检查执行记录以查看它实际做了什么。参见 [测试和调试活动](/zh-cn/guides/test-and-debug-campaigns) |
| 同事的联系人不在你的列表中 | 联系人属于拥有主页的账户，通过主账户共享是使另一账户记录可见的方式 | 确认两个主页位于同一主账户下 |

## 相关

- [联系人字段](/zh-cn/reference/contact-fields) — 联系人上的每个字段、其类型以及你是否可以更改它。
- [用标签细分联系人](/zh-cn/guides/tags) — 使联系人目录可筛选的标签。
- [在收件箱中处理会话](/zh-cn/guides/inbox) — 联系人背后的会话。
- [将评论路由到私信](/zh-cn/guides/route-comments-to-dm) — 将评论者转变为联系人和会话的活动。
- [测试和调试活动](/zh-cn/guides/test-and-debug-campaigns) — 检查活动对一个收件人做了什么。