上次更新时间： 2026年6月18日
将 HubSpot 与 Salesforce 连接，以在您的营销、销售和客户服务团队之间同步数据。HubSpot 与 Salesforce 的集成可让联系人、公司、商机、活动及其他受支持的数据在两个平台之间同步，帮助团队在不同系统中使用一致的信息开展工作。
通过连接 HubSpot 和 Salesforce，您可以减少手动数据录入，保持客户记录的一致性，并支持潜在客户交接、活动跟踪和报告等流程。例如，当一个平台中的联系人信息发生更新时，该变更会根据您的集成设置同步到另一个平台。
如果您正在迁移到新的 Salesforce 生产组织，请了解如何连接新的生产组织。
- HubSpot 与 Salesforce 的集成不受 Salesforce 平台 API 旧版本停用影响。
- HubSpot 在 Salesforce 中的旧版托管包（包含 HubSpot 的旧版 Visualforce 模块）即将被弃用。如果您仍在使用旧版 Visualforce 模块，建议在 Salesforce 中卸载该包，并改用HubSpot Embed继续操作。
开始
之前 在开始使用此功能之前，请确保您已充分了解需要提前采取的步骤，以及该功能的限制和使用该功能可能带来的后果。
了解要求
需要权限 您必须在 HubSpot 账户中拥有“账户访问”权限，并在 Salesforce 账户中具备以下订阅、访问权限和权限：
- 拥有支持 API 访问的 Salesforce 版本，或 Salesforce Professional版本。HubSpot-Salesforce 集成还支持并可连接到Salesforce Government Cloud。但不支持 Salesforce Group Edition。
- 您必须是Salesforce 系统管理员。
- 拥有以下所有用户配置文件管理权限：
- 已启用 API。
- 已启用“查看设置和配置”权限。
- 对 您希望同步到 HubSpot的 任何对象（账户、营销活动、联系人、潜在客户或商机）拥有“修改所有”权限 。
- 拥有“修改元数据”权限（用于在 Salesforce 潜在客户或联系人记录的HubSpot 嵌入窗口中查看数据）。仅当您希望使用 HubSpot 嵌入窗口并将交易同步到 HubSpot 时，才需要此权限。
- 拥有“下载 AppExchange 软件包”权限。
- 拥有“自定义应用程序配置文件”权限。此权限是安装HubSpot 嵌入窗口以及对其进行自动更新的必要条件。
- 在您的用户配置文件中，将“任务类型”字段设置为“可见”。
请注意：如果您正在 设置Salesforce 选择性同步，您的具体设置可能与下文所述的标准要求、设置和行为有所不同。
了解限制与注意事项
- 该集成每天使用的API 调用次数有限制。单次联系人同步每条记录最多可能需要四次 API 调用，但实际次数可能会有所不同。
- 若要将多个 HubSpot 账户连接到一个 Salesforce 实例，您必须在每个 HubSpot 账户中分别设置并安装该集成。每个 HubSpot 账户仅可连接一个Salesforce 实例。
- 如果您将多个 HubSpot 账户与一个 Salesforce 环境进行集成，对于 “在 HubSpot 中创建联系人” 设置中，建议选择“不自动创建 HubSpot 联系人”。如果选择了其他任一选项，则由一个 HubSpot 账户创建的 Salesforce 潜在客户或联系人可能会在另一个 HubSpot 账户中生成联系人。
- 安装并配置 Salesforce 集成后，记录不会自动同步。您可以将 Salesforce 记录导入HubSpot，或允许其根据自动同步触发器逐步同步。
-
如果您的 Salesforce 账户启用了登录 IP 限制，HubSpot 可能无法连接到 Salesforce。由于 HubSpot 使用动态 IP 地址，您无法将 HubSpot 的 IP 地址添加到白名单中。如果在 Salesforce 中选中了“对每次请求强制执行 IP 限制”设置，集成将无法连接。若要在限制 Salesforce 访问的同时允许集成正常运行，建议您在 Salesforce 中配置一个网络 IP 范围。
了解“关联用户”
“关联用户”或“集成用户”是指您用于连接集成的 Salesforce 用户。
关联用户的 Salesforce 权限决定了 HubSpot 通过同步在 Salesforce 中可以执行哪些操作。当 HubSpot 在 Salesforce 中创建、更新或同步记录时，这些操作将根据关联用户的权限进行。
例如，如果连接用户无权查看“潜在客户”对象，则潜在客户将不会同步到 HubSpot。HubSpot 也将无法通过同步在 Salesforce 中创建或更新潜在客户记录。
安装 Salesforce 应用
- 在 HubSpot 帐户中，单击顶部导航栏中的“商城”图标
，然后选择 HubSpot 商城。 - 在搜索栏中搜索并选择Salesforce 应用 。
- 点击“安装”。
- 如果您要将 HubSpot 连接到 Salesforce 沙盒，请勾选“是，这将连接到沙盒”复选框。
- 点击“安装”。
- 在弹出窗口中，输入您的 Salesforce 凭据，然后点击“登录”。登录后，您将被重定向回 HubSpot。
将新的 Salesforce 生产组织连接到 HubSpot
如果您是从已安装 HubSpot 集成包的 Salesforce 生产组织迁移到新的 Salesforce 生产组织，则需要将新的 Salesforce 生产组织连接到 HubSpot。
- 如果您是从生产环境迁移到沙盒环境，或者反之，则此流程不适用。了解如何将您的 Salesforce 沙盒环境连接到 HubSpot。
- 将新的 Salesforce 生产组织与 HubSpot 集成，需要暂停 HubSpot-Salesforce 集成约一小时。
- 目前，在将新的 Salesforce 生产组织与 HubSpot 集成时，仅能保留现有 HubSpot 联系人与 Salesforce 潜在客户或联系人之间的同步和关联关系。现有 HubSpot 公司与 Salesforce 账户之间的同步和关联关系，以及 HubSpot 交易与 Salesforce 商机之间的同步和关联关系，都将丢失。
- 在 HubSpot 帐户中，单击顶部导航栏中的
设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。 - 点击“Salesforce”。
- 在右上角，点击切换开关将其关闭，以停用集成。
- 在您的新 Salesforce 生产组织中安装集成包。
- 导出您希望继续与新的 Salesforce 生产组织同步的 HubSpot 联系人。
- 将导出的 HubSpot 联系人导入到新的 Salesforce 生产组织中。
- 创建或编辑之前在旧的 Salesforce 生产组织与 HubSpot 之间已映射的任何自定义字段映射。
请注意：如果 HubSpot 属性映射到的 Salesforce 字段在新生产组织中也存在，则可以保留现有的自定义字段映射。新生产组织中该 Salesforce 字段的内部名称必须与旧生产组织中该 Salesforce 字段的内部名称一致。如果不一致，请创建新的字段映射并删除旧的字段映射，以避免同步错误。
- 一小时后，将您的新 Salesforce 生产组织连接到 HubSpot。
- 在右上角点击切换开关，将其打开以启用集成。
- 将 Salesforce 中的潜在客户/联系人导入回 HubSpot。导入过程会根据现有 HubSpot 联系人对 Salesforce 中的潜在客户和联系人进行去重处理。此外，系统还会刷新现有 HubSpot 联系人的Salesforce 记录 ID，以便将其与新生产组织中的 Salesforce 潜在客户和联系人建立关联。
更改您的 Salesforce 关联用户
若要更改 Salesforce 连接用户，您必须在集成设置中更新您的 Salesforce 凭据。
请注意：在更改集成用户之前，请确认新集成用户的 Salesforce 权限与之前的集成用户相同或更高。
- 在 HubSpot 帐户中，单击顶部导航栏中的
设置图标。在左侧栏菜单中，导航到集成 > 连接的应用程序。 - 点击“Salesforce”。
- 在右上角，点击“操作”下拉菜单，然后点击“连接其他生产环境用户”。
- 系统将通过新浏览器标签页跳转至 Salesforce 的登录页面。输入您的 Salesforce 凭据，然后点击“登录”。
- 如果您之前已将此 Salesforce 账户与 HubSpot 关联过，系统将重定向至 HubSpot 中的 Salesforce 集成设置页面。
- 如果您从未将此 Salesforce 账户与 HubSpot 连接过，请点击“允许”，以授予 HubSpot 访问您的 Salesforce 账户的权限。
