连接并使用 HubSpot 数据同步

借助HubSpot 数据同步功能，您可在 HubSpot 与其他应用之间建立单向或双向同步，将所有客户数据整合到一个平台。查看哪些应用支持数据同步。

了解数据同步的工作原理，以及如何连接应用、开启数据同步、重新同步记录等操作。

数据同步工作原理

激活同步后，系统会为对象中的所有记录创建内部索引。随后通过该索引对比监控记录变更，根据属性更新状态（同步中、失败或被排除）动态调整记录状态。这意味着内部数据同步索引会持续比对数据库（HubSpot或关联应用），并能恢复任何丢失或出错的API调用或端点。

记录更新时，同步引擎会将完整记录与本地副本进行比对，并更新副本以匹配实际记录。此机制可补救任何遗漏或失败的更新。数据同步初始化时可能需要时间完成所有记录索引，但能确保更流畅、更健康的同步体验。 

同步原理

数据同步始终发生在两个应用之间，其中之一必为HubSpot。每次同步包含两个主要阶段，与同步对象无关：

• 初始同步： 在激活同步或保存时启动 。两端应用的所有现有记录均通过同步引擎进行索引，并根据需要同步。
• 增量同步：当所有记录完成索引后，系统将扫描更新内容及新增记录。自上次检查以来发生变更的索引记录将通过同步引擎处理。

初始同步

双向同步的初始同步包含：

• 索引HubSpot：扫描HubSpot记录，存储记录ID及其匹配标识符（默认联系人使用邮箱，企业使用名称或域名）。此索引将在后续整个同步过程中保持更新。了解匹配机制详情。 
• 索引另一应用并同步：扫描并同步另一应用的记录。每次获取资源时，系统会检查HubSpot索引表中是否存在匹配标识符（如联系人的电子邮件地址）。若存在匹配项，则将记录配对并共同传递至同步引擎；若无匹配项，该记录将单独通过同步引擎处理。 当同步引擎匹配记录时，会整合所有信息（包括记录字段值、筛选条件、字段映射、同步历史记录等），据此生成后续操作（请求资源变更、保持原状、记录错误等）。

请注意：应用程序API返回的首条记录可同步，后续记录将被视为重复项。

• 同步HubSpot：系统将重新扫描HubSpot记录以确认同步需求。此步骤仅同步HubSpot中的现有记录，不会影响其他应用程序。

增量同步

增量同步会持续扫描 HubSpot 与另一应用（基于同步方向）的更新内容，并等待触发。HubSpot 每五分钟检查一次变更情况。另一应用或其 API 通过 webhook 机制通知任何变更。

连接应用

搜索并连接应用有两种方式：通过应用市场或导入页面操作。 

1. 在 HubSpot 帐户中，单击顶部导航栏中的“商城”图标 marketplace，然后选择 HubSpot 商城。
2. 在搜索栏输入应用名称，点击搜索结果。 
3. 点击安装。
4. 在对话框中点击"下一步"，然后登录您的应用账户。
5. 查看所需访问权限，点击允许。系统将跳转回HubSpot设置中的应用页面。

若从导入页面设置同步：

1. 点击任意对象主页右上角的导入按钮，或访问您的导入设置：

• • 在 HubSpot 帐户中，单击顶部导航栏中的 settings“设置”图标。
  • 在左侧边栏菜单中导航至"导入与导出"。
  • 点击“开始导入”。

2. 点击连接应用。 

3. 在对话框中输入应用名称，然后点击搜索结果。 
4. 点击安装。 
5. 您将被重定向至应用列表页面，继续执行连接步骤。 

同一第三方应用可连接多个实例至HubSpot。例如，若您管理两个Microsoft Dynamics账户，可通过单个HubSpot账户连接并同步两个账户的数据。连接额外账户操作如下：

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击应用名称。 
3. 在右上角点击账户 操作 >管理账户。 
4. 在右侧面板中点击连接另一个账户。 
5. 按照步骤将应用连接至HubSpot。 

