Вебхук

Простыми словами

Обычный запрос через API — это когда вы звоните и спрашиваете: «есть новости?». Вебхук — когда звонят вам, как только новость появилась. Не нужно проверять каждую минуту: сообщение приходит в момент события.

Как это выглядит на практике

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

Так же приходят входящие сообщения в бот, новые заявки с сайта, изменения статуса доставки. Событие произошло — уведомление ушло.

Почему это важно руководителю

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

Но вебхук — точка отказа. Если принимающая сторона была недоступна в момент события, уведомление может потеряться. Одни отправители повторяют попытки, другие нет. Поэтому важные события стоит периодически сверять: например, раз в день сравнивать список оплат с тем, что попало в учёт.

Типичная ошибка

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

Второй риск — сломанный вебхук, о котором никто не знает неделями, пока не всплывут потерянные заявки.