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

Источники лидов — Руководство по настройке

LeadHub может принимать лиды из 19 различных источников. Большинство источников работают через вебхук — вы вставляете сгенерированный LeadHub URL во внешнюю платформу, и лиды поступают автоматически.

Принцип работы источников на основе вебхука​

  1. Перейдите в Интеграции → Источники лидов и создайте новое подключение.
  2. Выберите тип источника и настройте сопоставление полей.
  3. Скопируйте сгенерированный URL входящего вебхука.
  4. Вставьте URL во внешнюю платформу (инструкции по каждому источнику ниже).
  5. Проверьте, отправив тестовый лид — он появится в вашем рабочем пространстве за несколько секунд.

Facebook Lead Ads (Meta)​

Facebook Lead Ads позволяют пользователям заполнить форму прямо в Facebook/Instagram, не покидая приложение.

Meta удалила опцию «Other» для CRM

Meta больше не предлагает опцию Other в разделе CRM Integration лид-форм, поэтому вставить URL вебхука на уровне формы больше нельзя. Вместо этого подключитесь через OAuth и вебхук на уровне приложения, как описано ниже.

Шаг 1 — Настройте приложение Meta​

Создайте (или откройте) приложение типа Business на developers.facebook.com:

  1. Добавьте продукт Facebook Login.

  2. App Settings → Basic → App Domains: добавьте домен вашего LeadHub (например, crm.example.com).

  3. Facebook Login → Settings → Valid OAuth Redirect URIs: добавьте

    https://YOUR-DOMAIN/oauth/meta/callback

    Значение должно точно совпадать с APP_URL вашей установки, включая https.

подсказка

Добавление домена и redirect URI также устраняет ошибку "Can't load URL. The domain of this URL isn't included in the app's domains."

Шаг 2 — Подключитесь в LeadHub​

  1. Перейдите в Подключения источников лидов и добавьте подключение Meta.
  2. Введите ваши App ID и App Secret.
  3. Нажмите Connect via OAuth, подтвердите запрошенные разрешения и выберите вашу страницу.
  4. LeadHub автоматически сохраняет Page access token в подключении.

Шаг 3 — Настройте вебхук Leadgen (на уровне приложения Meta)​

Это заменяет удалённую опцию «Other» на уровне формы:

  1. В App Dashboard → Webhooks выберите объект Page.
  2. Подпишитесь на поле leadgen.
  3. Callback URL и Verify Token: скопируйте оба значения с экрана подключения Meta в LeadHub.
  4. Подпишите вашу страницу на вебхук.

Теперь новые лиды поступают автоматически — Meta отправляет каждый лид на вебхук, а LeadHub получает полные данные лида из Graph API с помощью вашего Page access token.

Разрешения и App Review​

OAuth-подключение запрашивает следующие разрешения (scopes): leads_retrieval, pages_show_list, pages_read_engagement, pages_manage_ads.

Эти разрешения требуют прохождения Meta App Review + Business Verification, прежде чем они начнут работать для аккаунтов, отличных от администраторов, разработчиков и тестировщиков самого приложения.

Чтобы протестировать до одобрения, выполните одно из двух:

  • Добавьте себя как Admin / Developer / Tester в приложении Meta, или
  • Вставьте Page Access Token (сгенерированный в Graph API Explorer от Meta с разрешением leads_retrieval) в поле Page Access Token подключения — LeadHub будет читать лиды напрямую с его помощью.

Пример сопоставления полей​

Поле FacebookПоле LeadHub
full_namefirst_name
emailemail
phone_numberphone

Альтернативно используйте Zapier или n8n в качестве моста для большего контроля над данными.

Instagram Leads​

Реклама Instagram Lead Ads использует ту же инфраструктуру Meta Ads, что и Facebook Lead Ads. Выполните те же шаги выше — реклама Instagram и Facebook доставляет данные на одну и ту же конечную точку вебхука.

TikTok Lead Generation​

TikTok Lead Gen захватывает лиды прямо в рекламе TikTok.

Шаги настройки​

  1. Создайте подключение: Тип → TikTok Lead Generation.
  2. Скопируйте URL вебхука.
  3. В TikTok Ads Manager → Assets → Lead Generation → Webhook:
    • Нажмите Create Webhook.
    • Вставьте URL вебхука LeadHub.
    • Выберите поля для передачи.
  4. Отправьте тестовый лид для проверки.

