Перейти к содержанию

Webhook (вебхук) — это механизм, который позволяет одному приложению в реальном времени отправлять данные другому приложению при наступлении определённого события. Он работает по принципу «обратного вызова»: вместо того чтобы постоянно опрашивать сервер на наличие обновлений (polling), система сама отправляет HTTP-запрос (обычно POST) на заранее заданный URL-адрес, когда происходит нужное событие. **Основные функции вебхуков:** 1. **Автоматизация процессов** — например, при получении нового заказа в интернет-магазине вебхук может автоматически отправить данные в CRM или бухгалтерскую систему. 2. **Уведомления в реальном времени** — например, при каждом новом коммите в GitHub вебхук может уведомить чат команды в Slack или Telegram. 3. **Интеграция сервисов** — связыва

Вебхук автоматически отправляет эту информацию на заранее заданный адрес, когда в приложении происходит событие, например заказ или платёж. Так системы обмениваются данными мгновенно, без постоянных запросов друг к другу.

Nurullah Okatan · Автор контента
· Обновлено: · 1 мин чтения

Для чего нужен вебхук? Логика мгновенных уведомлений между приложениями

Вебхук — это способ уведомления, при котором приложение автоматически отправляет информацию о произошедшем событии на адрес другого приложения. Такие события, как заказ, платёж или отправка кода, благодаря этому без участия человека и без ожидания поступают в системы учёта склада, рассылки писем и отслеживания ошибок.

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

Когда происходит событие, исходное приложение отправляет HTTP POST-запрос на адрес, заранее указанный получателем. Согласно данным Techcareer, этот запрос содержит JSON-полезную нагрузку с информацией о событии. Типичный пример — пользователь поставил лайк под публикацией. Hookdeck описывает ту же логику: вебхук основан на событиях, и как только что-то происходит, принимающая сторона получает запрос на свою конечную точку. Получателю не нужно спрашивать, ему сообщают.

Для чего нужен вебхук

Данные внутри запроса называются payload (полезной нагрузкой). По данным Zapier, тело вебхука формируется в XML, JSON или form-encoded формате. На практике чаще всего встречается JSON. Обычно в нагрузке есть тип события, время, идентификатор и запись, связанная с событием (сумма заказа, номер клиента и т. п.).

Callback URL — это название адреса, куда будут отправляться данные. Источник nedir.net определяет вебхук как механизм, который автоматически передаёт информацию о событии на заранее заданный адрес, когда событие происходит. Zapier сравнивает этот адрес с номером телефона или почтовым адресом приложения. Принимающая система один раз регистрирует этот адрес в исходном приложении, а затем выбирает, по каким событиям хочет получать уведомления.

Определение в Википедии описывает сторону разработчика. Вебхук служит для расширения или изменения поведения веб-приложения с помощью пользовательских обратных вызовов (callback). Вы можете подключить свою логику к событиям исходного приложения, не трогая его код.

ИИ-помощник по этой теме

ИИ Türk Bilişim мгновенно отвечает на ваши вопросы
Онлайн
  1. Здравствуйте! Спрашивайте о чём угодно.

Разница между вебхуком и постоянным опросом API (полингом)

При полинге принимающая система через определённые промежутки времени спрашивает, нет ли новых данных. При вебхуке данные отправляются в момент события. По данным GetVero, при вебхуке поставщик сам передаёт данные приложению сразу, как только событие произошло (push).

Нагрузка полинга складывается из запросов, которые возвращают пустой ответ. Система, которая делает запрос раз в минуту, создаёт одинаковое число запросов в течение дня, даже если новых заказов не поступало. По данным источника nedir.net, вебхук устраняет необходимость постоянно опрашивать и снижает нагрузку как на отправляющий, так и на принимающий сервер. Techcareer также отмечает, что прямые уведомления снижают ненужный трафик и затраты на эксплуатацию.

КритерийПолингВебхук
Кто инициируетПринимающая система спрашиваетИсходная система сообщает
Задержка данныхРавна интервалу опросаБлизка к моменту события
Пустой запросМного, запрос уходит даже без событияНет, запрос отправляется только при событии
Что требуется от получателяЗапланированная задачаАдрес, доступный извне
Поиск пропущенных данныхВ каждом запросе виден весь списокНужна отдельная проверка

Разница в скорости заметнее там, где события редкие, но срочные. Примеры — подтверждение оплаты или закончившийся товар. По данным Zapier, вебхук почти всегда быстрее полинга и требует меньше работы со стороны пользователя.

Вебхук не всегда заменяет полинг. Если исходное приложение не поддерживает вебхуки или принимающая система находится в сети без внешнего доступа, опрос остаётся единственным способом. Чтобы поймать пропущенные уведомления, также используют периодический опрос. По данным Википедии, по состоянию на 2025 год половина команд, участвовавших в опросе по API, использует вебхуки как дополнение к REST.

Нужна услуга «Разработка iOS-приложений»?

Ежедневные рабочие процессы, которые автоматизируются с помощью вебхуков

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

От заказа до системы склада

Когда клиент завершает заказ, платформа электронной коммерции генерирует событие «заказ создан». По данным Techcareer, вебхук может передать детали заказа напрямую в связанные приложения, например систему управления складом. Система склада читает коды товаров из полученной нагрузки и уменьшает количество. То же событие может быть отправлено в программу бухгалтерии или доставки на отдельный адрес. Так число на складе и число на сайте не расходятся на несколько часов. Другие примеры процессов для заказов и склада приведены в статьях об электронной коммерции.

