Перейти к основному содержимому
Mobius
Средний

Что такое вебхук (Webhook)

Другие названия: вебхук, веб-хук, Webhook, HTTP-колбэк

Определение

Вебхук (webhook) это автоматическое сообщение, которое система отправляет на ваш адрес в момент события, например оплаты. Спрашивать не нужно, она сообщит сама.

Почему это важно

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

Частые ошибки

Доверять вебхуку без проверки подписи: любой, кто узнал адрес, пришлет поддельный «платеж прошел».

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

Практический примерУсловный пример

Вебхук на бумаге: онлайн-семинар продает место

Куда отправлен

Адрес для уведомлений, который бизнес зарегистрировал у платежного провайдера.

Событие

Платеж прошел.

Ожидаемый ответ

200 OK за секунды.

Что внутри

  • Номер заказа
  • Результат платежа

Подтверждение отправителя

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

Шаги

  1. Клиент платит на странице оплаты.

  2. Платежный провайдер отправляет вебхук на адрес, который зарегистрировал бизнес: событие «платеж прошел» и номер заказа.

  3. Система бизнеса проверяет подпись и за секунды отвечает 200 OK.

  4. Она проверяет, что этот номер заказа еще не обрабатывался, потому что одно и то же событие может прийти дважды.

  5. Она вызывает API сервиса счетов, чтобы выставить счет, и отправляет подтверждение в WhatsApp со ссылкой на Zoom.

  6. Если на шаге 3 сервер не работал, провайдер повторит попытку позже, а оповещение о неудачных доставках предупредит команду.

Вебхук сообщил «это произошло», а работу сделали вызовы API.

Условный пример

Спрашивать снова и снова или получить одно сообщение

Опрос каждые 30 мин. Запросов за день: 21, из них с ответом «ничего нового»: 20. Платеж замечен с опозданием 23 мин. Вебхук отправил одно сообщение, в момент платежа.Платеж 11:07⁨Опрос: «есть что-то новое?»⁩⁨+23 мин⁩⁨Вебхук: провайдер сообщает сам⁩200 OK08:0013:0018:00

Опрос каждые 30 мин. Запросов за день: 21, из них с ответом «ничего нового»: 20. Платеж замечен с опозданием 23 мин. Вебхук отправил одно сообщение, в момент платежа.

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

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

Определение

Вебхук это HTTP-запрос, обычно POST, который система поставщика отправляет на зарегистрированный вами адрес каждый раз, когда происходит событие, на которое вы подписались. Из чего он состоит: адрес, который вы даете отправителю (endpoint), событие (например, «платеж прошел»), данные (обычно JSON), быстрый ответ, который должен вернуть ваш сервер (статус 2xx, например 200 OK), и подпись, которая подтверждает отправителя. Направление обратное обычному вызову API: через API спрашиваете вы, а с вебхуком к вам обращается другая система. Он заменяет опрос (polling), когда ваша система снова и снова спрашивает другую, нет ли чего нового. Обычно вебхук входит в API-продукт поставщика, а не противостоит ему. Термин придумал Джефф Линдси (Jeff Lindsay) в 2007 году, описывая HTTP POST-вызовы, которые задает сам пользователь.

Почему это важно

Это как SMS от банка в момент списания с карты, вместо того чтобы заходить в приложение и проверять. Израильские платежные провайдеры это документируют: у Tranzila это notify URL, который срабатывает на платежи через Bit, картой и постоянным поручением (хорат кева), а Grow (бывший Meshulam) отправляет вызов от сервера к серверу на адрес notifyUrl. Платформа WhatsApp Business от Meta тоже доставляет входящие сообщения и статусы отправленных в вашу систему через вебхук. Когда нужен отчет или список по запросу, спрашивают API, а если отправитель не поддерживает вебхуки, остается опрос.

Напрямую связано: API (интерфейс прикладного программирования), Сервер (Server), Облачные вычисления (Cloud Computing).

Советы по улучшению

  • Отвечайте 200 OK сразу, а медленную работу делайте потом, через очередь, чтобы отправитель не перестал ждать и не повторил отправку.
  • Проверяйте подпись каждого входящего вебхука, прежде чем что-то делать.
  • Сохраняйте идентификатор каждого события и пропускайте уже обработанные, чтобы повторная доставка не выставила второй счет и не выслала вторую ссылку доступа.
  • Настройте оповещение о неудачных доставках: сломанный адрес отказывает молча.

Частые ошибки

  • Считать, что каждое событие приходит ровно один раз, и выставлять второй счет, когда оно приходит дважды.
  • Выполнять медленную работу до ответа, из-за чего отправитель перестает ждать и шлет событие повторно.
  • Не настроить оповещение о неудачных доставках, и тогда никто не заметит, что адрес перестал работать.
API против вебхука

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

ТехнологииСредний

API (интерфейс прикладного программирования)

API (интерфейс прикладного программирования) это принятый способ, которым одна программа просит у другой данные или действие и получает ответ.

ТехнологииБазовый

Сервер (Server)

Сервер (server) это компьютер или программа на нем, которые принимают запросы от других программ, например от браузера посетителя, и возвращают ответ.

ТехнологииБазовый

Облачные вычисления (Cloud Computing)

Облачные вычисления (cloud computing) это аренда серверов, хранилища и программ провайдера через интернет вместо своих, с оплатой помесячно или по объему.

Короткая проверка

Что заменяет вебхук?

Выберите ответ

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