Примечания​

  • TikTok отправляет проверочный ping на URL — LeadHub автоматически отвечает правильным токеном.
  • Имена полей в TikTok: name, email, phone_number.

LinkedIn Lead Gen Forms​

LinkedIn Lead Gen Forms захватывают лиды из спонсируемого контента LinkedIn.

Шаги настройки​

  1. Создайте подключение: Тип → LinkedIn Lead Gen Forms.
  2. Скопируйте URL вебхука.
  3. В LinkedIn Campaign Manager → Account Assets → Lead Gen Forms → Integrations:
    • Выберите вашу форму.
    • В Integrations выберите Other integrations → Webhook.
    • Вставьте URL вебхука.
  4. Сопоставьте поля (LinkedIn отправляет firstName, lastName, emailAddress, phone).

WhatsApp Business​

Захватывайте лиды, которые пишут на ваш WhatsApp Business аккаунт.

Настройка через WhatsApp Business API (Cloud API)​

  1. Создайте подключение: Тип → WhatsApp Business.
  2. Скопируйте URL вебхука.
  3. В Meta Business → WhatsApp → Configuration → Webhooks:
    • Установите Callback URL на URL вебхука LeadHub.
    • Установите Verify Token (показан в настройках подключения LeadHub).
    • Подпишитесь на события messages.
  4. Когда пользователь отправляет сообщение на ваш номер WhatsApp, LeadHub создаёт лид из его имени и номера телефона.

Настройка через Zapier (проще для большинства пользователей)​

  1. Создайте Zap в Zapier: Trigger → WhatsApp Business (или используйте сторонний коннектор WhatsApp).
  2. Action → Webhooks by Zapier → POST на URL вебхука LeadHub.
  3. Сопоставьте поля контакта.

Telegram​

Захватывайте лиды, которые пишут вашему Telegram-боту.

Шаги настройки​

  1. Создайте Telegram-бота через @BotFather:
    • Отправьте /newbot BotFather.
    • Выберите имя и username.
    • Скопируйте Bot Token.
  2. В LeadHub создайте подключение: Тип → Telegram.
  3. Введите Bot Token в настройках подключения.
  4. LeadHub автоматически регистрирует вебхук через Telegram API.
  5. Когда пользователь отправляет /start или любое сообщение боту, создаётся лид.

Что LeadHub захватывает из Telegram​

Поле TelegramПоле LeadHub
first_nameFirst Name
last_nameLast Name
usernameсохраняется в Notes
message textсохраняется в Notes

Viber​

Захватывайте лиды из вашего бизнес-аккаунта Viber.

Шаги настройки​

  1. Создайте бизнес-аккаунт Viber на partners.viber.com.
  2. Получите Viber Bot Token.
  3. В LeadHub создайте подключение: Тип → Viber.
  4. Введите Bot Token — LeadHub автоматически настроит вебхук.
  5. Когда пользователь пишет на ваш аккаунт Viber, создаётся лид.

Twitter / X​

Захватывайте лиды через Twitter/X DM или лид-формы.

Настройка через Zapier (рекомендуется)​

  1. В Zapier создайте Zap: Trigger → Twitter → New Direct Message.
  2. Action → Webhooks by Zapier → POST на URL вебхука LeadHub.
  3. Сопоставьте sender_screen_name с пользовательским полем и text с Notes.

Доступ к API Twitter требует аккаунта разработчика. Для большинства пользователей Zapier — наиболее простой путь.

Snapchat Lead Ads​

Snapchat Lead Ads работают аналогично Facebook Lead Ads.

Шаги настройки​

  1. Создайте подключение: Тип → Snapchat Lead Ads.
  2. Скопируйте URL вебхука.
  3. В Snapchat Ads Manager → Business → Snap Pixel & APIs → Lead Webhook:
    • Вставьте URL вебхука.
    • Выберите формы для подключения.
  4. Snapchat отправляет: full_name, email, phone_number.

Pinterest Lead Ads​

