Webhook
Определение: Webhook (вебхук) — это способ, когда один сервис сам отправляет уведомление (HTTP-запрос) в другой сервис при событии: например, «оплата прошла», «заявка создана», «заказ отгружен». В отличие от регулярных проверок (polling), вебхук работает по принципу “произошло → отправили”.
Зачем это нужно
- Получать события почти сразу, без постоянных запросов «а что нового?».
- Автоматизировать процессы: оплачено → поменять статус → отправить письмо → создать сделку в CRM.
- Связывать сайт с внешними сервисами: платежи, доставки, CRM, мессенджеры, email-рассылки.
- Снижать нагрузку на систему по сравнению с частыми проверками состояния.
- Делать интеграции надёжнее: фиксировать события и логировать входящие уведомления.
- Запускать фоновые действия: генерация документов, создание задач, уведомления менеджеру.
Пример
Пример кода:
POST /api/webhooks/payment
Content-Type: application/json
X-Signature: <signature>
{
"event": "payment.succeeded",
"order_id": 1005,
"amount": 1990,
"currency": "RUB"
}
200 OK
{ "received": true }
Платёжный сервис отправляет вебхук на URL вашего сайта. Бэкенд проверяет подпись (чтобы убедиться, что запрос настоящий), находит заказ в базе данных, меняет статус на «оплачен» и может запустить дополнительные действия: чек, письмо, уведомление менеджеру.
Скриншот
Подпись к скриншоту: Покажите настройки вебхука в сервисе (URL получателя, выбранные события) и журнал доставок со статусом (успешно/ошибка)
Частые ошибки
- Не проверять подпись/секрет вебхука — любой может подделать событие.
- Не делать идемпотентность: один и тот же вебхук может прийти повторно, и логика «ломается» (двойная оплата/двойная отгрузка).
- Отвечать слишком долго: сервис может считать запрос неуспешным и отправлять повторно.
- Не логировать входящие вебхуки — потом сложно понять, что именно пришло и почему не обработалось.
- Открывать endpoint без ограничений и защиты от спама/флуда.
Связанные термины
- API
- Endpoint (эндпоинт)
- HTTP
- JSON
- Идемпотентность
- Подпись запроса (signature)
- Очереди задач
Наши услуги
- Доработка сайтов — настраиваем вебхуки платежей, доставок, CRM и автоматизацию статусов.
- Создание интернет-магазинов — интеграции оплаты/доставки и события заказов через вебхуки.
- Техническая поддержка сайтов — мониторим доставку вебхуков, устраняем ошибки, усиливаем безопасность.