跳到内容

管理 Salesforce 集成 API 调用和同步错误

上次更新时间: 二月 12, 2025

除非另有说明,否则适用于以下任何订阅

营销 Hub   Professional , Enterprise
销售 Hub   Professional , Enterprise
Service Hub   Professional , Enterprise
Operations Hub   Professional , Enterprise
内容 Hub   Professional , Enterprise

HubSpot-Salesforce集成可能会遇到同步错误,导致数据无法同步。你可以在 Salesforce 集成设置中识别并解决这些同步错误。

调整 API 调用限制

  • 在 HubSpot 帐户中,导航到数据管理 > 集成
  • 在连接的应用程序列表中,单击Salesforce
  • 单击 "同步健康状况"选项卡。
  • 在 "API 调用使用 "部分,你会看到过去 24 小时内使用的 API 调用次数。受 Salesforce 限制的数字是根据 Salesforce 设置可以进行的 API 调用次数。要调整这些调用中有多少可以分配给 HubSpot,请编辑 "分配给 HubSpot"字段。

解决同步错误

  • 在 HubSpot 帐户中,导航到数据管理 > 集成
  • 在连接的应用程序列表中,单击Salesforce
  • 单击 "同步健康状况"选项卡。
  • "同步错误 "下,你会看到每种错误类型的卡片,以及当前错误的数量和每种错误的受影响记录。单击错误类型卡,在右侧面板中查看错误的详细信息。有关每种错误类型的详细信息和解决步骤,请参阅下文。

关联

记录不同步是因为它们与尚未同步到 HubSpot 的记录相关联,或者是因为它们与已达到 HubSpot 记录关联限制的记录相关联。在 "受影响的记录"列中,你会发现所有由于与左侧 "记录"列中的记录关联而导致同步失败的记录。

  • 要查看错误的详细信息和解决步骤,请单击错误类型 列中的信息图标 info
  • 要对单个记录采取行动,请单击 "受影响记录"列中的 [#] 记录 ,然后单击 "创建视图 "创建受影响记录的筛选视图。
  • 解决错误后,返回关联错误列表。选择任何已解决的错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击右上角的导出错误

自定义代码

由于 Salesforce 账户中的自动化、流程或验证规则引起的问题,导致记录无法同步。有关错误原因的信息将显示在错误详细信息列中。

  • 要查看错误的详细信息和解决步骤,请单击错误类型 列中 信息图标 info
  • 根据错误的详细信息,您可能需要更新受影响的记录或更改 Salesforce 设置。要对 HubSpot 中的单个记录采取行动,请单击受影响记录列中的 [#] 记录 ,然后单击创建视图以创建受影响记录的过滤视图。
  • 解决错误后,返回自定义代码错误列表。选择任何已解决错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击右上角的导出错误

重复

由于已经存在重复的记录或值,因此无法创建记录。您将看到受错误影响的 HubSpot 和 Salesforce 记录以及重复值。

  • 要查看错误的详细信息和解决步骤,请单击错误类型 列中 信息图标 info
  • 单击 "查看记录"栏中的HubSpotSalesforce,访问记录并进行更改。
  • 解决错误后,返回 "重复错误 "列表。选择任何已解决的错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击右上角的导出错误

权限

在 HubSpot 中进行的更改无法同步到 Salesforce,因为连接的用户没有访问 Salesforce 中必要字段或对象的权限。

  • 要查看错误的具体细节和解决步骤,请单击错误类型 列中 信息图标 info
  • 查看并更新 Salesforce 设置中已连接用户的权限。
  • 解决错误后,返回权限错误列表。选择任何已解决错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击右上角的导出错误

选取列表

由于 HubSpot 和 Salesforce 中的选取列表字段值不一致,导致记录无法同步。如果一个系统中的选取列表值与另一个系统中的任何当前值不匹配,如果选取列表已达到值限制,或者如果传递的值无效,就会出现这种情况。您将看到导致错误的 HubSpot 属性和 Salesforce 字段,以及每个错误的受影响记录数。

  • 要查看错误的详细信息和解决步骤,请单击错误类型 列中 信息图标 info
  • 根据错误的详细信息,您可能需要更新受影响记录的值或更改属性或字段。要对 HubSpot 中的单个记录采取行动,请单击 "受影响记录"列中的 [#] 记录 ,然后单击 "创建视图"以创建受影响记录的过滤视图。
  • 解决错误后,返回Picklists 错误列表。选择任何已解决错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击右上角的导出错误

属性映射

记录不同步是因为 HubSpot 属性和 Salesforce 字段之间的映射不一致。这可能意味着属性和字段类型不兼容,属性或字段已不存在,或者需要创建 Salesforce 引用字段映射。

  • 要查看错误的详细信息和解决步骤,请单击错误类型 列中 信息图标 info
  • 更新属性映射
  • 解决错误后,返回属性映射错误列表。选择任何已解决错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击右上角的导出错误

属性值

记录无法在 HubSpot 和 Salesforce 之间同步是因为其中包含的属性值无效。这些错误通常需要更新个别受影响的记录来纠正错误。

  • 要查看更多信息和解决步骤,请单击错误类型列中信息图标 info
  • 更新 HubSpot 或 Salesforce 中记录的无效值。要查看 HubSpot 中受影响记录的列表,请单击 "受影响记录"列中的 [#] 记录 ,然后单击 "创建视图 "创建过滤视图。
  • 解决错误后,返回属性值错误列表。选择已解决错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击右上角的导出错误

其他

由于未知错误,记录无法同步。请联系 HubSpot 支持以获得有关这些错误的进一步帮助。

请注意: 一次可以批量重新同步 100 个 Salesforce 错误。要同步 100 条以上的错误,请从 Salesforce导入记录更新映射属性

设置同步错误通知

  • 在 HubSpot 帐户中,导航到数据管理 > 集成
  • 在已连接应用程序列表中,单击Salesforce
  • 单击 "同步健康状况"选项卡。
  • "同步错误"下,单击 "管理通知"。
  • 在对话框中,单击打开通知开关。
  • 选择 "即时"、"每日"或 "每周"旁边的单选按钮,以设置通知的频率。
  • 单击保存

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助