Использование WebHooks

Вебхук (WebHook) — способ сообщить вашей системе о новой заявке: после отправки формы LeadPlan делает HTTP-запрос на адрес вашего скрипта-обработчика. Чтобы включить вебхук, укажите адрес обработчика в разделе «Интеграции» виджета:

Как выглядит запрос#

• Метод — POST на указанный адрес.
• Тело — application/x-www-form-urlencoded в кодировке UTF-8. Это не JSON.
• Заголовок User-Agent: DashaWidgets/1.0 (+https://dashamail.ru).

Какие данные приходят#

В PHP значения доступны так: $_POST['data']['email']['value'], $_POST['environment']['tool_id'].

Пример запроса после декодирования:

data[email][name]=E-mail
data[email][value]=ivan@example.ru
data[phone][name]=Телефон
data[phone][value]=+7 (916) 123-45-67
data[name][name]=Имя
data[name][value]=Иван
environment[visitor_key]=3f2b8c1e-5a7d-4e2b-9c41-0d6f8a2b7e15
environment[visitor_ipaddress]=203.0.113.10
environment[visitor_country]=Россия
environment[visitor_region]=Москва
environment[visitor_city]=Москва
environment[visitor_locale]=ru-RU
environment[visitor_browserinfo]=
environment[visitor_browser_type]=Chrome 141.0.0.0
environment[visitor_device_type]=desktop
environment[visitor_device_os]=windows
environment[utm_source]=yandex
environment[utm_medium]=cpc
environment[utm_campaign]=autumn
environment[utm_term]=
environment[utm_content]=
environment[site_id]=100123
environment[tool_id]=88801
environment[tool_name]=Поп-ап: скидка 10%
environment[referer]=https://yandex.ru/
environment[url]=https://example.ru/catalog/?utm_source=yandex
environment[submit_date]=2026-11-03 14:05:12

Минимальный обработчик на PHP:

<?php
$email  = $_POST['data']['email']['value'] ?? '';
$toolId = $_POST['environment']['tool_id'] ?? '';
// сохраните заявку в свою CRM или базу
http_response_code(200);

Какой ответ ждёт LeadPlan#

Подойдёт любой ответ с кодом 2xx, тело ответа не разбирается.

• Ожидание соединения — 5 секунд, всего запроса — 10 секунд.
• По редиректам LeadPlan не переходит, сертификат HTTPS проверяется.

Повторы#

Заявки отправляются асинхронно через очередь. Всего 5 попыток, паузы между ними — 1, 2, 4 и 8 минут. Если все попытки неудачны, заявка получает статус «не доставлена». Повторно отправить такую заявку из личного кабинета нельзя, поэтому следите, чтобы обработчик был доступен. Сами данные посетителя при этом не теряются: они сохраняются в разделе «Пользователи», откуда их можно выгрузить.

Защита вебхука#

Подписи запроса нет: ни HMAC, ни секретного заголовка. Если обработчику нужна проверка, добавьте свой токен в адрес вебхука — адрес отправляется как есть:

https://example.ru/hook?token=<ваш секрет>

Повторные заявки#

Уникального ID заявки в запросе нет. Если обработчик успел сохранить заявку, но ответил после таймаута, повторная попытка привезёт её ещё раз. Отсеивать дубли можно по сочетанию visitor_key, tool_id и submit_date.

Данные посетителя в коде виджета#

Если нужно добавить к заявке данные, которых нет в форме (например, город посетителя или значение со страницы), сделайте это в коде виджета через событие lpTool.beforeSubmit. Подробнее — в статье «Тонкая настройка формы в поп-апе».

Если что-то не получилось, напишите в поддержку: contact@leadplan.ru.