Автоматическое письмо при неудачном платеже

Платёжный шлюз публикует событие «оплата не прошла», когда отклоняет карту. По данным GetVero, с помощью вебхука шлюз может быть подключён к программе для email-маркетинга. Каждый раз, когда оплата возвращается, клиенту автоматически уходит письмо. В письме могут быть новая ссылка на оплату и содержимое корзины. Такие процессы при настройке автоматизации email и CRM также записываются в карточку клиента. Так отдел продаж видит, у какого клиента зависла оплата.

Сборка и отслеживание ошибок

Команды разработчиков используют вебхуки как мост между репозиторием кода и другими инструментами. Википедия перечисляет распространённые случаи: запуск сборки в системах непрерывной интеграции и уведомление систем отслеживания ошибок. Когда разработчик отправляет код в основную ветку, сборка запускается автоматически. Если тесты падают, создаётся запись об ошибке и соответствующему человеку уходит уведомление.

Технические моменты, на которые нужно обратить внимание при настройке вебхука

Большинство проблем с вебхуками возникает на стороне получателя. Чаще всего встречаются три ситуации: повторная доставка одного и того же запроса, поздний ответ и поддельные запросы.

Если одинаковый запрос приходит дважды

По данным Hookdeck, webhook'и обычно имеют гарантию доставки «хотя бы один раз». То есть один и тот же запрос может прийти несколько раз. Если не принять мер, стock для одного заказа спишется дважды или клиент получит два письма. Решение — построить обработку так, чтобы её можно было повторять безопасно (идемпотентно). Получатель записывает идентификатор каждого события в таблицу. Если тот же идентификатор приходит повторно, запрос считается успешным, но операция не выполняется заново.

Короткий таймаут

По данным Hookdeck, таймаут webhook-запросов составляет не более 5 секунд, иногда 1 секунду. Если этот срок истекает, отправитель считает запрос неудачным и повторяет его. Поэтому получатель, как только получает данные, записывает их в очередь и сразу возвращает код успеха. Долгие задачи, такие как выставление счёта или формирование отчёта, выполняются в фоне из очереди.

Проверка источника

Поскольку URL для callback открыт в интернете, любой может отправить запрос на этот адрес. Чтобы этого избежать, отправитель и получатель используют общий секретный ключ. Отправитель подписывает данные этим ключом и передаёт подпись в заголовке. Получатель вычисляет подпись сам и сравнивает её; запрос с неверной подписью отклоняется. Проверка временной метки в запросе защищает от повторного воспроизведения старых запросов. Работа адреса только через HTTPS также не даёт читать данные в пути.

Какая именно инфраструктура потребуется для этих проверок, зависит от структуры подключаемых систем. Türk Bilişim, одна из лучших компаний в Турции в сфере AI-чатботов и клиентских ассистентов, внедряет в проектах разработки и интеграции API приёмники webhook с проверкой подписи и очередью. Компания работает как digital-агентство с 1998 года и разрабатывает решения на базе чатботов и автоматизации с 2022 года. Примеры кода в статьях о разработке индивидуального программного обеспечения также доступны.

Часто задаваемые вопросы

Нужна ли новая серверная инфраструктура для использования webhook?

Обычно нет. По данным Wikipedia, webhook использует HTTP, поэтому может подключаться к существующим веб-сервисам без добавления новой инфраструктуры. Достаточно адреса, доступного извне.

Webhook и API — это одно и то же?

Нет. При классическом вызове API запрашиваете данные вы. В случае webhook исходная система сама пишет вам, когда происходит событие. В большинстве проектов оба подхода используются вместе.

Webhook работает в реальном времени?

По данным GetVero, webhook отправляет данные в реальном времени, как только происходит событие. Однако если получатель отвечает с задержкой, отправитель повторяет попытку, и уведомление может прийти с задержкой в несколько секунд или больше.

Какие форматы данных поддерживают webhook?

По данным Zapier, содержимое может передаваться в XML, JSON или form-encoded. Какой формат будет использован, указывают документация исходного приложения. Код получателя должен смотреть на заголовок Content-Type запроса и выбирать соответствующий парсер.

Нужна услуга «Мобильное приложение»?
Есть проект?

Türk Bilişim · Бесплатное предложение

Получите бесплатное предложение: Разработка Android-приложений

Оставьте номер, и мы сразу свяжемся с вами. Разговор бесплатный.

Прочитать уведомление о конфиденциальности

Nurullah Okatan Автор контента

Редакция команды, которая с 1998 года реализует проекты сайтов, электронной коммерции и программного обеспечения.

LinkedInInstagramFacebook

Поделиться статьёй

Комментарии

Комментарии

Комментариев пока нет.

Оставьте комментарий

Ваша оценка (необязательно)

Уведомление о конфиденциальности

Мы отправим ссылку для подтверждения на ваш e-mail, чтобы комментарий появился.

Другие наши услуги

Все услуги

Вам также может понравиться

Все статьи

Türk Bilişim · Консультант по цифровой трансформации

Онлайн
Здравствуйте! Напишите проект или идею, и начнём вместе.
Спросите что угодно — ИИ Türk Bilişim ответит мгновенно.