跳到内容
请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。

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

上次更新时间: 2025年9月3日

可与以下任何订阅一起使用,除非另有说明:

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

调整 API 调用限制

  • 在 HubSpot 帐户中,单击顶部导航栏中的settings设置图标。在左侧栏菜单中,导航到集成 > 连接的应用程序
  • 在已连接应用程序列表中,单击Salesforce
  • 在 "同步健康状况"选项卡"API 调用使用 "部分,查看过去 24 小时内使用的 API 调用次数。受 Salesforce 限制的次数是根据 Salesforce 设置可以进行的 API 调用次数。要调整分配给 HubSpot 的调用次数,请编辑 "分配给 HubSpot"字段。

sync-health-api-call-use

查看Salesforce同步错误

  • 在 HubSpot 帐户中,单击顶部导航栏中的settings设置图标。在左侧栏菜单中,导航到集成 > 连接的应用程序
  • 在已连接应用程序列表中,单击Salesforce
  • 在 "同步健康状况"选项卡的 "同步错误"下,查看每种错误类型的卡片,以及当前错误和受影响记录的数量。单击错误类型卡片可在右侧面板中查看错误的详细信息。了解有关每种错误类型和解决建议的更多信息

sync-health-sync-errors

  • 要查看错误的更多详细信息,请单击错误类型 列中的info 信息图标
  • 要对单个记录采取行动,请单击受影响记录列中的 [#] 记录 ,然后单击操作>创建 HubSpot 记录的临时视图 ,以创建受影响记录的过滤视图。
  • 解决错误后,返回错误列表。选择已解决错误左侧的复选框,然后单击重新同步
  • 要导出错误,请单击错误列表左上角的导出错误 (CSV)
screenshot showing the button to export Salesforce sync errors in HubSpot

Salesforce 同步错误类型

关联

关联错误示例

  • 达到关联限制
  • 等待账户同步

错误的含义

记录没有同步是因为它们与尚未同步到 HubSpot 公司的 Salesforce 帐户关联,或者是因为它们与已达到 HubSpot 记录关联限制的记录关联。

如何解决错误

要解决关联限制已达 错误,你可以删除一些关联记录或将它们与不同的 Salesforce 记录关联,然后继续同步。

要解决等待账户同步 错误,建议运行Salesforce账户导入

自定义代码

自定义代码错误示例

  • Salesforce 自动化
  • 缺少联系人 ID
  • Salesforce 自定义字段验证规则
  • Salesforce 流程

错误的含义

由于 Salesforce 帐户中的自动化、流程或验证规则引起的问题,导致记录无法同步。

如何解决错误

由于这些错误源自 Salesforce,建议您与 Salesforce 管理员合作,解决 Salesforce 自定义代码中的问题。

重复

重复错误示例

  • 电子邮件已在使用中
  • Salesforce 重复规则

错误的含义

由于电子邮件地址已存在于 HubSpot 联系人记录中,或由于Salesforce 中的重复数据删除规则,Salesforce 潜在客户或联系人无法同步到 HubSpot。

如何解决错误

要解决电子邮件已在使用中的错误,请从现有的 HubSpot 联系人中删除电子邮件地址。

要解决Salesforce 重复规则 错误建议检查Salesforce 中设置的重复数据消除匹配规则

权限

权限错误示例

  • 访问权限不足或缺少 Salesforce 记录
  • Salesforce 字段权限
  • Salesforce 访问权限不足

错误的含义

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

如何解决错误

在大多数情况下,当集成试图以不正确的值更新 Salesforce 字段或创建不正确的关联时,就会发生访问权限不足或 Salesforce 记录丢失 错误。

要解决 Salesforce字段权限 错误,请 确保 Salesforce 集成用户对 Salesforce 中的字段拥有 "读取 "和 "编辑 "权限。

如果 Salesforce 集成用户因其在 Salesforce 中的用户权限而无法在 Salesforce 中执行操作,则会出现 Salesforce访问权限不足 错误。建议您检查 Salesforce 中的 Salesforce 集成用户权限。

选取列表

选取列表错误示例

  • 缺少 Salesforce 挑选列表选项
  • 状态或国家值不匹配
  • 选项不匹配
  • 不活动的 Salesforce 所有者
  • 选项列表值受限
  • 不活动的机会阶段
  • Salesforce 所有者未同步
  • 超出选项限制
  • 默认销售流程不可用
  • 机会阶段缺失或无效

错误的含义

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

如何解决错误

要解决 状态或国家值不匹配错误,建议检查是否满足以下要求:

  • HubSpot 中国家属性选项的内部值必须与 Salesforce中州和国家/地区列表设置中的现有国家选项相匹配。
  • 国家值必须作为 Salesforce 中记录的国家值的可用州/省 选项存在。此外,HubSpot 中State属性选项的内部值必须与 Salesforce 中现有的State选项相匹配。

要解决选项不匹配错误,建议更新 Salesforce 字段选项的内部/API 名称,使其与 HubSpot 中属性选项的内部值相匹配。

要解决不活跃的 Salesforce 所有者错误,请将 HubSpot 记录重新分配给 Salesforce 中的活跃用户。

当你在 Salesforce 中为字段打开了 "限制选取列表为值集设置中定义的值"时,就会出现 "限制选取列表值"错误 。当在 Salesforce 中打开该设置时,你试图从 HubSpot 同步到 Salesforce 的值必须作为选项存在于 Salesforce 挑选列表中。建议关闭 "限制选取列表为 Salesforce 中值集设置中定义的值",这样任何值都可以从 HubSpot 同步到 Salesforce。

机会阶段不活动的 Salesforce机会 试图同步到 HubSpot 时,会出现机会阶段不活动的 错误 。要解决此错误,请将 Salesforce 中的机会阶段更改为活动状态,或将机会移动到活动状态。

要解决Salesforce 所有者未同步错误,请确保 Salesforce 用户在 Salesforce 中的用户类型设置为标准Power Partner访客

要解决 "超出选项限制"错误,建议在 HubSpot 和 Salesforce 中删除团队不使用的额外属性选项。此外,确保所有映射属性都有相应的字段类型。

在大多数情况下,默认销售流程不可用 的错误发生在 Salesforce 机会尝试同步到 HubSpot 时缺少记录类型。如果您在 Salesforce 中打开了记录类型,但没有使用它们,或者 Salesforce 机会没有记录类型,建议您与 Salesforce 合作,停用所有记录类型或创建新的记录 类型

要解决缺少或无效机会阶段错误,请确保HubSpot管道中存在Salesforce机会阶段值。

属性映射

属性映射错误示例

  • 类型不匹配
  • 缺少 Salesforce ID
  • 无效的 Salesforce ID

错误的含义

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

如何解决错误

要解决类型不匹配错误,请确保 HubSpot 中的属性类型与 Salesforce 中的字段类型兼容。了解有关可同步到 Salesforce 的 HubSpot 属性字段类型的更多信息。

当HubSpot试图将现有SalesforceID以外的值同步到Salesforce中的引用/查找字段时,就会发生 "缺少Salesforce ID "错误。

要解决无效 Salesforce ID错误,建议检查在 Salesforce 中设置的自定义验证规则

属性值

属性值错误示例

  • 字符串太长
  • 电子邮件无效
  • 缺少必填国家/地区
  • 无效值
  • 所有者分配
  • 限制唯一值
  • 缺少必填值

错误的含义

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

如何解决这些错误

要解决字符串太长错误,请缩短 Salesforce 或 HubSpot 中的字段值,或增加 Salesforce 中字段的字符限制。

要解决无效电子邮件 错误,请更新试图同步到 HubSpot 的 Salesforce 记录上的电子邮件地址格式。

要解决缺少必填国家错误,建议检查是否满足以下要求:

  • HubSpot 中国家属性选项的内部值必须与 Salesforce中州和国家/地区列表设置中的现有国家选项相匹配。
  • 国家值必须作为 Salesforce 中记录的国家值的可用州/省 选项存在。此外,HubSpot 中State属性选项的内部值必须与 Salesforce 中现有的State选项相匹配。

要解决无效值错误,建议更新 Salesforce 记录上的属性值,以满足 HubSpot 对属性值的要求。

在大多数情况下,当 HubSpot 活动作为 Salesforce 任务同步到 Salesforce,并且 HubSpot 尝试将任务分配给 Salesforce 队列所有者 时,就会发生所有者分配错误。

要解决限制唯一值错误,建议检查在 Salesforce 中设置的重复数据删除匹配规则

要解决缺失必填值错误,请为在 HubSpot 中标记为必填的任何属性在 Salesforce 记录中添加值。

其他

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

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

设置同步错误通知

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

sync-health-error-notifications

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