Вебхуки

Вебхуки позволяют Scrollengine уведомлять ваши внешние системы в режиме реального времени при возникновении событий. Используйте вебхуки для создания пользовательских интеграций, автоматизации рабочих процессов или синхронизации данных с другими инструментами.

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

Вебхук — это HTTP POST-запрос, отправляемый на указанный вами URL каждый раз, когда в Scrollengine происходит определённое событие. Ваш сервер получает данные события и может действовать на их основе.

Доступные события вебхуков

Событие	Триггер
order.created	Создан новый заказ на доставку
order.updated	Изменены данные или статус заказа
order.delivered	Заказ отмечен как доставленный
order.cancelled	Заказ отменён
route.created	Создан новый маршрут
route.started	Водитель начал маршрут
route.completed	Все остановки маршрута выполнены
driver.assigned	Водитель назначен на заказ или маршрут

Настройка вебхука

1. Перейдите в Настройки > Интеграции > Вебхуки
2. Нажмите Добавить вебхук
3. Введите:
   • URL — Конечная точка на вашем сервере, которая будет получать вебхук
   • События — Выберите события, на которые хотите подписаться
   • Секрет — Общий секретный ключ для проверки подлинности вебхука
4. Нажмите Сохранить

Содержимое вебхука

Вебхуки отправляются как HTTP POST-запросы с телом в формате JSON:

{
  "event": "order.delivered",
  "timestamp": "2026-03-13T14:30:00Z",
  "data": {
    "order_id": "12345",
    "shopify_order_id": "98765",
    "delivery_method": "local_delivery",
    "status": "delivered",
    "driver": {
      "id": "d-001",
      "name": "John Driver"
    }
  }
}

Проверка вебхуков

Каждый вебхук содержит заголовок подписи для верификации:

1. Scrollengine подписывает содержимое с помощью вашего общего секретного ключа
2. Подпись включена в заголовок X-Scrollengine-Signature
3. Ваш сервер должен проверить подпись перед обработкой

Политика повторных попыток

Если ваша конечная точка возвращает код состояния, отличный от 2xx:

• Scrollengine повторяет попытку до 3 раз
• Повторные попытки используют экспоненциальную задержку (1 мин, 5 мин, 30 мин)
• После 3 неудач вебхук помечается как сбойный
• Вы получите уведомление о необходимости исправить конечную точку

Примеры использования

• Синхронизация с ERP — Отправка данных о доставке в систему учёта запасов или бухгалтерии
• Пользовательские уведомления — Запуск SMS, Slack или других оповещений
• Аналитика — Передача событий доставки в вашу аналитическую платформу
• Сторонняя логистика — Уведомление внешних перевозчиков или партнёров