Услуги

Webhooks-шлюз

Принимаем входящие вебхуки из внешних сервисов, валидируем, маршрутизируем. С повторами при ошибках.

Обновлено

Срок14+ календарных дней
Коротко

Шлюз вебхуков: принимаем события из внешних сервисов, проверяем, раскладываем по системам и повторяем доставку при сбоях. Срок — 14+ календарных дней. Стоимость считаем после короткого брифа.

Что входит

  • Приём из любого сервиса
  • Подпись и проверка HMAC
  • Маршрутизация по правилам
  • Очередь с ретраями и DLQ
  • Логи и алерты в Telegram

Вебхук — это способ, которым внешний сервис сообщает вам о событии: прошла оплата, сменился статус заказа на маркетплейсе, в CRM создана сделка, клиент написал боту. Пока таких событий немного, их принимает сам сайт, и всё работает. Проблемы начинаются потом: сайт ответил с ошибкой во время обновления, и уведомление об оплате пропало. Сервис прислал одно событие дважды, и заказ задублировался. Кто-то нашёл адрес обработчика и шлёт туда поддельные запросы. И никто не может сказать, что именно пришло вчера в 14:05.

Webhooks-шлюз — отдельный сервис, который берёт приём событий на себя: проверяет подлинность, сохраняет каждое событие, раскладывает по получателям и доставляет с повторами. Если у вас один источник событий и редкие уведомления, шлюз избыточен, достаточно аккуратного обработчика на сайте. Он нужен, когда источников несколько, события связаны с деньгами или их потеря дорого стоит.

Кому подходит

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

Как работает шлюз

  1. Приём. У каждого источника свой адрес. Шлюз принимает запрос, сразу сохраняет его и быстро отвечает отправителю, чтобы тот не считал доставку проваленной и не начал слать повторы.
  2. Проверка подлинности. Сверяем подпись HMAC с общим секретом, если источник её передаёт. Там, где подписи нет, используем другие механизмы: проверку IP-адресов отправителя или повторный запрос статуса через API источника.
  3. Дедупликация. Внешние сервисы иногда присылают одно событие несколько раз. Шлюз узнаёт повтор по идентификатору события и не передаёт его дальше второй раз.
  4. Маршрутизация. По правилам решаем, кому нужно событие: оплату — в учёт и в CRM, новый заказ — на склад и в чат менеджеров. Одно событие может уйти нескольким получателям.
  5. Доставка с повторами. Если получатель недоступен, событие остаётся в очереди и отправляется снова с нарастающей паузой. После исчерпания попыток оно уходит в отдельную очередь неудачных сообщений (DLQ), а не пропадает.
  6. Логи и алерты. Каждое событие видно в журнале: что пришло, когда, кому доставлено, с каким ответом. Сбои и рост очереди приходят алертом в Telegram.

Технические детали

Принцип «сначала сохранить, потом обработать» — основа всей схемы. Обработчик, который в момент получения вебхука лезет в базу, в CRM и в почту, рано или поздно не уложится в таймаут отправителя, и тот пришлёт событие ещё раз. Шлюз отвечает быстро, а тяжёлую работу делает уже из очереди. Какую очередь выбрать под нагрузку и инфраструктуру, разбирали в статье про RabbitMQ, Redis Streams и Yandex Message Queue.

Второе — идемпотентность на стороне получателей. Даже с дедупликацией в шлюзе получатель должен спокойно переживать повторную доставку: обработать оплату дважды не страшно, если второй раз она просто ничего не меняет. Мы помогаем доработать обработчики так, чтобы это было правдой.

Третье — повторная отправка вручную. Когда получатель полдня лежал, события из DLQ нужно проиграть заново после починки. В шлюзе это одна операция, а не поиск по логам и ручные запросы.

Для связок без большого потока событий иногда проще взять готовый инструмент, смотрите автоматизацию на n8n. А чтобы шлюз и всё вокруг него было под наблюдением, пригодится настройка мониторинга.

Сроки и стоимость

