# 使用联系人和受众

联系人和受众节点允许工作流读取客户信息并修改记录或成员资格。它们操作的是自动化所属工作区中的资源。

> Automations is in Early access. Your workspace permissions determine which actions you can perform.

## 查找和使用联系人

1. 当你已有联系人 ID 时添加 **Get contact**，当需要按支持的筛选条件搜索时添加 **List contacts**。
2. 将触发器中的标识符或搜索值映射过来。
3. 对于列表结果，添加一个 **Branch** 来区分空结果与已找到的联系人。
4. 将所选联系人的字段映射到下一步。

空的成功搜索也是一个需要处理的结果。它不会走操作的失败路径。失败路径用于被拒绝或失败的读取。

列表节点只返回一页。存在下一页游标表示可能还有更多记录。**List contacts** 和 **List audience contacts** 都不会自动访问后续页面，也不会对每个联系人执行后续操作。

## 创建或更新记录

使用 **Create contact** 创建新记录，使用 **Update contact** 更新已知记录。先查找再创建不是原子操作：在这两步之间，其他进程可能已经创建了匹配的联系人。请处理创建冲突，而不是假设新联系人已存在。

**Create or update contacts** 接受一个预先准备的批量数据。请检查每个条目的结果：一个条目可能失败，而其他条目被成功创建或更新。节点成功并不意味着每个批量条目都成功，且某个条目失败时不会回滚已成功的更改。

即使 Contacts 产品接受更大的批量，大量输入和结果也可能超出自动化数据限制。如果验证或运行报告值过大，请使用更小的预备批量。

## 管理静态受众成员资格

1. 选择一个已有的受众，或添加 **Create audience** 在工作流中创建一个。
2. 使用 **Add contacts to audience**、**Remove contact from audience** 或 **Remove contacts from audience**，并提供明确的联系人 ID。
3. 检查操作结果，在继续之前处理失败情况。

移除成员资格不会删除联系人。添加到一个受众和从另一个受众移除是两个独立操作，因此两者之间的失败可能导致联系人同时存在于两个受众中。请为需要关注的状态规划失败路径。

使用 **Get audience** 和 **Update audience** 来读取或修改受众本身。这些节点不会生成其成员的快照，也不会将工作流变为群发。

## 主动删除联系人

使用 **Delete contact** 永久移除联系人及其受众成员资格。

与该联系人渠道地址关联的偏好和抑制记录可能会保留。删除并重新创建联系人不会移除退订或投递阻止。

## 后续步骤

- [使用偏好和查找](/docs/guides/automations/preferences-and-lookups)。
- [使用先前步骤中的数据](/docs/guides/automations/data)。
- [预览和检查工作流](/docs/guides/automations/preview)。
- [浏览 Automations 指南](/docs/guides/automations)。

## Related resources

- [Preview your first automation](/docs/get-started/automations) (docs)