Интеграция через Webhook
Webhook — это универсальный способ отправки данных в любой сервис, который умеет их принимать. Это может быть CRM (amoCRM, SberCRM), сервис автоматизации (Zapier, Make, n8n), Google Sheets или ваш собственный сервер.
Как это работает
Ссылка на раздел «Как это работает»Когда посетитель отправляет форму, Поптимайзер делает HTTP-запрос на указанный вами URL с данными формы. Принимающий сервис обрабатывает эти данные: создаёт сделку, добавляет строку в таблицу, отправляет email — зависит от настроек на стороне сервиса.
Что понадобится
Ссылка на раздел «Что понадобится»- URL для приёма данных (получите в сервисе, с которым интегрируетесь)
- 5 минут времени
Настройка интеграции
Ссылка на раздел «Настройка интеграции»Шаг 1. Получите URL для приёма данных
Ссылка на раздел «Шаг 1. Получите URL для приёма данных»Этот 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. Создайте интеграцию в Поптимайзер»-
Откройте попап в редакторе
-
Нажмите «Сбор данных» в левой панели
-
В разделе «Создать новую» выберите «Webhook»
-
Заполните форму:
- Название — как интеграция будет отображаться (например, «amoCRM» или «Zapier → Google Sheets»)
- Куда отправлять заявки — адрес для отправки данных
- Как разложить данные — вид данных (см. ниже); если в инструкции сервиса не сказано иначе, оставьте первый вариант
Способ отправки (POST или PUT) спрятан в блоке «Дополнительно — для разработчиков». Почти всегда нужен POST — он выбран по умолчанию.
-
Нажмите «Создать»
Шаг 3. Протестируйте
Ссылка на раздел «Шаг 3. Протестируйте»- Нажмите кнопку «Отправить тестовую заявку» (значок ▶) на карточке интеграции в списке «Привязанные»
- Проверьте, что данные дошли до сервиса
Формат отправляемых данных
Ссылка на раздел «Формат отправляемых данных»По умолчанию (вариант «Поля заявки отдельным блоком») данные отправляются в формате JSON:
{
"popupId": "abc123",
"timestamp": "2025-01-26T15:30:00.000Z",
"data": {
"email": "ivan@example.com",
"name": "Иван Иванов",
"phone": "+7 999 123-45-67"
}
}Плоский формат
Ссылка на раздел «Плоский формат»Некоторые сервисы лучше работают с «плоскими» данными (без вложенности). Выберите вариант «Все поля одним списком» в настройке «Как разложить данные»:
{
"popupId": "abc123",
"timestamp": "2025-01-26T15:30:00.000Z",
"email": "ivan@example.com",
"name": "Иван Иванов",
"phone": "+7 999 123-45-67"
}Кастомный формат
Ссылка на раздел «Кастомный формат»Если сервис требует особую структуру данных, откройте блок «Дополнительно — для разработчиков», отметьте «Собрать 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 рядом с полями формы:
{
"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 видно, что меток не было, а не что передача выключена.
В варианте «Все поля одним списком» метки приходят рядом с полями формы:
{
"popupId": "abc123",
"timestamp": "2025-01-26T15:30:00.000Z",
"email": "ivan@example.com",
"name": "Иван Иванов",
"utm_source": "yandex",
"utm_campaign": "black_friday"
}Блок «Вот так придут данные» показывает пример меток, чтобы вы видели, где они окажутся.
Метки в своих полях и в своём JSON
Ссылка на раздел «Метки в своих полях и в своём JSON»Метку можно отправить и под своим именем — в блоке «Добавить свои поля». Кнопки «Источник (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 в тесте придёт пустым, а свои поля с метками — пустыми.
Дополнительные заголовки
Ссылка на раздел «Дополнительные заголовки»Некоторые сервисы требуют авторизацию или специальные заголовки. Добавьте их в блоке «Дополнительно — для разработчиков», раздел «Заголовки запроса»:
| Заголовок | Значение |
|---|---|
| Authorization | Bearer your-api-token |
| X-API-Key | your-api-key |
| Content-Type | application/json |
Примечание: Заголовок Content-Type: application/json добавляется автоматически.
Превью данных
Ссылка на раздел «Превью данных»Перед созданием интеграции вы можете посмотреть, какие данные будут отправляться. Блок «Вот так придут данные» показывает пример запроса на полях вашего попапа; его можно скопировать кнопкой «Скопировать».
Эта информация поможет правильно настроить приём данных на стороне сервиса.
Проверка маппинга полей
Ссылка на раздел «Проверка маппинга полей»Когда вы собираете JSON вручную, под шаблоном появляется блок «Маппинг полей». Он автоматически проверяет, что переменные из шаблона совпадают с полями формы в попапе:
- Совпадающие поля (зелёная точка) — переменная найдена в форме попапа. Данные будут подставлены корректно.
- Отсутствующие поля (оранжевое предупреждение) — переменная указана в шаблоне, но такого поля нет в попапе. При отправке вместо данных будет пустое значение.
- Неиспользуемые поля (сворачиваемый список) — поля есть в форме попапа, но не упомянуты в шаблоне. В запрос они не попадут: при своём JSON отправляется только то, что есть в шаблоне.
Совет:
Проверяйте маппинг перед сохранением, чтобы убедиться, что все нужные данные попадут в вебхук. Оранжевые предупреждения означают, что переменная не найдена в форме попапа.
Примеры интеграций
Ссылка на раздел «Примеры интеграций»- В amoCRM перейдите в Настройки → Интеграции → Webhooks
- Создайте входящий вебхук
- Скопируйте URL и вставьте в Поптимайзер
- Настройте маппинг полей в amoCRM
Битрикс24
Ссылка на раздел «Битрикс24»Для Битрикс24 вебхук не нужен: есть отдельная интеграция, которая сама создаёт лид Битрикс24 или сделку с контактом (тариф Бизнес). Подробнее — в статье Битрикс24: подключение и настройка.
GetCourse
Ссылка на раздел «GetCourse»Для GetCourse вебхук не нужен: есть отдельная интеграция, которая сама создаёт пользователя GetCourse и добавляет его в группы (тариф Бизнес). Подробнее — в статье GetCourse: подключение и настройка.
Google Sheets (через Zapier)
Ссылка на раздел «Google Sheets (через Zapier)»- Создайте Zap: Webhooks → Google Sheets
- Используйте URL из Zapier
- Настройте маппинг колонок
Отладка
Ссылка на раздел «Отладка»Данные не приходят
Ссылка на раздел «Данные не приходят»- Проверьте URL — он должен быть полным (начинаться с
https://) - Нажмите «Отправить тестовую заявку» (значок ▶) и проверьте результат
- Посмотрите логи на стороне принимающего сервиса
Ошибка авторизации (401, 403)
Ссылка на раздел «Ошибка авторизации (401, 403)»Проверьте заголовки авторизации. Возможно, нужно добавить API-ключ или токен.
Неправильный формат данных
Ссылка на раздел «Неправильный формат данных»Попробуйте другой вид данных («Все поля одним списком» или свой JSON). Посмотрите документацию сервиса — какую структуру он ожидает.
Безопасность
Ссылка на раздел «Безопасность»- Токены и ключи в заголовках хранятся в зашифрованном виде
- Указывайте адрес, который начинается с
https://, — тогда данные защищены при передаче - URL вебхука не виден посетителям сайта
Доступность
Ссылка на раздел «Доступность»Webhook-интеграция доступна на тарифах Про и Бизнес.
Нужна помощь с настройкой конкретного сервиса? Напишите на support@poptimizer.ru — мы составим пошаговую инструкцию для вашего случая или добавим нативную интеграцию.
Следующие шаги:
- Настройка Telegram — мгновенные уведомления