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

# HubSpot

> 实时将 Wave 联系人同步到 HubSpot CRM

<Info>
  适用于 **Pro**、**Teams** 和 **Enterprise** 计划。
</Info>

HubSpot 集成会自动将您通过 Wave 收集的联系人作为"联系人"实时同步到 HubSpot CRM。当联系人在 Wave 中被创建、更新或删除时，HubSpot 会实时更新，无需手动导入。联系人备注通过关联的 HubSpot Notes 保持同步。

## 连接方式

<Steps>
  <Step title="打开集成">
    前往 **集成 → HubSpot**。
  </Step>

  <Step title="启用自动同步（可选）">
    开启 **自动同步** 可立即将所有现有 Wave 联系人导入 HubSpot。
  </Step>

  <Step title="连接 HubSpot">
    点击 **连接** 并登录您的 HubSpot 账户。
  </Step>
</Steps>

Wave 请求读写 CRM 联系人的权限、读取联系人架构（以创建自定义属性）以及读取 HubSpot 所有者（以分配联系人）的权限。

## 同步内容

| Wave 字段 | HubSpot 字段          |
| ------- | ------------------- |
| 名字      | `firstname`         |
| 姓氏      | `lastname`          |
| 主邮箱     | `email`             |
| 主电话     | `phone`             |
| 公司      | `company`           |
| 职位      | `jobtitle`          |
| 城市      | `city`              |
| 语言      | `hs_language`       |
| 个人资料链接  | `website`           |
| 联系人备注   | 关联的 HubSpot Note    |
| 分配的团队成员 | HubSpot 所有者（通过邮箱匹配） |

**同步方向**：Wave → HubSpot（仅出站）

**同步时机**：联系人创建、更新或删除时实时同步

## 功能特点

* **连接时自动同步**：首次连接时将所有现有 Wave 联系人导入 HubSpot。
* **去重**：如果 HubSpot 中已存在相同主邮箱的联系人，Wave 会更新该联系人而非创建重复记录。
* **备注同步**：在 Wave 中编写的联系人备注会作为关联的 HubSpot Notes 创建或更新。
* **所有者分配**：联系人会根据邮箱地址自动分配给匹配的 HubSpot 所有者。

## 限制与要求

* 如果您的 HubSpot 计划已达到联系人上限，新联系人将无法同步。
* 所有者匹配通过邮箱进行。如果团队成员的邮箱与任何 HubSpot 所有者不匹配，联系人将在没有所有者的情况下创建。
* 设置期间会在您的 HubSpot 账户中创建两个隐藏的自定义属性（`wave_sync_id`、`wave_note_id`），用于去重，请勿删除。

## 断开连接

前往 **集成 → HubSpot** 并点击 **断开连接**。这将移除集成并撤销 Wave 对您 HubSpot 账户的访问权限。已同步的联系人将保留在 HubSpot 中。