Главная / Словарь / Что такое вебхук

Что такое вебхук

Вебхук - это способ одной системы сообщить другой, что что-то произошло, сразу в момент события. Вместо того чтобы раз в пять минут спрашивать «есть новая заявка?», вы даёте сервису адрес, и он сам присылает туда данные, как только заявка появилась. Проще говоря, это звонок вместо регулярной проверки почтового ящика.

Чем вебхук отличается от API?

Направлением. К API вы обращаетесь сами, когда вам нужны данные. Вебхук приходит к вам, когда данные появились у отправителя. На практике оба нужны: вебхук приносит событие, после чего вы идёте в API за подробностями, потому что в самом уведомлении обычно только идентификатор.

Что делать, если вебхук не дошёл?

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

Почему вебхук нужно защищать?

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