HubSpot 与 Salesforce 的集成可能会遇到同步错误，导致数据无法同步。您可以在 Salesforce 集成设置中识别并解决这些同步错误。
调整 API 调用限制
- 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
- 在已连接的应用列表中，点击Salesforce。
- 转到“数据同步”选项卡。
- 在“同步状态”选项卡的“API调用使用情况”部分，查看过去24小时内已使用的API调用次数。“Salesforce限制”数值即根据您的Salesforce设置可进行的API调用次数。若要调整分配给HubSpot的调用次数，请编辑“分配给HubSpot”字段。
查看 Salesforce 同步错误
- 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
- 在已连接的应用程序列表中，点击“Salesforce”。
- 转到“数据同步”选项卡。
- 在“同步 状态”选项卡的“同步错误 ”部分，查看每种错误类型的卡片，其中显示当前错误数量及受影响的记录。点击某类错误的卡片，可在右侧面板中查看错误详情。了解每种错误类型的详细信息及解决建议。
- 要查看某个错误的更多详细信息，请点击“错误类型”列 中的信息图标 。
- 若要针对单个记录采取操作，请点击“受影响记录 ”列中的 [#] 条记录 ，然后点击“操作”>“创建 HubSpot 记录的临时视图”，以 生成受影响记录的筛选视图。
- 解决错误后，请返回错误列表。选中已解决错误左侧的复选框，然后点击“重新同步”。
- 若要导出错误，请点击错误列表左上角的“导出错误（CSV） ”。
Salesforce 同步错误类型
关联
关联错误示例
错误含义
记录无法同步，是因为它们关联的 Salesforce 账户尚未同步到 HubSpot 公司，或者因为它们关联的记录已达到 HubSpot 的记录关联限制。
当 HubSpot 中与多个联系人关联的活动尝试同步到 Salesforce 时，会发生“关联基数不匹配”错误。该集成仅支持每个活动同步一个联系人关联。
如何解决这些错误
要解决“关联限制已达上限”错误，您可以删除部分关联记录，或将其关联到另一个 Salesforce 记录，然后继续同步。
要解决“等待账户同步”错误 ，建议您导入 Salesforce账户。
要解决“关联基数不匹配”错误，请移除多余的联系人关联，确保仅有一个联系人与该活动相关联。
自定义代码
自定义代码错误示例
- Salesforce 自动化
- 缺少联系人 ID
- Salesforce 自定义字段验证规则
- Salesforce 流程
这些错误的含义
由于您的 Salesforce 账户中的自动化、流程或验证规则导致的问题，记录无法同步。
如何解决这些错误
由于这些错误源于 Salesforce，建议您与 Salesforce 管理员合作，在 Salesforce 的自定义代码中解决此问题。
重复记录
重复记录错误示例
- 该电子邮件地址已被使用
- Salesforce 重复规则
错误含义
由于该电子邮件地址已在 HubSpot 联系人记录中存在，或者由于Salesforce 中的去重规则，Salesforce 潜在客户或联系人无法同步到 HubSpot。
如何解决这些错误
要解决“该电子邮件地址已被使用”错误，请从现有的 HubSpot 联系人记录中删除该电子邮件地址。
要解决Salesforce 重复规则错误 ，建议由 Salesforce 管理员检查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 任务字段错误，请将 Salesforce 中的“任务优先级”、“状态”或“类型”值与 HubSpot 中的相应任务属性选项进行对比。“任务优先级”仅支持“高”、“中”、“低”和“无”。对于“状态”和“类型”，请将 Salesforce 中的值更新为与 HubSpot 中可用选项完全一致，或在 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 中“州”属性选项的内部值必须与 Salesforce 中现有的“州”选项相匹配。
要解决“值无效”错误，建议您更新 Salesforce 记录中的属性值，使其符合 HubSpot 对该属性值的要求。
在大多数情况下，“所有者分配”错误 发生在 HubSpot 活动作为 Salesforce 任务同步到 Salesforce 时，而 HubSpot 试图将该任务分配给 Salesforce 队列的所有者。
要解决“受限唯一值”错误，建议您检查在 Salesforce 中设置的去重匹配规则。
要解决“缺少必填值”错误，请为 Salesforce 记录中任何在 HubSpot 中被标记为必填的属性添加值。
其他/未知
其他/未知错误示例
- 发生未知 Salesforce 重复错误：指定的 ID 已存在。
错误含义
如果您创建的字段映射包含默认的 Salesforce ID 字段（例如“潜在客户 ID”或“联系人 ID”），并将该字段映射到 HubSpot 中的相应“Salesforce 潜在客户 ID”或“Salesforce 联系人 ID”属性，则可能会出现此错误。
如何解决此错误
这些 ID 值由集成自动管理，不应包含在自定义字段映射中。创建此类映射可能会导致同步行为出现异常，尤其是在同步规则设置为双向同步时。
对于其他未知错误，请联系 HubSpot 支持团队以获取进一步帮助。
请注意：每次最多可批量重新同步 100 个 Salesforce 错误。若需同步超过 100 个错误，请从 Salesforce导入记录或更新已映射的属性。
设置同步错误通知
- 在 HubSpot 帐户中，单击顶部导航栏中的设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。
- 在已连接的应用程序列表中，点击Salesforce。
- 转到“数据同步”选项卡。
- 在“同步状态”选项卡的“同步错误”部分 ，点击“管理通知”。
- 在对话框中，将“开启通知”开关切换为“开”。
- 选择“即时”、“每日”或“每周”旁边的单选按钮，以设置通知频率。
- 点击“保存”。
.svg?height=99&width=353)