连接 HubSpot 和 Salesforce
上次更新时间: 2026年5月12日
使用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 嵌入窗口以及对 HubSpot 嵌入窗口进行自动更新的必要条件。
- 请确保您的用户配置文件中“任务类型”字段设置为“可见”。
请注意:如果您正在 设置Salesforce 选择性同步,您的具体设置可能与下文所述的标准要求、设置和行为有所不同。
了解限制与注意事项
- 集成每天使用的API 调用次数有限制。单次联系人同步最多可能占用 4 次 API 调用(按记录计算),但实际次数可能有所不同。
- 若要将多个 HubSpot 账户连接到一个 Salesforce 实例,您必须在每个 HubSpot 账户中分别设置并安装该集成。每个 HubSpot 账户仅能连接一个Salesforce 实例。
请注意:如果您将多个 HubSpot 账户与一个 Salesforce 环境集成,对于 “在 HubSpot 中创建联系人” 设置中,建议选择“不自动创建 HubSpot 联系人”。如果选择了其他任一选项,由一个 HubSpot 账户创建的 Salesforce 潜在客户或联系人可能会在另一个 HubSpot 账户中创建联系人。
- 安装并配置 Salesforce 集成后,记录不会自动同步。您可以将 Salesforce 记录导入HubSpot,或根据自动同步触发器让其逐步同步。
安装 Salesforce 应用
- 在 HubSpot 帐户中,单击顶部导航栏中的“商城”图标
,然后选择 HubSpot 商城。 - 使用搜索栏查找并选择Salesforce。
- 点击“安装”。
- 如果您要将 HubSpot 连接到 Salesforce 沙盒,请勾选“是,这将连接到沙盒”复选框。
- 点击“登录 Salesforce”。

- 在弹出窗口中,输入您的 Salesforce 凭据并点击“登录”。登录后,您将被重定向回 HubSpot 中的安装流程。
- 在“将 HubSpot 的强大功能带入 Salesforce”屏幕上,点击“跳过此步骤”以稍后安装 HubSpot 嵌入窗口。了解有关将 HubSpot 嵌入窗口添加到 Salesforce 页面布局的更多信息。
- 在“选择数据同步设置”屏幕上 ,选择 HubSpot 与 Salesforce 之间的数据同步方式。
-
- 无论您选择哪种配置,HubSpot 都会在 HubSpot 属性与 Salesforce 字段之间建立映射关系。
- 如果 Salesforce 字段没有对应的 HubSpot 属性,系统将由“未知用户”在 HubSpot 中创建一个新属性。
- 如果您选择“推荐设置”,请点击“查看设置”。

- 如果您选择了“高级设置”,请点击“下一步”。
-
- 在下一屏幕中,设置您的联系人同步设置:
- 点击“选择要同步的联系人”下拉菜单,选择“所有联系人”以将所有联系人同步到 Salesforce,或选择一个HubSpot 受众群体作为包含受众群体,仅将该受众群体中的联系人同步到 Salesforce。
- 点击“下一步”。
- 在下一屏幕中,设置您的活动和任务同步设置:
- 点击切换Salesforce 任务同步开关 ,开启后当在 Salesforce 中创建任务时,系统会自动在 HubSpot 中创建相应任务。
- 在“时间轴同步”表格中,勾选“HubSpot 事件”旁边的“同步”复选框,将其作为任务同步到 Salesforce,并点击“Salesforce 任务类型”下拉菜单,选择在 Salesforce 中创建的任务类型。
- 点击“下一步”。
- 在下一屏幕中,设置对象和属性同步设置:
- 点击“联系人”、“公司”或“商机”选项卡,配置该对象标准属性的同步类型。在“公司”和“商机”选项卡中,您可能需要先点击开启“启用公司/商机同步”开关 ,才能创建字段映射。
- 表格中显示了 HubSpot 对象的标准属性及其在 Salesforce 中的对应字段。对于每个属性同步,请选择同步类型:优先使用 Salesforce(默认)、始终使用 Salesforce 或双向同步。了解有关 Salesforce 字段映射同步类型的更多信息。
- 点击“下一步”。
- 在下一屏幕中,设置您的联系人同步设置:
- 最后,请检查您所选的数据同步设置。若要更改某类数据同步的设置,请点击“更改”。
- 完成后,点击“完成设置并开始同步”。您将被重定向至Salesforce 集成设置页面,HubSpot 与 Salesforce 之间的数据将开始同步。

将新的 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 账户的权限。
