Webhooks-шлюз
Принимаем входящие вебхуки из внешних сервисов, валидируем, маршрутизируем. С повторами при ошибках.
Обновлено
Шлюз вебхуков: принимаем события из внешних сервисов, проверяем, раскладываем по системам и повторяем доставку при сбоях. Срок — 14+ календарных дней. Стоимость считаем после короткого брифа.
Что входит
- Приём из любого сервиса
- Подпись и проверка HMAC
- Маршрутизация по правилам
- Очередь с ретраями и DLQ
- Логи и алерты в Telegram
Вебхук — это способ, которым внешний сервис сообщает вам о событии: прошла оплата, сменился статус заказа на маркетплейсе, в CRM создана сделка, клиент написал боту. Пока таких событий немного, их принимает сам сайт, и всё работает. Проблемы начинаются потом: сайт ответил с ошибкой во время обновления, и уведомление об оплате пропало. Сервис прислал одно событие дважды, и заказ задублировался. Кто-то нашёл адрес обработчика и шлёт туда поддельные запросы. И никто не может сказать, что именно пришло вчера в 14:05.
Webhooks-шлюз — отдельный сервис, который берёт приём событий на себя: проверяет подлинность, сохраняет каждое событие, раскладывает по получателям и доставляет с повторами. Если у вас один источник событий и редкие уведомления, шлюз избыточен, достаточно аккуратного обработчика на сайте. Он нужен, когда источников несколько, события связаны с деньгами или их потеря дорого стоит.
Кому подходит
- Интернет-магазинам и сервисам с онлайн-оплатой, где уведомление от платёжной системы меняет статус заказа.
- Продавцам на маркетплейсах, которые получают события о заказах и возвратах в свои системы.
- Компаниям с несколькими связанными системами: CRM, 1С, сайт, боты, где одно событие нужно нескольким получателям.
- Проектам, у которых интеграции росли стихийно и теперь никто не знает, какой скрипт что принимает.
Как работает шлюз
- Приём. У каждого источника свой адрес. Шлюз принимает запрос, сразу сохраняет его и быстро отвечает отправителю, чтобы тот не считал доставку проваленной и не начал слать повторы.
- Проверка подлинности. Сверяем подпись HMAC с общим секретом, если источник её передаёт. Там, где подписи нет, используем другие механизмы: проверку IP-адресов отправителя или повторный запрос статуса через API источника.
- Дедупликация. Внешние сервисы иногда присылают одно событие несколько раз. Шлюз узнаёт повтор по идентификатору события и не передаёт его дальше второй раз.
- Маршрутизация. По правилам решаем, кому нужно событие: оплату — в учёт и в CRM, новый заказ — на склад и в чат менеджеров. Одно событие может уйти нескольким получателям.
- Доставка с повторами. Если получатель недоступен, событие остаётся в очереди и отправляется снова с нарастающей паузой. После исчерпания попыток оно уходит в отдельную очередь неудачных сообщений (DLQ), а не пропадает.
- Логи и алерты. Каждое событие видно в журнале: что пришло, когда, кому доставлено, с каким ответом. Сбои и рост очереди приходят алертом в Telegram.
Технические детали
Принцип «сначала сохранить, потом обработать» — основа всей схемы. Обработчик, который в момент получения вебхука лезет в базу, в CRM и в почту, рано или поздно не уложится в таймаут отправителя, и тот пришлёт событие ещё раз. Шлюз отвечает быстро, а тяжёлую работу делает уже из очереди. Какую очередь выбрать под нагрузку и инфраструктуру, разбирали в статье про RabbitMQ, Redis Streams и Yandex Message Queue.
Второе — идемпотентность на стороне получателей. Даже с дедупликацией в шлюзе получатель должен спокойно переживать повторную доставку: обработать оплату дважды не страшно, если второй раз она просто ничего не меняет. Мы помогаем доработать обработчики так, чтобы это было правдой.
Третье — повторная отправка вручную. Когда получатель полдня лежал, события из DLQ нужно проиграть заново после починки. В шлюзе это одна операция, а не поиск по логам и ручные запросы.
Для связок без большого потока событий иногда проще взять готовый инструмент, смотрите автоматизацию на n8n. А чтобы шлюз и всё вокруг него было под наблюдением, пригодится настройка мониторинга.
Сроки и стоимость
Срок — от 14 календарных дней. Стоимость считаем после короткого брифа: зависит от числа источников и получателей, способов проверки подлинности у каждого источника, объёма событий, требований к хранению истории, а также от того, где шлюз будет работать — на вашей инфраструктуре или у нас.
Пример из практики
Например, для магазина, который принимает оплату онлайн и продаёт на двух маркетплейсах, а уведомления от всех трёх источников принимает сам сайт. Во время обновления сайта несколько уведомлений об оплате пришли с ошибкой, и заказы зависли в статусе «не оплачен». Со шлюзом такие события дождались бы восстановления сайта в очереди и были бы доставлены автоматически, а менеджер увидел бы в Telegram, что доставка задерживалась.
Что нужно от вас
- Список сервисов, которые шлют вам события, и доступ к их настройкам.
- Описание, какая система что должна получать.
- Доступ к серверу или решение, где будет размещён шлюз.