Webhook открытия страницы

Назначение

Если в настройках пространства задан webhook_url, VARICA отправляет HTTP POST после каждого открытия публичного КП. Это позволяет CRM или внешнему BPMN-сценарию отреагировать на интерес клиента.

Webhook не требуется для работы публичных страниц: отсутствие адреса не блокирует открытие.

Формат

POST https://client-system.example/hooks/varica
Content-Type: application/json

Пример тела:

{
  "event": "page.opened",
  "event_version": "v1",
  "occurred_at": "2026-07-23T11:30:00+00:00",
  "organization": {
    "id": 7,
    "slug": "varica_lab",
    "name": "VARICA Lab"
  },
  "page": {
    "id": 4012,
    "slug": "kp9a31df",
    "url": "https://varica.ru/Qf8xLm.varica_lab.offer_for_deal_7821",
    "open_count": 3
  },
  "template": {
    "id": 134,
    "name": "КП: бизнес-эффект"
  },
  "source_entity_id": "deal_7821"
}

Гарантии и ограничения

• Событие отправляется для каждого открытия, включая повторные и открытия менеджером.
• Сначала открытие фиксируется в БД, затем отправляется webhook.
• Адрес должен начинаться с http:// или https://.
• Запрос имеет тайм-аут 10 секунд и следует редиректам.
• Ответ webhook не отменяет уже открытое КП. Ошибка доставки пишется в технический лог.
• Повторная доставка, подпись запроса и очередь ретраев пока не реализованы. Получатель должен быть идемпотентным по page.id + open_count или по собственному ключу события.