摘要
本指南将介绍如何在 Astra 中配置 HubSpot 的“创建或更新联系人”操作。设置后，此操作将根据客户对话自动在 HubSpot 中创建或更新联系人记录，帮助您保持 CRM 数据准确和最新。
操作的工作原理
当此操作运行时：
Astra 会使用客户的电子邮件在 HubSpot 中查找“联系人”
如果联系人存在，它将根据您的配置更新记录
如果联系人不存在，它可以创建新的联系人（取决于您的设置）
这样可以确保您的联系人数据在无需手动操作的情况下保持同步。
说明
请按照以下步骤配置操作：
步骤 1：打开 HubSpot 创建或更新联系人模板
登录您的 Astra 账户
转到“操作库”
选择“HubSpot — 创建或更新联系人”
打开“配置”步骤
步骤 2：设置操作意图
您的操作
输入清晰的“操作名称”和“意图”
随时单击“编辑操作意图”进行更新
结果
清晰定义的意图有助于座席决定何时触发此操作
离线同步
保持此选项“关闭”以在对话期间运行操作
将其“打开”以在对话结束后运行操作
步骤 3：选择您的 HubSpot 账户
您的操作
选择一个现有的 HubSpot 账户
或者单击“添加账户”来连接一个新账户
结果
通过此操作创建或更新的所有数据都将保存在所选账户中
步骤 4：配置联系人创建和更新
允许创建和更新新联系人
开启时：
如果不存在该电子邮件的联系人，则创建新联系人
完全更新通过 Astra 创建的联系人
关闭时：
不创建新联系人
允许更新现有字段
开启时：
更新 HubSpot 中已有的联系人的已映射字段（即使不是通过 Astra 创建的）
关闭时：
不更新现有联系人属性
仅将摘要更新作为备注添加（如果已配置）
步骤 5：映射字段（HubSpot → Astra）
字段映射定义了数据如何从 Astra 流入 HubSpot。
您的操作
对于每一行：
选择一个 HubSpot 联系人属性（左侧）
将其与 Astra 字段匹配（右侧）
结果
当操作运行时，Astra 会将映射的数据写入相应的 HubSpot 联系人属性
必填字段
您必须映射以下字段：
email
操作在没有此字段的情况下将无法运行。
添加更多字段
单击“映射字段”以添加其他映射
您可以映射：
标准属性（电子邮件、电话、姓名等）
您 HubSpot 账户中的自定义属性
注意：只有支持的字段和可编辑的自定义属性（文本类）可用于映射。
创建新的 Astra 字段
您可以在映射时创建新的 Astra 字段。
这些字段将：
在座席配置中可用
以联系人属性的形式显示以供选择
使用摘要字段
如果提供了摘要：
Astra 会在联系人上创建或更新一个包含对话摘要的“备注”
如果您还将 HubSpot 属性映射到“摘要”：
相同的摘要将写入该联系人属性
仍会创建一个备注并链接到联系人
操作运行时会发生什么
以下是端到端的行为：
Astra 使用映射的电子邮件查找“联系人”
如果未找到联系人：
仅当您的设置允许时，才会创建新联系人
如果联系人存在：
联系人将根据您的配置进行更新
如果限制了完整更新：
可能只会添加或更新摘要备注
附加功能：离线同步
离线同步允许操作在对话结束后运行，而不是在对话期间运行。
启用时
操作将在对话完成后运行一次
对话结束条件
文本座席：上次消息发送后 10 分钟
语音座席：通话结束时
当您希望捕获最终确定的信息而不是实时更新数据时，此功能非常有用。
下一步做什么
配置完成后，您的操作将自动：
捕获对话中的客户详细信息
在 HubSpot 中创建或更新联系人
无需手动操作即可保持 CRM 数据最新
您现在可以将此操作用作 Astra 中自动化工作流的一部分。