解决 Salesforce 集成暂停错误
上次更新时间: 2026年8月27日
当 HubSpot 与 Salesforce 的集成 被暂停时,两个系统之间的记录可能停止同步。请查看暂停错误以确定原因,然后按照建议的步骤恢复同步。您可以选择在 HubSpot 与 Salesforce 的集成被暂停时接收电子邮件通知。
超过 Salesforce 组织 API 限制
您的 Salesforce 组织中的API 调用限制已被超过。建议您在 HubSpot 中设置 Salesforce API 调用配额,以防止超过 Salesforce API 调用限制。如果您正在进行数据迁移,可以联系 Salesforce 支持团队,申请临时提高您的 API 调用限制。
当 API 调用限额被超过时,Salesforce 将停止接受额外的 API 请求。这可能会影响 HubSpot 与 Salesforce 之间的同步和记录更新。 集成可能仍显示为已连接,但 HubSpot 可能无法检索 Salesforce 数据。这可能会导致 Salesforce 字段无法加载、影响字段映射、引发工作流或同步错误、导致已同步的联系人及潜在客户中缺少或存在过时的 Salesforce 营销活动成员数据,或者无法创建潜在客户等记录。
通常,当 API 限制重置或有额外的 API 配额可用时,同步会自动恢复。
Salesforce 组织 API 访问已禁用
请确保集成用户拥有“API 已启用”用户 配置文件管理权限,然后重新输入 Salesforce 用户凭据以清除暂停提示。
未知错误
Salesforce 发回的错误信息不明确或未知。此类暂停情况较为罕见,通常会自动解决。但如果点击“清除暂停”后错误仍然存在,请联系 HubSpot 支持团队。
缺少 Salesforce 对象权限
此错误的两个最常见原因如下:
- 集成用户在 Salesforce 中未拥有“HubSpot 集成”权限集(位于“可用权限集”部分)。
- 尝试同步的对象之一在 Salesforce 中没有正确的权限。
- 请确保集成用户对尝试同步的对象拥有“读取”和“编辑”权限 。
- 如果集成用户已拥有“读取”和“编辑”权限,则该错误可能涉及关联对象。请确保集成用户对所有相关对象(例如通过查找字段关联的对象)都拥有“读取”和“编辑”权限。该集成通常需要访问以下对象:
- 潜在客户
- 联系人
- 客户
- 商机
- 营销活动
- 任务
- 用户
Salesforce 字段权限缺失
集成用户对同步对象上的某个字段,或通过查找关联的对象上的某个字段,不具备“读取”和“编辑”权限。
Salesforce 组织已被锁定
当必须先完成某项操作才能进行后续更新时,会发生临时错误。例如,当 HubSpot 正在更新某个对象时,可能有另一个集成也在同时更新该对象。如果点击“清除暂停”后错误仍然存在,请联系您的 Salesforce 系统管理员以解锁该组织。
Salesforce 组织存储限制已超出
您的 Salesforce 组织已超出存储限制。了解如何从 Salesforce 中批量删除 HubSpot 记录。
Salesforce 组织不可用
Salesforce 目前正在经历服务中断。请查看Salesforce 状态页面,了解有关服务可用性和性能的最新信息。
Salesforce.com 服务器错误
Salesforce 返回了一个未知错误。如果点击“清除暂停”后错误仍然存在,请查看Salesforce 状态或联系 Salesforce 支持团队。
HubSpot API 调用次数超限
HubSpot 中设置的 API 调用配额已被超过。请检查您的Salesforce API 调用配额,并相应地在 HubSpot 中提高 API 调用限额。一旦有更多的可用 API 调用配额,暂停状态将自动解除。
Salesforce 同步界面中显示的 API 使用情况基于滚动 24 小时周期。API 限制适用于最近的 24 小时周期。
缺少字段映射
HubSpot 属性与 Salesforce 字段之间没有映射关系。如果点击“清除暂停”后错误仍然存在,或者您的集成设置中没有标准字段映射,请联系 HubSpot 支持团队。