Перейти к содержанию
Разделы документации

Интеграция через Webhook

Webhook — это универсальный способ отправки данных в любой сервис, который умеет их принимать. Это может быть CRM (amoCRM, SberCRM), сервис автоматизации (Zapier, Make, n8n), Google Sheets или ваш собственный сервер.

Когда посетитель отправляет форму, Поптимайзер делает HTTP-запрос на указанный вами URL с данными формы. Принимающий сервис обрабатывает эти данные: создаёт сделку, добавляет строку в таблицу, отправляет email — зависит от настроек на стороне сервиса.

  • URL для приёма данных (получите в сервисе, с которым интегрируетесь)
  • 5 минут времени

Этот URL вы получаете в сервисе, с которым хотите интегрироваться:

  • Zapier — создайте Zap с триггером «Webhooks by Zapier» → «Catch Hook»
  • Make (Integromat) — создайте сценарий с модулем «Webhooks» → «Custom Webhook»
  • n8n — добавьте ноду «Webhook»
  • CRM — посмотрите в документации раздел «Входящие вебхуки» или «API»

Примеры URL:

Код
https://hooks.zapier.com/hooks/catch/123456/abcdef/
https://hook.eu1.make.com/abcdefghijklmnop
https://your-n8n.com/webhook/form-data

Шаг 2. Создайте интеграцию в Поптимайзер

Ссылка на раздел «Шаг 2. Создайте интеграцию в Поптимайзер»
  1. Откройте попап в редакторе

  2. Нажмите «Сбор данных» в левой панели

  3. В разделе «Создать новую» выберите «Webhook»

  4. Заполните форму:

    • Название — как интеграция будет отображаться (например, «amoCRM» или «Zapier → Google Sheets»)
    • Куда отправлять заявки — адрес для отправки данных
    • Как разложить данные — вид данных (см. ниже); если в инструкции сервиса не сказано иначе, оставьте первый вариант

    Способ отправки (POST или PUT) спрятан в блоке «Дополнительно — для разработчиков». Почти всегда нужен POST — он выбран по умолчанию.

  5. Нажмите «Создать»

  1. Нажмите кнопку «Отправить тестовую заявку» (значок ▶) на карточке интеграции в списке «Привязанные»
  2. Проверьте, что данные дошли до сервиса

По умолчанию (вариант «Поля заявки отдельным блоком») данные отправляются в формате JSON:

JSON
{
  "popupId": "abc123",
  "timestamp": "2025-01-26T15:30:00.000Z",
  "data": {
    "email": "ivan@example.com",
    "name": "Иван Иванов",
    "phone": "+7 999 123-45-67"
  }
}

Некоторые сервисы лучше работают с «плоскими» данными (без вложенности). Выберите вариант «Все поля одним списком» в настройке «Как разложить данные»:

JSON
{
  "popupId": "abc123",
  "timestamp": "2025-01-26T15:30:00.000Z",
  "email": "ivan@example.com",
  "name": "Иван Иванов",
  "phone": "+7 999 123-45-67"
}

Если сервис требует особую структуру данных, откройте блок «Дополнительно — для разработчиков», отметьте «Собрать JSON вручную» и впишите свой шаблон:

JSON
{
  "lead": {
    "email": "{{data.email}}",
    "name": "{{data.name}}",
    "phone": "{{data.phone}}"
  },
  "source": "poptimizer",
  "campaign": "landing_page"
}

Переменные в двойных фигурных скобках заменятся на реальные данные. Кроме полей формы {{data.имя_поля}} доступны {{popupId}}, {{domain}} (сайт), {{pageUrl}} (адрес страницы), {{popupName}} (название попапа), {{timestamp}} (дата и время заявки по Гринвичу, в том же виде, что поле timestamp выше) и метки посетителя под своими именами: {{utm_source}}, {{utm_campaign}}, {{yclid}} и другие. Часовой пояс организации на время в вебхуке не влияет.

Метки посетителя — UTM-метки и идентификаторы клика (yclid, gclid и другие), с которыми человек пришёл на сайт. По ним в CRM видно, из какой рекламы пришла заявка. Какие метки сохраняются и какие получает заявка, рассказывает статья Интеграции, раздел «Метки посетителя в заявке».

Настройка «Передавать метки посетителя»

Ссылка на раздел «Настройка «Передавать метки посетителя»»

Отметьте «Передавать метки посетителя» в настройках вебхука, и метки придут вместе с полями формы. У нового вебхука настройка включена сразу. Вебхук, созданный раньше, метки не передаёт, пока вы не включите настройку: откройте интеграцию кнопкой «Просмотреть / редактировать» и отметьте её. При просмотре интеграции строка «Метки посетителя» показывает, включена ли настройка: «Передаются» или «Не передаются».

В варианте «Поля заявки отдельным блоком» метки приходят блоком utm рядом с полями формы:

JSON
{
  "popupId": "abc123",
  "timestamp": "2025-01-26T15:30:00.000Z",
  "data": {
    "email": "ivan@example.com",
    "name": "Иван Иванов"
  },
  "utm": {
    "utm_source": "yandex",
    "utm_medium": "cpc",
    "utm_campaign": "black_friday",
    "yclid": "1234567890"
  }
}

