вебхук

Вебхук (webhook) — это механизм автоматической передачи данных от одного сервиса к другому по HTTP-запросу в момент наступления определённого события. Система-источник сама инициирует передачу, не ожидая, пока её спросят — это делает интеграции быстрыми и ресурсоэффективными.

Как работает вебхук

Принцип прост: вы регистрируете в системе-источнике URL вашего сервера (endpoint). Когда происходит событие — оплата, заявка, смена статуса — источник отправляет POST-запрос с данными на этот URL. Ваш сервер получает пакет, обрабатывает и отвечает кодом 200 OK. Если ответа нет — большинство систем повторяют попытку по расписанию.

• Источник события: CRM, платёжная система, маркетплейс, форма на сайте
• Триггер: оплата, регистрация, изменение статуса заказа, входящее сообщение
• Получатель: ваш сервер, Zapier, Make, n8n, собственный микросервис
• Формат данных: как правило JSON или XML в теле POST-запроса

Зачем вебхуки бизнесу

Вебхуки — основа автоматизации без постоянного ручного контроля. Они позволяют выстроить сквозные процессы: от получения лида до его попадания в CRM, постановки задачи менеджеру и отправки приветственного письма — всё за секунды и без участия человека.

• Скорость реакции: данные передаются мгновенно, а не по расписанию раз в N минут
• Экономия ресурсов: нет необходимости в циклическом опросе API — нагрузка на сервер минимальна
• Гибкость интеграций: один вебхук может запускать цепочку действий в нескольких системах одновременно
• Масштабируемость: количество событий растёт — логика остаётся прежней, меняются только данные

Частые ошибки при работе с вебхуками

• Нет проверки подписи (secret token). Без верификации источника любой может отправить фиктивные данные на ваш endpoint — критическая уязвимость в платёжных процессах.
• Отсутствие идемпотентности. Если источник отправит один и тот же вебхук дважды (сбой сети, таймаут), обработчик должен распознать дубль и не выполнить действие повторно.
• Долгая синхронная обработка. Если ваш endpoint обрабатывает запрос дольше 3–5 секунд, источник засчитывает таймаут и повторяет отправку. Правильно: ответить 200 OK мгновенно, обработку — в очередь.
• Нет логирования входящих запросов. Без истории вебхуков отладить сбой интеграции почти невозможно.
• Открытый HTTP вместо HTTPS. Данные клиентов в незашифрованном виде — нарушение и репутационный риск.

Вебхуки в экосистеме Divitio

В проектах Divitio вебхуки применяются как ключевой инструмент CRM-интеграций и автоматизации маркетинга. Мы настраиваем приём вебхуков от рекламных систем, форм и платёжных шлюзов, связываем их с CRM-процессами и AI-агентами, обеспечиваем логирование и мониторинг доставки. Это позволяет клиентам получать актуальные данные о лидах и сделках в режиме реального времени без ручного переноса информации между сервисами.