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

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

调整API调用限制

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 在已连接的应用列表中，点击Salesforce。
3. 导航至"同步状态"选项卡。
4. 在"API调用使用情况"区域查看 过去24小时内的API调用次数。"Salesforce限制值"即基于您Salesforce设置可执行的API调用次数上限。若需调整分配给HubSpot的调用配额，请编辑"分配给HubSpot"字段。

查看 Salesforce 同步错误

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 在已连接的应用列表中，点击Salesforce。
3. 导航至“同步状态”选项卡。
4. 在"同步错误"下，查看各类错误的卡片，其中包含当前错误数量和受影响记录数。点击某类错误卡片，可在右侧面板查看详细信息。了解各类错误的具体说明及解决建议。

5. 要查看错误的更多详情，请点击错误类型列中的 info 信息图标 。
6. 要对单条记录采取操作，请点击"受影响记录" 列中的[#]条记录 ，然后点击操作>创建 HubSpot 记录临时视图，生成 受影响记录的筛选视图。
7. 解决错误后，请返回错误列表。勾选已解决错误左侧的复选框，点击重新同步。
8. 要导出错误，请点击错误列表左上角的"导出错误（CSV） "。

Salesforce同步错误类型

关联错误

关联错误示例

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

错误含义说明

记录无法同步的原因是：它们关联的 Salesforce 账户尚未同步至 HubSpot 公司，或关联的记录已达到 HubSpot 的记录关联上限。

错误解决方法

要解决关联限制已达错误 ，可移除部分关联记录或将其关联至其他 Salesforce 记录，然后继续执行同步。

若要解决"等待账户同步"错误， 建议您运行Salesforce账户导入操作。

自定义代码

自定义代码错误示例

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

错误含义说明

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

错误解决方法

重复记录

重复记录错误示例

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

错误含义

Salesforce 潜在客户或联系人无法同步至 HubSpot，因为该电子邮件地址已在 HubSpot 联系人记录中存在，或受Salesforce 中的去重规则限制。

错误解决方法

要解决"电子邮件已被使用"错误，请从现有HubSpot联系人中移除该电子邮件地址。

若要解决Salesforce 重复规则错误 ，建议 检查Salesforce 中设置的去重匹配规则。

权限

权限错误示例

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

错误含义

由于关联用户在 Salesforce 中无权访问必要字段或对象，HubSpot 中所做的更改无法同步至 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用户在系统中将用户类型设置为标准用户、高级合作伙伴或访客。

解决选项限制超出错误时，建议删除团队未使用的HubSpot和Salesforce中多余的属性选项。同时确保所有映射属性均对应正确字段类型。

大多数情况下，"默认销售流程不可用"错误 发生于 Salesforce 机会尝试同步至 HubSpot 时缺少记录类型。若您已在 Salesforce 中启用记录类型但未使用，或存在无记录类型的 Salesforce 机会，建议您与 Salesforce 协作停用所有记录类型或创建新记录类型。

为解决"商机阶段缺失或无效"错误，请确保 Salesforce 的商机阶段值在 HubSpot 销售管道中存在。

属性映射

属性映射错误示例

• 类型不匹配
• 缺少 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 中State属性选项的内部值必须与 Salesforce 中现有的State选项匹配。

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

大多数情况下，当HubSpot活动同步至Salesforce作为任务时，若HubSpot尝试将该任务分配给Salesforce队列所有者，就会引发"所有者分配错误 "。

为解决“受限唯一值”错误，建议检查您在 Salesforce 中设置的去重匹配规则。

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

其他

记录因未知错误未同步。请联系 HubSpot 支持团队获取进一步协助。

请注意：每次最多可批量重新同步100个Salesforce错误。若需同步超过100个错误，请从Salesforce导入记录或更新已映射的属性。

设置同步错误通知

1. 在 HubSpot 帐户中，单击顶部导航栏中的settings设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
2. 在已连接的应用列表中，点击Salesforce。
3. 导航至"同步健康状况"选项卡。
4. 在"同步错误"下，点击"管理通知"。
5. 在对话框中，开启"启用通知"开关。
6. 选择“即时”、“每日”或“每周”旁的单选按钮以设置通知频率。
7. 点击保存。