开启数据同步

连接应用后，您需要配置应用设置并开启同步功能，才能开始在两个集成之间同步数据。 

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击应用程序。
3. 点击设置同步。
4. 在"选择要同步的数据"页面，选择应用程序中要同步的目标对象，以及HubSpot中要同步的目标对象。
5. 点击箭头下拉 菜单，选择应用与HubSpot之间采用双向同步还是单向同步（或反之）。 

配置同步方向

在配置界面选择同步方向，并将第三方应用字段映射至HubSpot属性。

在"选择同步方向"区域，决定数据从HubSpot同步至第三方应用或反向同步的模式。共有三种选项： 

• 应用间双向同步：所有新增及更新的对象信息将在两个应用间同步。若记录在两个平台均存在，属性将被合并。 
• 仅向HubSpot同步数据：数据仅从第三方应用同步至HubSpot。
• 数据仅同步至第三方应用：数据仅从HubSpot同步至第三方应用。 

若所连接的第三方应用支持事件同步，您可将邮件打开、点击等受支持事件从第三方应用同步至HubSpot。

启用事件同步前请注意： 

• 事件同步为单向传输，即从第三方应用同步至HubSpot。
• 事件同步仅同步与联系人记录关联的事件。
• 若联系人记录同步失败，其关联事件仍可同步至HubSpot。
• 仅当事件关联的联系人已存在于HubSpot时才会同步。

启用事件同步时，请勾选复选框"将[您的第三方应用] 事件 单向 同步至HubSpot"。 

在" 解决数据冲突"部分，点击下拉菜单选择 默认应用——当数据存在差异时，该应用将覆盖其他应用的数据。若默认应用中某字段无值，则第三方应用中的数据不会被修改。此设置不会覆盖" 选择同步方向"部分所选的同步方向。

检查字段映射

在“映射字段”部分，请核对默认属性映射关系以及HubSpot与第三方应用间的信息同步方式。若您拥有付费版 数据枢纽 订阅，可为属性设置自定义映射。若未订阅付费版 数据枢纽 订阅，请点击“试用自定义映射”测试该功能。 

必填字段将在字段映射表中以星号（*）标注。 

要关闭映射，请点击切换按钮将其关闭。 

设置自定义字段映射：

1. 点击添加映射。 
2. 通过下拉菜单选择需映射的第三方应用及HubSpot属性。
3. 点击成功 更新。

4. 要关闭自定义映射，请点击开关将其关闭。 

了解有关数据同步字段映射的具体规则和注意事项。

设置同步规则

在限制屏幕上，配置您希望如何将记录从 HubSpot 同步到第三方应用程序，反之亦然。

若配置交易同步，系统将提示您映射HubSpot与第三方应用间的交易管道及阶段。仅映射阶段内的交易将同步。 

1. 在“映射交易管道和阶段”部分，点击“选择HubSpot管道”下拉菜单，选择要与第三方应用同步的HubSpot交易管道。
2. 点击“自动映射”可自动将HubSpot交易阶段与第三方应用的交易阶段进行匹配。该同步功能通过简单文本搜索尝试匹配发音相似的阶段。
3. 若需映射其他销售管道，请点击映射其他销售管道。

若您无法在HubSpot中查看其他应用的交易阶段，可能由以下原因导致：

• 关联用户账户缺乏查看交易阶段的权限。
• 数据同步功能将HubSpot交易阶段映射至其他应用的销售管道阶段。若您的销售流程采用非标准模式且不依赖交易/商机阶段，则无法通过HubSpot数据同步实现数据同步。

若配置联系人同步，默认情况下HubSpot仅同步具有有效电子邮件地址的联系人。如需同步无邮箱地址的联系人，请在"重复记录减少"部分取消勾选"仅同步带邮箱地址的联系人"复选框。

了解更多记录匹配规则。

