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

# 设置 HubSpot 集成

> 了解如何将 HubSpot 连接到你的 LanderLab 落地页，将线索实时作为联系人直接发送到你的 HubSpot CRM。

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/z2Nyn8JYMMirC6py/images/LL-HS.png?fit=max&auto=format&n=z2Nyn8JYMMirC6py&q=85&s=97cdfc78e7126632ff628c0b202905b2" alt="LanderLab 与 HubSpot 的 logo 并排展示，代表 HubSpot 集成" width="1200" height="600" data-path="images/LL-HS.png" />
</Frame>

## 什么是 HubSpot？为什么要使用这个集成？

HubSpot 是一个 CRM 平台，用于管理联系人、交易、公司和营销自动化。当你将 HubSpot 连接到 LanderLab 落地页后，每一个提交表单的线索都会立即在 HubSpot 中创建为联系人，你所选的所有表单字段都会映射到正确的 HubSpot 联系人属性。

HubSpot 使用 **OAuth** 进行连接。也就是说，你无需粘贴 API 密钥，而是直接登录你的 HubSpot 账户并授权 LanderLab 访问。你会被重定向到 HubSpot 完成授权，然后返回 LanderLab 完成设置。

<Note>
  HubSpot 集成**会全局保存在你的账户中**。授权 HubSpot 账户后，你可以在多个落地页中重复使用，无需再次走 OAuth 流程。
</Note>

## 如何添加 HubSpot

HubSpot 的设置分为两个阶段：先通过 OAuth 授权你的 HubSpot 账户，然后在 LanderLab 中配置字段映射。

### 第 1 阶段：授权你的 HubSpot 账户

<Steps>
  <Step title="进入你的落地页">
    前往 **Landing Pages**，点击你想添加 HubSpot 的**落地页名称**。
  </Step>

  <Step title="打开集成标签页">
    点击 **Add Integration** 打开集成面板。
  </Step>

  <Step title="选择 HubSpot">
    在可用集成列表中找到 **HubSpot** 并点击。
  </Step>

  <Step title="点击 Add Account">
    点击 **Add Account**。你会被重定向到 HubSpot 授权页面。
  </Step>

  <Step title="登录 HubSpot">
    在 HubSpot 授权页面上，你有两个选项：

    * **Sign in to your HubSpot account** - 如果你已有 HubSpot 账户，请选择此项
    * **Create a new HubSpot account** - 如果你还没有账户，请选择此项

    点击 **Sign in to your HubSpot account**，并使用你的账户凭据登录。
  </Step>

  <Step title="授权 LanderLab">
    登录后，HubSpot 会显示一个权限页面，列出 LanderLab 请求的访问权限，包括管理和查看你的 CRM 数据（如联系人、公司和交易）的权限。

    查看权限后，点击 **Connect** 授权 LanderLab。

    <Note>
      LanderLab 请求 CRM 访问权限，以便在线索提交时在 HubSpot 中创建和更新联系人记录。你可以随时在 HubSpot 账户的 **Settings > Integrations > Connected Apps** 下撤销此访问权限。
    </Note>
  </Step>

  <Step title="返回 LanderLab">
    授权完成后，HubSpot 会自动将你重定向回 LanderLab。设置向导会打开，你的 HubSpot 账户已连接好，可以开始配置。
  </Step>
</Steps>

### 第 2 阶段：配置字段映射

通过 OAuth 重定向返回 LanderLab 后，你需要完成一个 3 步向导来完成设置。

#### 第 1 步：配置连接

<Steps>
  <Step title="为该集成设置名称">
    为该集成设置一个容易识别的标签（例如“HubSpot - Auto Insurance Leads”），方便你在落地页的集成列表中辨认。
  </Step>

  <Step title="点击 Continue">
    点击 **Continue** 进入字段映射步骤。
  </Step>
</Steps>

#### 第 2 步：映射你的字段

<Steps>
  <Step title="将表单字段映射到 HubSpot 联系人属性">
    左侧会列出落地页表单中的所有字段，右侧有一个下拉菜单，用于选择对应的 HubSpot 联系人属性。

    将每个表单字段映射到对应的 HubSpot 属性。至少要映射 **Email**，因为 HubSpot 需要邮箱才能创建或更新联系人。

    | 表单字段 | HubSpot 属性 |
    | :- | :- |
    | Full Name | Full Name |
    | Email | Email\* |
    | Phone Number | Phone Number |
    | （其他表单字段） | Select field |

    未映射的字段不会被发送到 HubSpot。使用左侧的复选框来包含或排除单个字段。

    <Tip>
      LanderLab 还提供系统字段，例如 **LL Lander URL**、**LL Visitor IP**、**LL Visitor User Agent**、**LL Submission Time UTC** 和 **LL Variant ID**。如果你想将跟踪数据与联系人记录一起保存，可以将它们映射到 HubSpot 中的自定义联系人属性。
    </Tip>
  </Step>

  <Step title="点击 Continue">
    点击 **Continue** 进入审核步骤。
  </Step>
</Steps>

#### 第 3 步：审核并连接

<Steps>
  <Step title="审核你的集成">
    最后一步会显示 HubSpot 集成的完整摘要，包括集成名称和所有已映射字段。启用前请仔细检查所有内容。

    如果有任何问题，点击 **Back** 返回前面的步骤进行修改。
  </Step>

  <Step title="点击 Connect HubSpot">
    点击 **Connect HubSpot** 保存并启用集成。从此以后，在该落地页上提交的每一条线索都会实时在你的 HubSpot CRM 中创建为联系人。
  </Step>
</Steps>

## HubSpot 集成使用技巧

* **Email 为必填** - HubSpot 使用邮箱作为联系人的唯一标识。请务必映射邮箱字段，并确保你的表单包含邮箱输入框。
* **现有联系人会被更新** - 如果线索提交的邮箱地址在 HubSpot 中已存在，LanderLab 会更新现有联系人记录，而不是创建重复联系人。
* **仔细映射电话字段** - HubSpot 有专门的 Phone Number 属性。请确保将表单的电话字段映射到正确的 HubSpot 属性，以免数据存到错误的位置。
* **用真实提交进行测试** - 连接完成后，在你的落地页上提交一条测试线索，并确认该联系人在几秒钟内出现在 HubSpot 的 **Contacts** 中。
* **重新授权** - 如果你需要重新连接 HubSpot 账户，只需添加一个新的 HubSpot 集成，并重新走一遍 OAuth 流程即可。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.