---
title: "联系人字段"
description: "联系人记录持有的每个字段，每个值来自哪里，哪个字段可以更改，联系人如何按平台分别记录，以及 AFP 从不存储什么。"
canonical: https://docs.afp.monster/zh-cn/reference/contact-fields
updated: 2026-08-19
pageType: reference
---

一个联系人持有这个人的姓名和头像、识别其身份的平台和社交账号 ID、其互动到达的已连接主页、附加在其身上的标签，以及最后活跃的时间。标签是唯一可以更改的字段。联系人是从一条传入评论自动创建的，所以记录上的任何内容都不是手动输入的，也没有方法可以自己添加一个。

## 概览

| 字段 | 类型 | 值来自哪里 | 是否可编辑 |
|---|---|---|---|
| 姓名 | text | 创建该联系人的互动上的用户名，每次后续互动都会刷新 | 否 |
| 社交账号 ID | text | Facebook 或 Instagram 用于识别该人的标识符 | 否 |
| 平台 | `facebook` 或 `instagram` | 互动到达的平台 | 否 |
| 头像 | image | 联系人创建后从平台获取，再由 AFP 存储 | 否 |
| 主页 | 主页引用 | 互动到达的主页 | 否 |
| 标签 | 标签引用列表 | 联系人的标签选择器，或活动中的 `add_tag` 和 `remove_tag` 节点 | 是 |
| 最后活跃 | timestamp | 联系人创建时设置，并在每次后续互动时更新 | 否 |
| 评论数 | number | 每次读取记录时，从关联到该联系人的评论中统计得出 | 否 |
| 性别 | fixed value | 联系人创建时设置为未知 | 否 |

## 姓名

- **类型：** text
- **是否可编辑：** 否

AFP 随互动一起接收到的用户名。同一个人之后的每次互动都会覆盖它，所以一个重命名了社交账号的人，会在其下一次评论后以新名称出现。

## 社交账号 ID

- **类型：** text
- **是否可编辑：** 否

平台对该人自己的标识符。它是联系人身份的一半——平台是另一半——也是活动的标签节点用来查找该记录的依据。

## 平台

- **类型：** `facebook` 或 `instagram`
- **是否可编辑：** 否

互动来自哪个平台。它是联系人身份的一部分，而不是一个设置，也是联系人列表的过滤条件之一。

## 头像

- **类型：** image
- **是否可编辑：** 否

联系人存在后，在后台从 Facebook 或 Instagram 获取，再由 AFP 存储，这样联系人列表就不依赖于一个持续有效的平台 URL。一个联系人可能在其头像之前就出现。获取失败时，该字段保持为空，并在那个人下一次与主页互动时重新尝试。

## 主页

- **类型：** 主页引用
- **是否可编辑：** 否

互动到达的已连接主页，在联系人创建时记录，并随后续互动保持最新。联系人属于拥有该主页的账户，当你的账户位于一个主账户之下时，该主账户拥有的联系人会与你自己的联系人一起显示。

## 标签

- **类型：** 标签引用列表
- **是否可编辑：** 是

联系人上的标签选择器会替换整个集合：它保存的是留下的已选标签，所以取消勾选一个标签就会移除它。你的账户看不到的标签会被拒绝，联系人保持不变。

活动以不同的语义写入同一个字段。一个 `add_tag` 节点会将其标签合并到联系人已有的标签中，一个 `remove_tag` 节点则会减去其标签；两者都不会替换整个集合。两者都通过社交账号 ID 和平台查找联系人，所以对一个还没有联系人记录的人来说，执行记录不会做任何改变，会继续前往下一个节点。[节点类型](/zh-cn/reference/node-types) 介绍了这两个节点，[关键词匹配规则](/zh-cn/reference/keyword-matching) 介绍了决定它们是否运行的条件。

## 最后活跃

- **类型：** timestamp
- **是否可编辑：** 否

在联系人创建时设置为那一刻，并在该人之后的每次互动时更新。联系人列表按它排序，最新的在前，该列表的日期过滤器也依据它衡量——列表默认显示最近 30 天，直到你扩大范围。

## 评论数

- **类型：** number，派生值
- **是否可编辑：** 否

每次读取记录时，从关联到该联系人的评论中统计得出，而不是存储在记录上。它统计的是评论，所以仅以私信形式发生的活动不会增加这个数字。

## 性别

- **类型：** fixed value
- **是否可编辑：** 否

联系人创建时设置为未知，此后保持不变。 

## 联系人如何被键控

每个人、每个平台、每个所有者各存在一条记录。由此产生三个后果：

- 一个既在你的 Facebook 主页上评论、又向你的 Instagram 账户发送消息的人，会有两条联系人记录，因为平台是键的一部分。
- 两个都与同一个人互动的账户，各自持有该人自己的记录。在一个主账户下共享，才使另一个账户的记录变得可见。
- 按社交账号 ID 查找还需要平台信息。仅凭标识符本身无法指向唯一一个联系人。

## 不存储什么

- **没有电子邮件地址、电话号码或自由文本备注。** 上面列出的字段就是记录的全部。
- **没有你自己创建的联系人。** 没有新建联系人操作，也没有导入功能；记录只会在有人与已连接主页互动后出现。
- **没有只发送过私信的人的记录。** 联系人是从一条传入评论创建的。 
- **没有消息历史。** 评论数是记录本身携带的唯一活动数据。

## 这些字段驱动的过滤器

| 联系人列表上的过滤器 | 读取的字段 | 说明 |
|---|---|---|
| 平台 | 平台 | Facebook、Instagram，或所有平台 |
| 标签 | 标签 | 一次一个标签 |
| 日期范围 | 最后活跃 | 向前若干天，或全部时间；默认 30 天 |
| 搜索 | 姓名 | 匹配姓名的一部分，不搜索标签 |

该列表按最后活跃排序，最新的在前，默认每页返回 20 个联系人。

## 相关

- [管理联系人](/zh-cn/guides/contacts) — 筛选、搜索和删除这些字段所描述的记录。
- [节点类型](/zh-cn/reference/node-types) — 写入标签字段的 `add_tag` 和 `remove_tag` 节点。
- [关键词匹配规则](/zh-cn/reference/keyword-matching) — 条件如何决定哪些人到达标签节点。
- [将评论路由到私信](/zh-cn/guides/route-comments-to-dm) — 构建这些记录所来自的评论触发活动。
- [测试和调试活动](/zh-cn/guides/test-and-debug-campaigns) — 一次测试执行不会触碰联系人的标签。