Срок — от 14 календарных дней. Стоимость считаем после короткого брифа: зависит от числа источников и получателей, способов проверки подлинности у каждого источника, объёма событий, требований к хранению истории, а также от того, где шлюз будет работать — на вашей инфраструктуре или у нас.

Пример из практики

Например, для магазина, который принимает оплату онлайн и продаёт на двух маркетплейсах, а уведомления от всех трёх источников принимает сам сайт. Во время обновления сайта несколько уведомлений об оплате пришли с ошибкой, и заказы зависли в статусе «не оплачен». Со шлюзом такие события дождались бы восстановления сайта в очереди и были бы доставлены автоматически, а менеджер увидел бы в Telegram, что доставка задерживалась.

Что нужно от вас

  • Список сервисов, которые шлют вам события, и доступ к их настройкам.
  • Описание, какая система что должна получать.
  • Доступ к серверу или решение, где будет размещён шлюз.

Частые вопросы

Зачем отдельный шлюз, если вебхуки принимает сайт?
Сайт может быть недоступен при обновлении или перегрузке, и события в этот момент теряются. Шлюз сохраняет каждое событие и доставляет его, когда получатель снова доступен.
Как вы защищаете адрес приёма от поддельных запросов?
Проверяем подпись HMAC, если источник её передаёт. Если подписи нет, проверяем IP-адреса отправителя или уточняем статус события через API источника.
Что будет с событиями, которые так и не удалось доставить?
После нескольких попыток с нарастающей паузой они попадают в отдельную очередь неудачных сообщений. Оттуда их можно отправить повторно после починки получателя.
Сколько занимает разработка?
От 14 календарных дней. Срок зависит от числа источников, способов проверки подлинности и количества получателей.
Где будет работать шлюз?
На вашем сервере или в облаке. Можем и разместить у себя, если своей инфраструктуры нет.
Другие услуги
(01) Разработка сайта Кастомный сайт под бизнес: дизайн с нуля, разделы услуг и проектов, формы заявок, мобильная версия, SEO-структура. От 70 000 ₽ → (02) Разработка интернет-магазина Каталог, фильтры, корзина, чекаут. Интеграции с 1С, складом, эквайрингом, доставкой и маркетплейсами. От 150 000 ₽ → (03) Разработка лендинга Одностраничник под рекламный трафик. Считаем конверсию, оптимизируем смыслы, A/B-тестируем гипотезы. От 70 000 ₽ → (04) Разработка CRM-системы Когда коробочные не подходят — собираем своё. База клиентов, воронки, задачи, аналитика, мобилка. От 50 000 ₽ → (05) Бот для MAX Российская платформа MAX от VK. Тот же функционал, что у Telegram-бота, но для отдельной аудитории. От 10 000 ₽ → (06) Telegram-бот Приём заявок, FAQ, авторассылки, оплата. Подключаем к CRM, 1С, складу, маркетплейсам. От 10 000 ₽ → (07) Разработка веб-приложения SaaS, дашборды, внутренние инструменты, B2B-порталы. Современный фронтенд, надёжный бэкенд, быстрая итерация. От 100 000 ₽ → (08) Разработка нативного iOS-приложения Swift и SwiftUI. Дизайн, разработка, публикация в App Store, поддержка после релиза. От 100 000 ₽ → (09) Разработка нативного Android-приложения Kotlin и Jetpack Compose. Под Google Play и российские альтернативы (RuStore, NashStore, AppGallery). От 100 000 ₽ → (10) Техническая поддержка сайта или приложения Дежурный инженер на связи. Реакция от 30 минут на P1-инциденты, мониторинг, бэкапы, обновления, доработки. Четыре тарифа. От 5 000 ₽/мес → (11) Информационная поддержка сайта и интернет-магазина Обновление контента, добавление товаров, импорт из Excel/1С, подготовка фото и описаний — всё на нас. От 7 000 ₽/мес → (12) Редизайн и переработка сайта Новый дизайн и переработка начинки без потери позиций: своя тема вместо конструктора, быстрый сайт на телефоне, все старые адреса на месте. →