Шаги настройки​

  1. Создайте подключение: Тип → Pinterest Lead Ads.
  2. Скопируйте URL вебхука.
  3. В Pinterest Ads Manager → Lead Ads → Webhook (или через Zapier):
    • Вставьте URL вебхука или настройте мост Zapier.
  4. Pinterest отправляет: email, first_name, last_name.

Google Ads Lead Form Extensions позволяют пользователям отправлять данные прямо в результатах поиска Google.

Шаги настройки​

  1. Создайте подключение: Тип → Google Ads Lead Forms.
  2. Скопируйте URL вебхука.
  3. В Google Ads → Lead Form Extension → Edit → Webhook integration:
    • Вставьте URL вебхука.
    • Введите Webhook Key (показан в настройках подключения LeadHub).
  4. Google Ads отправляет: массив user_column_data с full_name, email, phone_number, postcode.

YouTube Lead Forms​

YouTube Lead Forms (часть Google Ads) работают идентично Google Ads Lead Form Extensions. Используйте те же шаги — реклама YouTube использует ту же инфраструктуру вебхуков Google Ads.

Microsoft Advertising (Bing Ads)​

Настройка через Zapier​

  1. В Zapier создайте Zap: Trigger → Microsoft Advertising → New Lead.
  2. Action → Webhooks by Zapier → POST на URL вебхука LeadHub.
  3. Сопоставьте поля: first_name, last_name, email, phone.

Typeform​

Шаги настройки​

  1. Создайте подключение: Тип → Typeform.
  2. Скопируйте URL вебхука.
  3. В Typeform → Your Form → Connect → Webhooks:
    • Нажмите Add a webhook.
    • Вставьте URL вебхука LeadHub.
    • Включите вебхук.
  4. Typeform отправляет полный JSON ответа формы при каждой отправке.

Сопоставление полей​

Typeform отправляет ответы в виде массива. Используйте точечную нотацию: answers.0.email → email, answers.1.text → first_name.

JotForm​

Шаги настройки​

  1. Создайте подключение: Тип → JotForm.
  2. Скопируйте URL вебхука.
  3. В JotForm → Your Form → Settings → Integrations → Webhooks:
    • Вставьте URL вебхука.
    • Нажмите Complete Integration.
  4. JotForm отправляет поля формы с настроенными именами.

Сопоставление полей​

JotForm отправляет поля с ключами вида q1_fullName, q2_email, q3_phoneNumber. Сопоставьте их с полями LeadHub: q2_email → email и т.д.

Calendly​

Захватывайте лиды, которые бронируют встречи через Calendly.

Шаги настройки​

  1. Создайте подключение: Тип → Calendly.
  2. Скопируйте URL вебхука.
  3. В Calendly → Integrations → Webhooks → Create New Webhook:
    • Вставьте URL вебхука.
    • Выберите событие invitee.created.
    • Выберите типы событий для мониторинга.
  4. При бронировании встречи Calendly отправляет: first_name, last_name, email, questions_and_answers.

Веб-форма LeadHub​

При отправке формы, созданной в конструкторе форм LeadHub, лид создаётся автоматически — настройка вебхука не требуется. Смотрите Form Builder.

Email (IMAP)​

Захватывайте лиды из входящих писем в отслеживаемый почтовый ящик.

Шаги настройки​

  1. Создайте отдельный email для захвата лидов (например, [email protected]).
  2. Перейдите в Интеграции → Источники лидов и создайте подключение: Тип → Email (IMAP).
  3. Введите:
    • IMAP Host — ваш почтовый сервер
    • IMAP Port — обычно 993 (SSL) или 143
    • Username — email-адрес
    • Password — пароль
    • Folder — обычно INBOX
  4. LeadHub проверяет ящик каждые 5 минут (через cron) и создаёт лид из каждого нового письма.

Ручной ввод​

Создавайте лиды непосредственно в LeadHub без внешних интеграций. Перейдите в Лиды → Все лиды → Новый лид.

Универсальный вебхук (любая платформа)​

Для любой неперечисленной платформы используйте тип подключения Generic Webhook. Вы получаете URL, принимающий любой JSON, и настраиваете сопоставление полей.

curl -X POST https://yourdomain.com/inbound/YOURTOKEN \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","first_name":"Test","last_name":"Lead","phone":"+1555000000"}'