Если посетитель пришёл без меток, блок utm придёт пустым. Так в CRM видно, что меток не было, а не что передача выключена.

В варианте «Все поля одним списком» метки приходят рядом с полями формы:

JSON
{
  "popupId": "abc123",
  "timestamp": "2025-01-26T15:30:00.000Z",
  "email": "ivan@example.com",
  "name": "Иван Иванов",
  "utm_source": "yandex",
  "utm_campaign": "black_friday"
}

Блок «Вот так придут данные» показывает пример меток, чтобы вы видели, где они окажутся.

Метку можно отправить и под своим именем — в блоке «Добавить свои поля». Кнопки «Источник (utm_source)», «Канал (utm_medium)», «Кампания (utm_campaign)», «Ключевое слово (utm_term)» и «Объявление (utm_content)» добавляют поле с именем без utm_: source, medium, campaign, term, content. Имя поля можно поменять. Если посетитель пришёл без метки, поле придёт пустым.

Если включена настройка «Передавать метки посетителя», метка может перезаписать своё поле. Тогда под полем появится предупреждение. В варианте «Все поля одним списком» так бывает, когда имя поля совпадает с меткой, например utm_source. В варианте «Поля заявки отдельным блоком» — когда поле называется utm.

Когда вы собираете JSON вручную, настройки «Передавать метки посетителя» нет. Поставьте нужные метки в шаблон переменными: {{utm_source}}, {{utm_campaign}}, {{yclid}}. Переменные меток работают без настройки.

Важно:

Тестовая отправка (значок ▶) уходит без меток посетителя: она попадает в вашу настоящую CRM. Блок utm в тесте придёт пустым, а свои поля с метками — пустыми.

Некоторые сервисы требуют авторизацию или специальные заголовки. Добавьте их в блоке «Дополнительно — для разработчиков», раздел «Заголовки запроса»:

ЗаголовокЗначение
AuthorizationBearer your-api-token
X-API-Keyyour-api-key
Content-Typeapplication/json

Примечание: Заголовок Content-Type: application/json добавляется автоматически.

Перед созданием интеграции вы можете посмотреть, какие данные будут отправляться. Блок «Вот так придут данные» показывает пример запроса на полях вашего попапа; его можно скопировать кнопкой «Скопировать».

Эта информация поможет правильно настроить приём данных на стороне сервиса.

Когда вы собираете JSON вручную, под шаблоном появляется блок «Маппинг полей». Он автоматически проверяет, что переменные из шаблона совпадают с полями формы в попапе:

  • Совпадающие поля (зелёная точка) — переменная найдена в форме попапа. Данные будут подставлены корректно.
  • Отсутствующие поля (оранжевое предупреждение) — переменная указана в шаблоне, но такого поля нет в попапе. При отправке вместо данных будет пустое значение.
  • Неиспользуемые поля (сворачиваемый список) — поля есть в форме попапа, но не упомянуты в шаблоне. В запрос они не попадут: при своём JSON отправляется только то, что есть в шаблоне.

Совет:

Проверяйте маппинг перед сохранением, чтобы убедиться, что все нужные данные попадут в вебхук. Оранжевые предупреждения означают, что переменная не найдена в форме попапа.


  1. В amoCRM перейдите в Настройки → Интеграции → Webhooks
  2. Создайте входящий вебхук
  3. Скопируйте URL и вставьте в Поптимайзер
  4. Настройте маппинг полей в amoCRM

Для Битрикс24 вебхук не нужен: есть отдельная интеграция, которая сама создаёт лид Битрикс24 или сделку с контактом (тариф Бизнес). Подробнее — в статье Битрикс24: подключение и настройка.

Для GetCourse вебхук не нужен: есть отдельная интеграция, которая сама создаёт пользователя GetCourse и добавляет его в группы (тариф Бизнес). Подробнее — в статье GetCourse: подключение и настройка.

  1. Создайте Zap: Webhooks → Google Sheets
  2. Используйте URL из Zapier
  3. Настройте маппинг колонок

  1. Проверьте URL — он должен быть полным (начинаться с https://)
  2. Нажмите «Отправить тестовую заявку» (значок ▶) и проверьте результат
  3. Посмотрите логи на стороне принимающего сервиса

Проверьте заголовки авторизации. Возможно, нужно добавить API-ключ или токен.

Попробуйте другой вид данных («Все поля одним списком» или свой JSON). Посмотрите документацию сервиса — какую структуру он ожидает.


  • Токены и ключи в заголовках хранятся в зашифрованном виде
  • Указывайте адрес, который начинается с https://, — тогда данные защищены при передаче
  • URL вебхука не виден посетителям сайта

Webhook-интеграция доступна на тарифах Про и Бизнес.


Нужна помощь с настройкой конкретного сервиса? Напишите на support@poptimizer.ru — мы составим пошаговую инструкцию для вашего случая или добавим нативную интеграцию.


Следующие шаги:

Статья помогла?

Обновлено . Нашли ошибку? Напишите на support@poptimizer.ru.