---
title: "HubSpot"
description: "使用 Quire HubSpot 应用保持 Quire 与 HubSpot 数据同步。"
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/zh-Hans/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

<span id="hubspot"></span>

Quire HubSpot 应用会同步学习数据和 CRM 数据：HubSpot 联系人会成为 Quire 用户，公司会成为部门，用户在 Quire 中的活动也会显示在其 HubSpot 记录中。

## 连接 <!--quire:connecting-->

每个 Quire 组织只需安装一次应用，由同时拥有 HubSpot 和 Quire 管理员权限的人员通过 HubSpot 自带的授权页面完成。一个 HubSpot 账户只能连接到一个 Quire 组织：如果第二个组织尝试连接同一 HubSpot 账户，会被拒绝，因为共享账户会将一个组织的学习者带入另一个组织的 CRM。

安装时，应用会检查您的 HubSpot 套餐是否包含自定义行为事件，并选择学习数据的报告方式：

| HubSpot 套餐 | HubSpot 中显示的内容 |
| --- | --- |
| 包含自定义行为事件（Marketing Hub Enterprise） | 联系人时间线中的事件：已选课、已开始、已完成、已颁发证书、已参加测验 |
| 不包含自定义行为事件 | 每位联系人都会有一个**Quire 学习**属性组：最近课程、最近完成日期、已完成课程数、最新证书 |

集成设置页面会显示当前使用的模式。之后升级 HubSpot 套餐时，请重新连接即可切换模式。

## 同步哪些数据 <!--quire:what-is-kept-in-step-->

- **联系人和用户**、**公司和部门**以及 **Quire 课程和 HubSpot 的 Courses 对象**，这些记录会逐一关联。
- 您自行映射的**字段**：包括来源、目标和同步方向（同步到 HubSpot、同步到 Quire 或双向同步）。
- 每个字段的**冲突**可以按以下规则处理：Quire 优先、HubSpot 优先、较新内容优先，或交由人员决定。默认情况下，学习数据以 Quire 为准，营销数据以 HubSpot 为准。

首次连接时会在后台补录已有记录，并报告进度，不会阻塞实时变更。

## 根据联系人创建用户 <!--quire:creating-people-from-contacts-->

没有对应 Quire 用户的 HubSpot 联系人可以创建为 Quire 用户。在集成设置页面启用**根据 HubSpot 联系人创建用户**，然后选择：

- 符合条件的**生命周期阶段**，避免把潜在客户创建为用户；
- 每位新用户都要加入的**群组**和**课程**；
- 是否让新用户加入一个**以其 HubSpot 公司命名的小组**；
- Quire 是否每五分钟**自动**导入有变化的联系人。

每个联系人都会通过与 CSV 上传相同的用户导入流程。套餐用户上限、许可证名额和个人资料字段规则都会生效；如果某个联系人无法导入（例如地址无效或许可证已满），系统会单独列出该联系人，但不会停止导入其他联系人。已通过关联或电子邮件地址匹配到用户的联系人会按字段映射进行关联和更新，不会重复创建，也不会用 CRM 中的信息覆盖现有用户。

同步到 Quire（或双向同步）的字段映射行会从 HubSpot 属性填写新用户的姓名、时区、语言和个人资料字段。

**预览将产生的更改**会读取一页联系人并列出将要创建、关联、保留或拒绝的项目，但不会写入任何数据。**立即导入已更改的联系人**会读取上次导入后发生变化的联系人。首次导入会读取所有联系人；在设置表单中选择**重新读取所有联系人**会重新开始。大量待处理联系人需要分多次运行导入，每次会从上次停止的位置继续；下一轮还会重新读取上一轮最后处理的最新联系人，这不会造成问题。

HubSpot 的联系人创建和更改通知、进入选课阶段的交易，以及工作流操作指定的尚无 Quire 用户的联系人，都会将联系人送入同步流程。同步日志会逐项记录处理结果（包括未创建的联系人），而设置更改和手动导入会记录在审计日志中。

## 工作流 <!--quire:workflows-->

四种 HubSpot 工作流操作会在 Quire 中执行：**选课**、**退课**、**颁发证书**和**发送电子邮件**。即使 HubSpot 工作流运行两次，也不会重复选课。

您还可以设置当交易进入某个阶段，或将映射到课程的产品添加到交易时，自动为用户选课。请在每门课程的选课方式中单独配置 **HubSpot**。

## 联系人记录 <!--quire:on-the-contact-record-->

每个 HubSpot 联系人都会有一个 Quire 卡片，显示其选课、进度和证书。

## 同步日志 <!--quire:the-sync-log-->

所有操作都会保留 30 天的日志，包括同步方向、记录、结果和错误。失败的操作可从日志重试。系统会自动遵守 HubSpot 速率限制；HubSpot 要求应用减速时，系统会暂停该账户的同步，而不是直接报错。

Source: https://docs.quirelms.com/zh-Hans/integrations/hubspot/index.mdx