请注意：当应用同时包含公司名称和公司域名字段时，若两条记录公司名称相同但域名不同（或反之），HubSpot将自动匹配对应记录。

在"筛选器"部分，可设置条件限制从HubSpot同步至第三方应用（或反向同步）的记录范围：

1. 点击编辑。
2. 在右侧面板中，选择用于限制从 HubSpot 同步至第三方应用（反之亦然）的属性。
3. 点击完成。 

请注意： 筛选器部分仅限制初始同步的记录范围。记录同步后，将根据属性映射设置持续进行双向数据同步。

关联

记录 HubSpot在与原始连接应用同步时，将尽可能保持记录间的关联关系（例如联系人关联的公司，或交易关联的公司）。了解数据同步中的关联映射详情。

请注意：多数情况下，数据同步仅能自动将发票关联至联系人。发票必须手动关联至HubSpot中的公司记录。 

审核规则并启动同步

在审核界面 确认配置规则后，点击"保存并同步"。初始同步将随即开始处理。

初始同步完成后，记录变更将在10分钟内同步更新。

重新同步已删除

记录 若在HubSpot或第三方应用中删除记录，可通过以下方式重新同步以在任一平台重建：

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击应用程序。
3. 导航至CRM同步选项卡。 
4. 在对象视图选项卡的失败列中，点击未同步的记录数量。 
5. 在右侧面板中点击操作。
6. 选择“在 HubSpot 中重新同步已删除记录”或“在 [第三方应用] 中重新同步已删除记录”。
7. 点击“重新同步全部”。 

您还可以：

1. 在记录视图选项卡中，点击更多 >恢复所有已删除记录。 
2. 在侧边面板中，点击“记录类型”下拉菜单选择记录类型，并通过“目标应用”下拉菜单选择需重建联系人的应用。 
3. 点击“恢复前审核”。 
4. 核对所有待恢复记录，点击“恢复全部[数量]条”。 

关闭数据同步功能关闭

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击应用程序。
3. 导航至CRM 同步选项卡。 
4. 将鼠标悬停在[对象] 同步上，点击“更多”下拉菜单，选择“关闭同步”。 
5. 在弹出框中点击关闭同步。

关闭同步后，可通过点击编辑同步设置重新启用，或直接删除该同步。

查看同步状态

连接应用后，可查看HubSpot与第三方应用间同步记录的概览。 

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击应用程序。
3. 导航至CRM 同步选项卡。 
4. 点击对象视图，按对象查看同步状态。

• • 初始同步过程中处理的记录旁会显示旋转圆圈。
  • 当存在其他同步任务时，记录状态将显示为"队列中"，以防止同一数据在同一时间被重复更新。
  • 将鼠标悬停在每个对象的同步状态上，可查看其同步进度详情。同步状态追踪器显示集成当前的同步阶段，例如扫描中、同步中、已同步及监听变更等状态。 

5. 在"同步中"列中，点击 记录数量 可查看所有在HubSpot与应用间同步的记录。
6. 在“失败”列中，点击记录数可查看所有同步失败的记录。 

• • 在"同步活动"列中，点击错误项旁的右箭头 图标，可查看同步失败的详细原因。
  • 点击人工智能图标（artificialIntelligenceIcon） 中的"故障排除"，将打开Breeze助手并获取指导及故障排除步骤，以解决记录的同步错误。 

7. 在"已排除"列中，点击记录数可查看所有被排除在同步之外的记录。这可能是因为它们不符合同步设置中的任何筛选条件，或未被分配唯一标识符（可能因定义了匹配键所致）。 

从数据同步应用导出记录

要从数据同步应用导出记录：

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 点击应用程序。
3. 导航至CRM 同步选项卡。 
4. 在“同步中”、“失败”或“已排除”列中，点击目标对象旁的数字 。
5. 在右上角点击“更多”，然后选择“导出”。
6. 点击文件格式下拉菜单并选择格式。
7. 点击“导出”。导出处理完成后，您将通过电子邮件和通知中心收到下载链接。