Webhook

Настройка Webhook

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

---

Типы событий

События полисов

Событие	Описание
policy.created	Создан гарантийный полис (заказ с гарантией завершён)
policy.activated	Полис активирован (оплата подтверждена)
policy.expired	Срок действия полиса истёк
policy.cancelled	Полис отменён (возврат средств или отмена заказа)
policy.updated	Полис обновлён (изменение статуса или метаданных)

События заявок

Событие	Описание
claim.created	Подана новая заявка
claim.updated	Изменён статус заявки
claim.approved	Заявка одобрена
claim.denied	Заявка отклонена
claim.resolved	Заявка урегулирована (замена отправлена или средства возвращены)

События заказов

Событие	Описание
order.warranty_attached	Гарантия прикреплена к позиции заказа
order.warranty_removed	Гарантия удалена из заказа
order.post_purchase_completed	Допродажа гарантии после покупки завершена

События покупателей

Событие	Описание
customer.policy_assigned	Полис назначен покупателю
customer.claim_filed	Покупатель подал заявку

---

Формат полезной нагрузки

Все полезные нагрузки имеют следующую структуру:

{
  "id": "wh_evt_abc123def456",
  "event": "policy.created",
  "timestamp": "2026-03-17T14:30:00.000Z",
  "version": "1.0",
  "data": { ... },
  "metadata": {
    "orgId": "org_abc",
    "integrationPlatform": "shopify",
    "shopDomain": "my-store.myshopify.com"
  }
}

• id — уникальный ID события (используйте для дедупликации)
• event — тип события
• data — данные конкретного события со сведениями о ресурсе
• metadata — контекст организации и интеграции

---

Проверка подписи

Все Webhook содержат заголовок X-Umbrella-Signature (HMAC-SHA256 тела запроса). Всегда проверяйте его перед обработкой. Примеры кода проверки см. в справочнике по Webhook.

---

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

Неудачные доставки (ответ не из диапазона 2xx или тайм-аут) повторяются с экспоненциальной задержкой:

Попытка	Задержка
1-я повторная	30 секунд
2-я повторная	2 минуты
3-я повторная	10 минут
4-я повторная	1 час
5-я повторная	6 часов
Последняя повторная	24 часа

Ваш эндпоинт должен ответить кодом 200, 201 или 202 в течение 30 секунд. Отвечайте сразу, а обработку выполняйте асинхронно, чтобы избежать тайм-аутов.

---

Настройка эндпоинта

1. Перейдите в Панель управления → Настройки → Webhook
2. Нажмите Добавить эндпоинт
3. Введите URL эндпоинта с HTTPS и выберите события
4. Скопируйте и надёжно сохраните секрет подписи (он показывается только один раз)
5. Проверьте работу с помощью кнопки Отправить тестовое событие на странице эндпоинта

---

Журнал Webhook

На странице журнала отображается история доставок по каждому эндпоинту: тип события, статус (успешно/ошибка/повтор), код ответа, время ответа, отметка времени и число попыток.

---

См. также

• Синхронизация товаров Shopify — синхронизация через Webhook Shopify
• Интеграция с Shopify — подключение Shopify в целом
• Настройка виджетов — параметры отображения виджета