连接 HubSpot 和 Salesforce
上次更新时间: 2026年11月5日
将 HubSpot 与 Salesforce 连接起来,以便在您的营销、销售和客户服务团队之间同步数据。HubSpot 与 Salesforce 的集成可让联系人、公司、商机、活动及其他受支持的数据在两个平台之间同步,帮助团队在不同系统中使用一致的信息开展工作
。
通过连接 HubSpot 和 Salesforce,您可以减少手动数据录入,保持客户记录的一致性,并支持潜在客户交接、活动跟踪和报告等流程。 例如,当一个平台中的联系人信息被更新时,该变更会根据您的集成设置同步到另一个平台。
如果您正在迁移到新的 Salesforce 生产组织,请了解如何连接新的生产组织。
在连接 HubSpot 和 Salesforce 之前,请查看如何规划您的 HubSpot-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 调用次数有限制。单次联系人同步每条记录最多可能需要四次 API 调用,但具体次数可能会有所不同。
- 若要将多个 HubSpot 账户连接到一个 Salesforce 实例,您必须在每个 HubSpot 账户中分别设置并安装该集成。每个 HubSpot 账户仅可连接一个Salesforce 实例。
- 如果您将多个 HubSpot 账户与一个 Salesforce 环境集成,对于 “在 HubSpot 中创建联系人” 设置中,建议选择“不自动创建 HubSpot 联系人”。如果选择了其他任一选项,由一个 HubSpot 账户创建的 Salesforce 潜在客户或联系人可能会在另一个 HubSpot 账户中生成联系人。
- 安装并配置 Salesforce 集成后,记录不会自动同步。您可以将 Salesforce 记录导入HubSpot,或允许其根据自动同步触发器逐步同步。
- 如果您的 Salesforce 账户启用了登录 IP 限制,HubSpot 可能无法连接到 Salesforce。要允许连接,请在 Salesforce 中将 HubSpot应用的“ ”设置为“放松 IP 限制”。这将使 HubSpot 应用免受 IP 限制,同时仍对 Salesforce 用户保持限制。
请注意:如果 Salesforce 中启用了“对每次请求强制执行 IP 限制”设置,该设置将覆盖 HubSpot 应用的IP 放宽设置,并阻止应用连接。请勿启用此设置,而应在 Salesforce 中配置网络 IP 范围以限制用户访问,并将 HubSpot 应用的IP 放宽设置设为“放宽 IP 限制”,以便允许应用连接。
- HubSpot-Salesforce 集成旨在实现 Salesforce 与 HubSpot 之间的持续双向同步。若需将 Salesforce 数据一次性迁移至 HubSpot,请改用HubSpot Smart Transfer。如果您之前曾使用 Smart Transfer 传输过 Salesforce 数据,请在启用 Salesforce 集成之前,先关闭所有Smart Transfer 同步连接。Smart Transfer 和 Salesforce 集成使用不同的唯一标识符来匹配记录。同时使用这两者会在 HubSpot 和 Salesforce 中生成重复记录。
了解“关联用户”
“关联用户”或“集成用户”是指您用于连接该集成的 Salesforce 用户。
关联用户的 Salesforce 权限决定了 HubSpot 通过同步在 Salesforce 中可以执行哪些操作。当 HubSpot 在 Salesforce 中创建、更新或同步记录时,这些操作将根据关联用户的权限进行。
例如,如果已连接用户无权查看“潜在客户”对象,则潜在客户将不会同步到 HubSpot。HubSpot 也将无法通过同步在 Salesforce 中创建或更新潜在客户记录。
如果您需要更换已连接用户,新用户必须拥有与前任用户相同或更高的权限,并且必须连接到同一 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 账户的权限。
