Обсудить задачу
викиии · интеграции

Webhook (вебхук)

Webhook (вебхук) – способ, которым одна система сообщает другой, что произошло событие: в момент события она сама отправляет HTTP-запрос на указанный вами адрес и передаёт данные. Обычный запрос к API работает наоборот – вы спрашиваете и ждёте ответа. Вебхук переворачивает схему: не спрашивайте, вам сообщат.

Так устроены почти все интеграции: платёжный сервис сообщает об оплате, форма на сайте – о новой заявке, мессенджер – о входящем сообщении, CRM – о смене стадии сделки. Телеграм-боты в проде живут именно на вебхуках, а не на постоянном опросе сервера.

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

О чём помнить: нужен постоянно доступный адрес с HTTPS, поэтому на локальной машине вебхук без туннеля не поднять. Доставка не гарантирована: отправитель повторяет неудачные попытки, из-за чего одно событие может прийти дважды – обработчик обязан быть устойчивым к повторам. И адрес вебхука публичен, так что подлинность запроса проверяют подписью или секретом.

связанные термины