请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。
安装 HubSpot-Salesforce 集成
上次更新时间: 2025年12月16日
HubSpot与Salesforce的集成可让您在HubSpot和Salesforce之间无缝同步数据,确保营销与销售团队的信息一致性。
请注意:
- HubSpot-Salesforce集成不受Salesforce平台API旧版停用的 影响。
- Salesforce 中包含 HubSpot 旧版 Visualforce 模块的旧版管理包即将停用。若您仍在使用旧版 Visualforce 模块,建议卸载 Salesforce 中的该管理包,并改用HubSpot Embed。
开始前须知
在部分集成设置和安装过程中,您需要在这些说明与 Salesforce 之间来回切换。
您需在HubSpot账户中拥有账户访问权限,并在Salesforce账户中具备以下订阅、访问权限及权限设置:
- 需使用具备API访问权限的Salesforce版本或Salesforce专业版。该集成同样支持Salesforce政府云并可与其连接,但不支持Salesforce团体版。
- 您需具备Salesforce系统管理员权限。
- 拥有以下所有用户配置文件管理权限:
- API 已启用。
- 已启用查看设置与配置权限。
- 对 需同步至 HubSpot的 所有对象(账户、营销活动、联系人、潜在客户或商机)拥有"修改全部 "权限。
- 拥有修改元数据权限(用于在 Salesforce 潜在客户或联系人记录中查看HubSpot 嵌入窗口的数据)。仅当您需要使用 HubSpot 嵌入窗口并将交易同步至 HubSpot 时才需此权限。
- 拥有下载AppExchange软件包权限。
- 拥有自定义应用程序配置文件权限。此权限用于安装HubSpot 嵌入窗口并实现其自动更新。
- 用户配置文件中需将任务类型字段设置为可见。
请注意:若 您正在设置Salesforce 选择性同步,具体设置可能与下文所述的标准要求、设置及行为存在差异。
HubSpot-Salesforce集成的基本预期
- 集成每日使用的API 调用次数存在限制。单次联系人同步最多可能消耗每条记录四个 API 调用,但实际数量可能有所不同。
- 若需将多个 HubSpot 账户连接至同一 Salesforce 实例,必须在每个 HubSpot 账户中分别设置并安装集成。每个 HubSpot 账户仅可连接一个Salesforce 实例。
请注意:若您需将多个HubSpot账户集成至同一Salesforce环境,则 创建 HubSpot 联系人 设置中,建议选择"不自动创建HubSpot联系人"。若选择其他任一选项,由某HubSpot账户创建的Salesforce潜在客户或联系人可能在另一个HubSpot账户中同步创建联系人。
- 安装并配置 Salesforce 集成后,记录不会自动同步。您可选择将 Salesforce 记录导入HubSpot,或通过自动同步触发器实现渐进式同步。
安装 HubSpot-Salesforce 集成
- 在 HubSpot 帐户中,单击顶部导航栏中的“商城”图标 marketplace,然后选择 HubSpot 商城。
- 使用搜索栏定位并选择Salesforce 集成。
- 点击安装。
- 若需连接 HubSpot 与 Salesforce 沙盒环境,请勾选"是,此操作将连接至沙盒"复选框。
- 点击登录 Salesforce。

- 在弹出窗口中输入您的 Salesforce 凭据,然后点击登录。登录后,系统将自动跳转回 HubSpot 的安装流程。
- 接下来在 Salesforce 中安装 HubSpot。点击“开始 Salesforce 软件包安装”启动流程,或直接访问生产环境软件包。
- 您将被重定向至 Salesforce 安装 HubSpot 集成包。选择"为所有用户安装",然后点击"安装"。
- 在对话框中勾选“是,授予这些第三方网站访问权限”复选框,然后点击“继续”。
- Salesforce将开始安装HubSpot集成包,此过程可能需要长达十分钟。
-
- 您可能会看到以下提示:此应用程序安装耗时较长。安装完成后您将收到一封电子邮件。
- 点击"完成"后,请等待Salesforce发送主题为"HubSpot集成包安装成功"的邮件。
- 包安装完成后,返回 HubSpot 连接器向导并点击"下一步"。
- 接下来,将 HubSpot 嵌入窗口添加至 Salesforce。
-
- Salesforce中的HubSpot Embed窗口将显示该Salesforce记录与HubSpot的交互活动摘要、对象记录关联关系及属性历史记录。
- 您还可在Salesforce中直接将记录加入HubSpot工作流和序列。
- 点击“将 HubSpot 嵌入添加至 Salesforce”。您也可选择点击“跳过此步骤”,稍后再安装 HubSpot 嵌入窗口。

- 请遵循安装页面的分步说明在 Salesforce 中添加 HubSpot 嵌入窗口,或了解如何将 HubSpot 嵌入窗口添加至您的 Salesforce 页面布局。
- 完成后点击下一步。

- 接下来,选择数据在HubSpot与Salesforce之间的同步方式。
-
- 无论选择何种设置方案,HubSpot 都会自动建立属性与 Salesforce 字段之间的映射关系。
- 如果 Salesforce 字段没有匹配的 HubSpot 属性,则由未知用户在 HubSpot 中创建新属性。
- 若选择推荐设置,请点击“查看设置”。

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

Integrations
你的反馈对我们至关重要,谢谢。
此表单仅供记载反馈。了解如何获取 HubSpot 帮助。
