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

> Подключите HubSpot к лендингам в LanderLab через OAuth, чтобы лиды автоматически создавались контактами в 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 рядом — интеграция с HubSpot" width="1200" height="600" data-path="images/LL-HS.png" />
</Frame>

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

HubSpot — CRM-платформа для управления контактами, сделками, компаниями и маркетинговой автоматизацией. Когда вы подключаете HubSpot к лендингу LanderLab, каждый лид, отправивший форму, мгновенно создаётся в HubSpot как контакт, а выбранные вами поля формы сопоставляются с нужными свойствами контакта.

HubSpot подключается через **OAuth**. Это означает, что вместо API-ключа вы входите в свой аккаунт HubSpot напрямую и разрешаете LanderLab доступ к нему. Вас перенаправят на страницу HubSpot для авторизации, а затем вернут в LanderLab, чтобы завершить настройку.

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

***

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

Настройка HubSpot состоит из двух этапов: авторизация аккаунта HubSpot через OAuth, затем сопоставление полей внутри LanderLab.

### Этап 1. Авторизуйте аккаунт HubSpot

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

  <Step title="Откройте вкладку Integrations">
    Нажмите **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. Настройте сопоставление полей

После возврата в LanderLab после OAuth-перенаправления вам нужно пройти мастер из трёх шагов.

#### Шаг 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 использует email как уникальный идентификатор контакта. Всегда сопоставляйте поле email и убедитесь, что в форме есть поле для ввода email.
* **Существующие контакты обновляются** — если лид отправляет форму с email, который уже есть в 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.