Помощь

1. Создание канала

Перейдите в веб-кабинет: «Настройки» → «Каналы уведомлений» → Webhook, вставьте URL, нажмите «Добавить». Канал создаётся со статусом pending, на URL уходит тестовое событие, в ответе — одноразовый секрет (webhook_secret), который показывается только при создании и далее недоступен.

2. Подтверждение

Канал становится active, если тестовое событие доставлено успешно (ответ 2xx). Если тест не прошёл, канал остаётся pending — тест можно отправить повторно кнопкой «Тест» в списке каналов.

3. Формат payload

Запрос POST, таймаут 10с, любые 2xx считаются успехом. Инцидент идентифицируется полем incident_id внутри event (заполнено для down, also_down и recovered). Тело запроса:

{
  "provider": "webhook",
  "timestamp": "2026-10-12T10:00:00+00:00",
  "event": {
    "event_type": "down",
    "incident_id": "uuid",
    "monitor_name": "fidevisio.ru",
    "monitor_url": "https://fidevisio.ru",
    "error_detail": "HTTP 502",
    "detected_at": "2026-10-12T09:59:00+00:00",
    "recovered_at": null,
    "dashboard_url": "https://fidevisio.ru/dashboard/monitors/uuid",
    "timezone": "Europe/Moscow",
    "expires_at": null,
    "days_left": null,
    "check_kind": "http",
    "transport": null,
    "target_port": null,
    "checks": [
      { "kind": "http", "detail": "HTTP 502", "transport": null, "target_port": null }
    ]
  }
}

Поле checks содержит все упавшие проверки инцидента в порядке http, ssl, ping; check_kind/error_detail дублируют первый элемент для совместимости.

4. Значения event_type

event_type: test, down, also_down, recovered, ssl_expiring, ssl_expired.

5. Подпись X-Signature

Каждый запрос подписывается: HMAC_SHA256 от сырого тела запроса по секрету канала.

X-Signature = sha256=<hex lowercase HMAC-SHA256(secret, raw_body)>

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

Псевдокод проверки на вашей стороне:

expected = "sha256=" + hmac_sha256_hex(secret, raw_body)
if not hmac.compare_digest(expected, request.headers["X-Signature"]): reject 401

7. Повторные попытки

При неудачной доставке делается до 3 попыток с паузами ~2с и ~5с. Если все неудачны, задача ставится на повтор воркером (arq, до 3 попыток). Тестовое событие повторяется только внутри доставки (3 попытки) — тест можно отправить заново кнопкой «Тест».

8. Ограничение

До 3 каналов Email, до 3 Webhook и 1 канал MAX на аккаунт.