Вебхук

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

Звичайний запит через API — це коли ви телефонуєте і питаєте: «є новини?». Вебхук — коли телефонують вам, щойно новина з’явилася. Не треба перевіряти щохвилини: повідомлення надходить у момент події.

Як це виглядає на практиці

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

Так само надходять вхідні повідомлення в бот, нові заявки із сайту, зміни статусу доставки. Подія сталася — повідомлення пішло.

Чому це важливо керівнику

Вебхуки дають швидкість. Що швидше команда дізнається про подію, то швидше реагує: відповідає за хвилину, а не за годину, і не пише нагадування тому, хто вже заплатив.

Але вебхук — точка відмови. Якщо сторона, що приймає, була недоступна в момент події, повідомлення може загубитися. Одні відправники повторюють спроби, інші ні. Тому важливі події варто періодично звіряти: наприклад, раз на день порівнювати список оплат із тим, що потрапило в облік.

Типова помилка

Не перевіряти, від кого надійшов вебхук. Адреса приймання — по суті відчинені двері. Якщо не перевіряти підпис чи секретний ключ, будь-хто зможе надіслати «оплату отримано».

Другий ризик — зламаний вебхук, про який тижнями ніхто не знає, поки не спливуть загублені заявки.