> ## 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.

# 设置 GoHighLevel 集成

> 了解如何将 GoHighLevel 连接到你的 LanderLab 落地页，将线索实时同步为联系人并触发工作流。

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/z2Nyn8JYMMirC6py/images/LL-GHL.png?fit=max&auto=format&n=z2Nyn8JYMMirC6py&q=85&s=3a555558695f500bfe94a2352d94ac18" alt="LanderLab 与 GoHighLevel" width="1200" height="600" data-path="images/LL-GHL.png" />
</Frame>

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

GoHighLevel（GHL）是一个一体化的 CRM 和营销自动化平台，代理机构和效果营销人员用它来管理联系人、销售管道（pipeline）和自动化工作流。当你将 GoHighLevel 连接到 LanderLab 落地页后，每一个提交表单的线索都会立即作为新联系人发送到你的 GHL 子账户。你还可以选择同时触发一个 GHL 工作流，将线索加入你已设置的任意自动化流程。

GoHighLevel 的连接分为两个阶段。首先，使用你的 Location ID 和 API 密钥将 GoHighLevel 子账户添加到 LanderLab。然后，将该账户连接到你的落地页，并配置操作、工作流、标签和字段映射。

<Note>
  GoHighLevel 集成**会全局保存在你的账户中**。添加 GHL 子账户后，你可以在多个落地页中重复使用，无需再次输入凭据。
</Note>

## 开始之前

你需要从 GoHighLevel 账户中获取两项信息：

**Location ID**

Location ID 是你的 GHL 子账户的唯一标识。获取方法如下：

1. 登录你的 GoHighLevel 子账户
2. 进入右下角的 **Settings**
3. 点击左侧边栏中的 **Business Profile**
4. 你的 **Location ID** 会显示在该页面上

**API Key**

LanderLab 需要一个启用了以下权限范围（scope）的 GHL API 密钥：

* `workflows.read`
* `contacts.read`
* `contacts.write`
* `customFields.readonly`
* `customFields.write`

要生成具有这些权限范围的 API 密钥，请进入你的 GHL 子账户，前往 **Settings**，点击 **Private Integrations**，然后创建一个包含上述权限范围的新私有集成。复制生成的 token。

<Warning>
  对于以前从未使用过 API 密钥的账户，GHL 已不再允许在标准的 Agency 或 Sub-account 设置中生成新的 API 密钥。请改用 **Private Integrations** 生成你的 token。
</Warning>

## 如何添加 GoHighLevel

### 第 1 阶段：添加你的 GoHighLevel 账户

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

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

  <Step title="选择 GoHighLevel">
    在可用集成列表中找到 **GoHighLevel**（标注为“Sync leads with GoHighLevel as they come in”）并点击。
  </Step>

  <Step title="填写账户凭据">
    输入以下信息：

    | 字段 | 说明 |
    | :- | :- |
    | **Name** | 用于识别该账户连接的标签（例如“GHL Main Account”）。 |
    | **Location ID** | 你的 GHL 子账户的唯一 ID。可在 GoHighLevel 的 **Settings > Business Profile** 下找到。 |
    | **API Key** | 已启用所需权限范围的 GoHighLevel Private Integration token。 |
  </Step>

  <Step title="点击 Add GoHighLevel">
    点击 **Add GoHighLevel** 完成身份验证并保存你的账户。LanderLab 会验证凭据并连接到你的 GHL 子账户。
  </Step>
</Steps>

### 第 2 阶段：配置操作、工作流、标签和字段映射

添加账户后，向导会进入集成配置环节。

#### 第 1 步：配置操作和标签

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

  <Step title="选择操作">
    选择线索提交后 GoHighLevel 中应执行的操作。你有两个选项：

    | 操作 | 说明 |
    | :- | :- |
    | **Save contact** | 在你的 GHL 子账户中将线索创建为新联系人，不会触发任何工作流。 |
    | **Save and trigger workflow** | 创建联系人，并立即将其加入你选择的 GHL 工作流。可用于启动邮件序列、短信跟进或销售管道分配等自动化流程。 |
  </Step>

  <Step title="选择工作流（如适用）">
    如果你选择了 **Save and trigger workflow**，将会出现 **Workflow** 下拉菜单。选择你想为每条新线索触发的 GHL 工作流。该工作流必须已存在于你的 GoHighLevel 子账户中。
  </Step>

  <Step title="添加标签（可选）">
    在 **Tags** 字段中，从现有标签中选择，或输入以创建新标签。标签会应用到通过该落地页创建的每一位联系人，可用于按活动、优惠或流量来源对线索进行细分。
  </Step>

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

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

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

    将每个表单字段映射到对应的 GHL 属性。至少要映射 **Email** 或 **Phone**，因为 GHL 至少需要其中一项才能创建联系人。

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

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

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

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

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

<Steps>
  <Step title="审核你的集成">
    最后一步会显示 GoHighLevel 集成的完整摘要，包括集成名称、所选操作、工作流（如适用）、应用的标签以及所有已映射字段。启用前请仔细检查所有内容。

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

  <Step title="点击 Connect GoHighLevel">
    点击 **Connect GoHighLevel** 保存并启用集成。从此以后，在该落地页上提交的每一条线索都会实时同步到你的 GoHighLevel 子账户。
  </Step>
</Steps>

## GoHighLevel 集成使用技巧

* **邮箱或电话至少需要一项** - GoHighLevel 至少需要其中一项才能创建联系人。请确保你的表单至少收集其中一项，并已完成映射。
* **现有联系人会被更新** - 如果线索提交的邮箱或电话在 GHL 中已存在，现有联系人记录会被更新，而不会创建重复联系人。
* **使用工作流实现自动化** - 如果你希望新线索自动收到跟进短信、被加入销售管道或开始邮件序列，请选择 **Save and trigger workflow** 并选择相应的工作流。
* **确保你的工作流处于活跃状态** - GHL 只会将联系人加入已发布且活跃的工作流。已暂停或处于草稿状态的工作流即使在此处被选中，也不会触发。
* **用真实提交进行测试** - 连接完成后，在你的落地页上提交一条测试线索，并确认该联系人在几秒钟内出现在 GoHighLevel 子账户的 **Contacts** 中。如果你触发了工作流，请检查该联系人的工作流加入记录，确认工作流已启动。


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