使用联系人和受众

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

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

查找和使用联系人

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

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

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

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

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

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

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

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

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

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