Перейти к основному содержимому

Интеграции данных и продуктивности

Записывайте каждый лид в таблицу, базу данных или собственную API-конечную точку. Настройте из Настройки → Интеграции.

Google Sheets​

Добавляйте новую строку в Google Sheet для каждого лида, поступающего в LeadHub.

Шаг 1 — Создание проекта Google Cloud​

  1. Перейдите на console.cloud.google.com.
  2. Нажмите New Project, назовите его LeadHub и создайте.
  3. Найдите Google Sheets API и включите его.
  4. Также включите Google Drive API.

Шаг 2 — Создание OAuth-учётных данных​

  1. В Cloud Console перейдите в APIs & Services → Credentials.
  2. Нажмите Create Credentials → OAuth client ID.
  3. Установите Application Type на Web application.
  4. В разделе Authorized redirect URIs добавьте: https://yourdomain.com/oauth/google-sheets/callback
  5. Нажмите Create и скопируйте Client ID и Client Secret.

Шаг 3 — Подготовка Google Sheet​

  1. Создайте новый Google Sheet (или откройте существующий).
  2. Добавьте заголовки столбцов в строке 1: ID | First Name | Last Name | Email | Phone | Company | Source | Pipeline | Stage | Score | Created At
  3. Скопируйте Spreadsheet ID из URL: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

Шаг 4 — Настройка в LeadHub​

  1. Перейдите в Настройки → Интеграции → Google Sheets.
  2. Заполните:
    ПолеЗначение
    Client IDИз шага 2
    Client SecretИз шага 2
    Spreadsheet IDИз шага 3
    Sheet NameНазвание листа, например Sheet1
  3. Нажмите Connect with Google для завершения OAuth-потока.

Каждый новый лид добавляет строку с полными данными.

Notion​

Создавайте новую страницу (запись базы данных) в базе данных Notion для каждого лида.

Шаг 1 — Создание интеграции Notion​

  1. Перейдите на notion.so/my-integrations.
  2. Нажмите + New integration.
  3. Задайте имя (LeadHub) и выберите рабочее пространство.
  4. Скопируйте Internal Integration Token (начинается с secret_).

Шаг 2 — Предоставление доступа базе данных интеграции​

  1. Откройте базу данных Notion для хранения лидов.
  2. Нажмите Share (вверху справа) → найдите вашу интеграцию → нажмите Invite.

Шаг 3 — Получение ID базы данных​

Из URL базы данных: https://www.notion.so/yourworkspace/DATABASE_ID?v=...

Database ID — 32-символьная строка перед ?.

Шаг 4 — Настройка в LeadHub​

  1. Перейдите в Настройки → Интеграции → Notion.
  2. Заполните:
    ПолеЗначение
    API TokenInternal Integration Token из шага 1
    Database IDИз шага 3
  3. Нажмите Сохранить и проверить.

Убедитесь, что ваша база данных имеет свойства: Name, Email, Phone, Source, Company.

Airtable​

Добавляйте новую запись в базу Airtable для каждого лида.

Шаг 1 — Получение API-ключа и данных базы/таблицы​

  1. Перейдите на airtable.com/account → прокрутите до раздела API → сгенерируйте Personal Access Token.
    • Включите области: data.records:write, schema.bases:read
    • Выберите используемую базу
  2. Откройте вашу базу Airtable и получите Base ID из URL: https://airtable.com/BASE_ID/tblXXX/...
  3. Запишите Table Name (название вкладки в вашей базе).

Шаг 2 — Подготовка таблицы Airtable​

Убедитесь, что таблица имеет поля: Name, Email, Phone, Source, Company, Pipeline, Stage, Score.

Шаг 3 — Настройка в LeadHub​

  1. Перейдите в Настройки → Интеграции → Airtable.
  2. Заполните:
    ПолеЗначение
    API KeyPersonal Access Token из шага 1
    Base IDИз шага 2
    Table NameТочное название таблицы (с учётом регистра)
  3. Нажмите Сохранить и проверить.

Универсальный вебхук​

Отправляйте данные лида на любой URL — ваш собственный сервер, пользовательскую интеграцию, бессерверную функцию или любую конечную точку, принимающую HTTP POST-запросы.

Шаг 1 — Подготовка конечной точки​

Ваша конечная точка должна:

  • Принимать HTTP POST запросы
  • Принимать Content-Type: application/json
  • Возвращать HTTP-статус 2xx при успехе

Шаг 2 — Настройка в LeadHub​

  1. Перейдите в Настройки → Интеграции → Generic Webhook.
  2. Заполните:
    ПолеЗначение
    Webhook URLПолный URL вашей конечной точки
    Secret Key(Необязательно) Секретная строка, добавляемая как заголовок X-LeadHub-Signature
  3. Нажмите Сохранить и проверить.

Структура данных​

{
  "event": "lead.created",
  "id": "lead_01HXZ3...",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "[email protected]",
  "phone": "+1 555 000 1234",
  "company": "Acme Corp",
  "source": "facebook_lead_ads",
  "pipeline": "Sales",
  "stage": "New",
  "score": 72,
  "tags": ["webinar", "hot"],
  "custom_fields": {},
  "created_at": "2025-06-15T14:23:00Z"
}

Проверка подписи​

Если вы установили Secret Key, каждый запрос содержит заголовок:

X-LeadHub-Signature: sha256=HMAC_SHA256(secret, payload_body)

Проверяйте его в вашей конечной точке для подтверждения подлинности запросов LeadHub.

REST API Push​

Отправляйте данные лида на RESTful API конечную точку с настраиваемым HTTP-методом, заголовками и сопоставлением полей.

Шаг 1 — Определение конечной точки API​

Вам потребуется:

  • Полный URL конечной точки (например, https://api.yourapp.com/v1/leads)
  • HTTP-метод: POST, PUT или PATCH
  • Необходимые заголовки аутентификации (например, Authorization: Bearer YOUR_TOKEN)

Шаг 2 — Настройка в LeadHub​

  1. Перейдите в Настройки → Интеграции → REST API Push.
  2. Заполните:
    ПолеЗначение
    Endpoint URLПолный URL API конечной точки
    HTTP MethodPOST, PUT или PATCH
    HeadersJSON-объект заголовков, например {"Authorization": "Bearer abc123"}
  3. Нажмите Сохранить и проверить.

Устранение неполадок​

ПроблемаРешение
OAuth ошибка Google SheetsУбедитесь, что redirect URI совпадает точно, включая https://
Notion «object not found»Интеграция не имеет доступа к базе данных — повторите шаг 2
Несоответствие полей AirtableНазвания полей чувствительны к регистру — проверьте точные названия
Вебхук возвращает 4xxУбедитесь, что ваша конечная точка принимает Content-Type: application/json
REST API Push не срабатываетПроверьте cron-задание — см. Руководство по общему хостингу
Несоответствие подписиУбедитесь, что вы вычисляете HMAC-SHA256 по необработанному телу запроса