Нужно ли понимать вебхуки до открытия бизнеса?
Писать их не нужно, но стоит знать, что они делают: другая система сообщает вашей в момент события, например оплаты или отправленной заявки. Так можно спланировать автоматические шаги, скажем приветственное сообщение сразу после покупки, вместо ручной проверки.
Когда вебхук становится актуален для нового бизнеса?
Когда двум вашим сервисам нужно реагировать друг на друга, например странице оплаты и сервису счетов, или продаже и доступу к курсу. Без вебхука одной системе приходится снова и снова спрашивать другую, нет ли нового. Это называется опросом, и событие замечают с опозданием.
Сколько стоит настроить вебхуки?
Большинство платежных сервисов, сервисов счетов и мессенджеров включают вебхуки в свой сервис. Сервисы автоматизации устроены по-разному: одни дают вебхуки на бесплатном тарифе с небольшим лимитом, другие только на платных, так что проверьте тариф, прежде чем на нем строить. Собственный обработчик требует часов разработчика, а экономия в том, что уходит ручная работа.
Вебхуки или API для моих процессов?
Обычно и то и другое, в одном процессе. Вебхук сообщает «платеж 123 прошел», а ваша система вызывает API, чтобы получить детали или выставить счет. Когда нужен отчет или список по запросу, спрашивают API. Если отправитель не поддерживает вебхуки, остается опрос.
Почему вебхуки важны для работающего бизнеса?
Клиент получает ссылку доступа или подтверждение заказа за секунды, если доставка прошла, и с повторными попытками, если нет. Кроме того, отпадает ручной шаг, когда кто-то следит за экраном платежей и переносит данные между системами.
Что будет, если вебхук не дойдет?
Событие потеряется: заказ останется неоплаченным в системе, аккаунт не создастся или клиент не получит доступ. Провайдеры обычно какое-то время повторяют попытки, но сломанный адрес отказывает молча, если никто не следит. Держите журнал доставок провайдера под рукой и настройте оповещение о сбоях.
Как защитить адрес вебхука от поддельных сообщений?
Разработчик проверяет подпись, которая приходит с каждым вебхуком и подтверждает, что его отправил ваш провайдер, и отклоняет все без правильной подписи. Сам адрес не секрет, поэтому поддельный «платеж прошел» останавливает именно проверка подписи.
Как заметить сбои вебхуков заранее?
Большинство платформ показывают журнал доставок с каждой попыткой и ее результатом. Настройте оповещение о неудачных доставках и проверяйте журнал после любых изменений на сайте или сервере.
Что такое вебхук на обычном русском?
Одна система говорит другой «это только что произошло» коротким сообщением на заранее известный адрес. Настраивается один раз, дальше сообщения приходят сами, как дверной звонок вместо того, чтобы каждые несколько минут выглядывать за дверь.
Сложно или рискованно настраивать вебхуки?
В сервисах автоматизации их настраивают через меню, а в платежных системах вставляют свой адрес в настройки. Риски в другом: обработчик, который не проверяет подпись, и адрес, который сломался, а никто не заметил. Поэтому оповещение о сбоях нужно настроить с первого дня.
Нужен ли разработчик, чтобы настроить вебхуки для магазина?
Для простых связок между популярными сервисами хватит сервиса автоматизации: он примет вебхук и передаст данные дальше без кода. Для вашей собственной системы, например выдачи доступа или обновления карточки клиента, обработчик должен написать разработчик, чтобы он проверял подпись и не обрабатывал повторы дважды.
Чем вебхук отличается от API?
Направлением. Через API ваша система спрашивает и получает ответ. С вебхуком другая система сама обращается на ваш адрес, когда происходит событие. Вебхук сам по себе HTTP-запрос и обычно входит в API-продукт поставщика, поэтому они работают вместе, а не друг против друга.

Источники: GitHub Docs, About webhooks (docs.github.com), read 23 September 2026, Tranzila developer docs, notify URL for Bit, card and standing order payments (docs.tranzila.com), read 23 September 2026, Grow (formerly Meshulam) developer docs, Webhooks and the payment request callback (grow-il.readme.io), read 23 September 2026, Meta for Developers, WhatsApp Business Platform, Webhooks overview (developers.facebook.com), read 23 September 2026, Zapier, Pricing, plan feature table (zapier.com/pricing), read 23 September 2026, Make Community, Does the free plan include the use of webhooks, moderator answer (community.make.com), read 23 September 2026, Wikipedia, Webhook, on Jeff Lindsay's 2007 coinage, read 23 September 2026

Последняя проверка: 2026-09-23

Работал с

Что говорят клиенты

Из разных сфер и на разных этапах бизнеса

Дэн Манто

Eclipse Capital

Инвестиции и финансы в недвижимости, США

Арти МакЛабин

GameReady

Обучение и аутсорсинг в разработке игр, международная компания

Анна, Косметолог

Анна

Косметолог

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

Марк, Массажист, Ган-Явне

Марк

Массажист, Ган-Явне

Когда я закончил курс массажа, я представлял себе всё совсем иначе. Оказалось, что это тяжёлая сфера и найти финансовую стабильность непросто. Когда я пришёл в Mobius, что-то изменилось. Мы начали планомерную работу и составили бизнес-план. Без Mobius? Наверное, я бы сдался. Сегодня я верю в себя и в свой путь.

Технологические решения не по силам вашей команде?

Алекс помогает бизнесам в Израиле выбирать технологии под бизнес, а не под моду. Первый звонок бесплатный.

+972 055-248-6151. Лучше в WhatsApp: большую часть дня я на встречах и отвечаю, как только освобождаюсь.