Для работы вебхука нужны две стороны:
- Источник — сервис, где происходит событие: например, платежная система или CRM.
- Получатель — сайт или приложение, которое должно узнать о событии и обработать его.
Перед настройкой получатель предоставляет специальный URL —
эндпоинт. Его указывают в настройках источника вместе с событиями, о которых нужно сообщать. Когда такое событие происходит, источник обычно отправляет на эндпоинт HTTP-запрос с данными.
Например, покупатель оплачивает заказ в интернет-магазине:
- Платежная система фиксирует успешную оплату.
- Она отправляет вебхук на адрес магазина.
- Сервер магазина проверяет отправителя и данные.
- Магазин обновляет статус заказа и может передать информацию в CRM.
- Сервер отвечает, что запрос принят.
Вебхук обычно передает информацию о событии в теле HTTP-запроса, часто в формате JSON. В запросе также могут быть заголовки с типом события, идентификатором доставки или подписью. Точный формат зависит от сервиса, который отправляет уведомление.
Ответ 200 OK обычно означает, что запрос принят. Он не обязательно означает, что все последующие действия — например, обновление заказа или отправка письма — уже завершились.