> ## 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: лиды и воркфлоу в GHL

> Подключите 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="Интеграция GoHighLevel с LanderLab" width="1200" height="600" data-path="images/LL-GHL.png" />
</Frame>

## Что такое GoHighLevel и зачем нужна эта интеграция

GoHighLevel (GHL) — универсальная CRM и платформа маркетинговой автоматизации, которой пользуются агентства и performance-маркетологи для управления контактами, воронками продаж и автоматизированными воркфлоу. Когда вы подключаете GoHighLevel к лендингу LanderLab, каждый лид, отправивший форму, мгновенно попадает в ваш субаккаунт GHL как новый контакт. Также можно одновременно запустить воркфлоу GHL и добавить лид в любую настроенную вами автоматизацию.

Подключение GoHighLevel проходит в два этапа. Сначала вы добавляете свой субаккаунт GoHighLevel в LanderLab с помощью Location ID и API Key. Затем подключаете этот аккаунт к лендингу и настраиваете действие, воркфлоу, теги и сопоставление полей.

<Note>
  Интеграции GoHighLevel **сохраняются глобально в вашем аккаунте**. Добавив субаккаунт GHL один раз, вы можете использовать его на нескольких лендингах, не вводя учётные данные повторно.
</Note>

***

## Перед началом

В аккаунте GoHighLevel вам понадобятся две вещи.

**Location ID**

Location ID — уникальный идентификатор вашего субаккаунта GHL. Чтобы его найти:

1. Войдите в свой субаккаунт GoHighLevel
2. Откройте **Settings** в нижнем правом углу
3. Нажмите **Business Profile** в левом меню
4. Ваш **Location ID** отображается на этой странице

**API Key**

Для LanderLab нужен API-ключ GHL с включёнными следующими scope:

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

Чтобы создать API-ключ с этими scope, откройте свой субаккаунт GHL, перейдите в **Settings**, нажмите **Private Integrations** и создайте новую private integration с перечисленными scope. Скопируйте сгенерированный токен.

<Warning>
  GHL больше не позволяет генерировать новые API-ключи в стандартных настройках Agency или Sub-account для аккаунтов, которые раньше их не использовали. Вместо этого создайте токен через **Private Integrations**.
</Warning>

***

## Как добавить GoHighLevel

### Этап 1. Добавьте аккаунт GoHighLevel

<Steps>
  <Step title="Откройте свой лендинг">
    Перейдите в **Landing Pages** и нажмите на **название лендинга**, к которому хотите добавить GoHighLevel.
  </Step>

  <Step title="Откройте вкладку Integrations">
    Нажмите **Add Integration**, чтобы открыть панель интеграций.
  </Step>

  <Step title="Выберите GoHighLevel">
    В списке доступных интеграций найдите **GoHighLevel** (с подписью «Sync leads with GoHighLevel as they come in») и нажмите на него.
  </Step>

  <Step title="Введите учётные данные аккаунта">
    Введите следующие данные:

    | Поле | Описание |
    | :- | :- |
    | **Name** | Название этого подключения аккаунта (например, «GHL Main Account»). |
    | **Location ID** | Уникальный ID вашего субаккаунта GHL. Находится в GoHighLevel: **Settings > Business Profile**. |
    | **API Key** | Ваш токен GoHighLevel Private Integration с включёнными нужными scope. |
  </Step>

  <Step title="Нажмите Add GoHighLevel">
    Нажмите **Add GoHighLevel**, чтобы пройти аутентификацию и сохранить аккаунт. LanderLab проверит учётные данные и подключится к вашему субаккаунту GHL.
  </Step>
</Steps>

***

### Этап 2. Настройте действие, воркфлоу, теги и сопоставление полей

После добавления аккаунта мастер переходит к настройке интеграции.

#### Шаг 1. Настройте действие и теги

<Steps>
  <Step title="Задайте название интеграции">
    Дайте интеграции понятное название (например, «GHL - Health Insurance Leads»). Оно поможет найти её в списке интеграций на вашем лендинге.
  </Step>

  <Step title="Выберите действие (Action)">
    Выберите, что должно произойти в GoHighLevel при отправке лида. Доступны два варианта:

    | Действие | Описание |
    | :- | :- |
    | **Save contact** | Создаёт лид как новый контакт в вашем субаккаунте GHL. Воркфлоу не запускается. |
    | **Save and trigger workflow** | Создаёт контакт и сразу добавляет его в выбранный воркфлоу GHL. Используйте, чтобы запускать автоматизации: email-цепочки, SMS-фоллоуапы, назначение в воронку. |
  </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

* **Нужен email или телефон** — для создания контакта GoHighLevel нужно хотя бы одно из этих полей. Убедитесь, что форма собирает хотя бы одно из них и это поле сопоставлено.
* **Существующие контакты обновляются** — если лид отправляет форму с email или телефоном, которые уже есть в GHL, запись существующего контакта будет обновлена, а дубликат не создастся.
* **Используйте воркфлоу для автоматизаций** — если новые лиды должны автоматически получать SMS, попадать в воронку или запускать email-цепочку, выберите **Save and trigger workflow** и нужный воркфлоу.
* **Воркфлоу должен быть активен** — GHL добавляет контакты только в опубликованные и активные воркфлоу. Воркфлоу на паузе или в статусе черновика не сработает, даже если выбран здесь.
* **Проверьте реальной отправкой** — после подключения отправьте тестовый лид на лендинге и убедитесь, что контакт появился в вашем субаккаунте GoHighLevel в разделе **Contacts** в течение нескольких секунд. Если вы запускали воркфлоу, проверьте в карточке контакта, что он добавлен в воркфлоу.


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