Webhook

Вебхук (webhook) — это HTTP-обратный вызов, который автоматически отправляет данные из одного приложения в другое при наступлении определённого события. В отличие от [API](/glossary/api), где необходимо опрашивать (polling) для получения обновлений, вебхуки проталкивают данные в реальном времени по мере возникновения событий. Принимающее приложение прослушивает указанный URL-эндпоинт и обрабатывает входящие данные немедленно. Вебхуки следуют модели «издатель-подписчик»: приложение-источник отправляет HTTP POST-запрос на заранее зарегистрированный URL при каждом событии-триггере, а подписчик обрабатывает полезную нагрузку без необходимости запрашивать её.

Вебхуки устраняют необходимость в ручном переносе данных или постоянном опросе между системами. Для цифровых издателей это означает, что захваченные лиды, продажи и активность просмотров могут автоматически поступать в CRM, платформы email-маркетинга или внутренние базы данных в момент их возникновения. Задержки сокращаются с минут или часов до миллисекунд, устраняется ручная работа по экспорту-импорту, и бизнес-системы всегда содержат актуальные данные. Без вебхуков командам приходится вручную проверять дашборды или создавать пакетные процессы, отстающие от событий реального времени.

Функция [автоматизации и интеграций](/features/automation-and-integrations) FlipLink поддерживает вебхуки, которые срабатывают при ключевых событиях. Вы можете настроить эндпоинты вебхуков для получения данных при захвате нового лида, просмотре документа или завершении продажи через Stripe. Каждый вебхук отправляет структурированную JSON-полезную нагрузку с деталями события на указанный URL. Это позволяет подключить FlipLink практически к любой системе, включая Zapier, Make или собственные бэкенды. В сочетании с [интеграцией Google Sheets](/features/automation-and-integrations) вебхуки предоставляют издателям гибкий способ автоматизировать весь рабочий процесс без написания кода.

При наступлении события-триггера FlipLink отправляет HTTP POST-запрос на зарегистрированный URL эндпоинта. Тело запроса содержит JSON-полезную нагрузку следующей структуры: - **Тип события** — строка, идентифицирующая событие (например, `lead.captured`, `document.viewed`, `sale.completed`) - **Временная метка** — дата и время события в формате ISO 8601 - **Данные полезной нагрузки** — поля, специфичные для события: имя контакта, email, название документа или сумма транзакции Ваш эндпоинт должен вернуть HTTP-статус 200 для подтверждения получения. Если эндпоинт возвращает ошибку или происходит таймаут, FlipLink повторяет доставку, чтобы гарантировать отсутствие потерь. Все полезные нагрузки вебхуков отправляются по [HTTPS](/glossary/https), поэтому данные шифруются при передаче. Для разработчиков, создающих пользовательские интеграции, последовательная структура JSON упрощает разбор и маршрутизацию событий к нужному обработчику в приложении.

1. **Подготовьте эндпоинт.** Настройте HTTPS URL на вашем сервере, в Zapier, Make или любом сервисе, способном принимать POST-запросы. Эндпоинт должен быть публично доступен и возвращать ответ 200. 2. **Перейдите к интеграциям.** В панели управления FlipLink откройте настройки [автоматизации и интеграций](/features/automation-and-integrations) вашей публикации. 3. **Добавьте URL вебхука.** Вставьте URL вашего эндпоинта в поле настройки вебхука. 4. **Выберите события-триггеры.** Укажите, какие события должны запускать вебхук — захват лида, просмотр документа, завершение продажи или другие в зависимости от ваших потребностей. 5. **Отправьте тестовое событие.** Используйте функцию тестирования для отправки примера полезной нагрузки на ваш эндпоинт. Убедитесь, что система корректно получает и обрабатывает данные. 6. **Запустите в работу.** Сохраните конфигурацию. С этого момента каждое подходящее событие во флипбуке будет запускать POST-запрос в реальном времени на ваш эндпоинт. 7. **Мониторьте доставку.** Периодически проверяйте логи эндпоинта для подтверждения получения вебхуков. При обнаружении пробелов проверьте, что эндпоинт возвращает ответы 200 и что на сервере нет правил файрвола, блокирующих запросы FlipLink.

| Аспект | Вебхук | API-опрос | |--------|--------|-----------| | **Доставка данных** | Автоматическая отправка при событиях | Запрос по заданному расписанию | | **Задержка** | Почти мгновенная (миллисекунды) | Зависит от интервала опроса (секунды — минуты) | | **Нагрузка на сервер** | Минимальная — запросы только при событиях | Выше — запросы в каждом интервале, даже без изменений | | **Реализация** | Зарегистрировать URL и обрабатывать входящие POST-запросы | Создать запланированное задание, регулярно вызывающее API | | **Оптимально для** | Уведомления в реальном времени, синхронизация CRM, мгновенные оповещения | Пакетная обработка, периодические отчёты, снимки данных | | **Риск** | При недоступности эндпоинта возможна потеря событий без логики повтора | Без потерь при своевременном опросе, но запоздалое обнаружение | Для большинства издателей FlipLink вебхуки — лучший выбор для событий захвата лидов и продаж, где важна скорость. API-опрос лучше подходит для периодических выгрузок аналитики или дашбордов, обновляемых через фиксированные интервалы. Многие команды используют оба варианта: вебхуки для маршрутизации лидов в реальном времени и [REST API](/glossary/rest-api) для ночных выгрузок аналитики.