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

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

上次更新时间: 2025年5月27日

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

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

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 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 中国家属性选项的内部值必须与 Salesforce 中现有的国家选项相匹配。

要解决选项不匹配错误,建议更新 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 试图将现有Salesforce ID以外的值同步到 Salesforce 中的引用/查找字段时,就会出现缺少 Salesforce ID 的错误。

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

财产价值

属性值错误示例

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

错误的含义

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

如何解决错误

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

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

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

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

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

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

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

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

其他

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

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

设置同步错误通知

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

sync-health-error-notifications

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