Разработчикам

Web Chat v4

White-label виджет с multi-ticket, подписанным контекстом и обратной совместимостью.

Обновлено: 11 августа 2026

Установка

htmlKanyman docs

<script
  src="https://app.kanyman.ru/kenyman-chat.v5.js"
  data-public-key="wc_pk_..."
  defer
></script>

Добавьте точный Origin страницы в настройки Web Chat. Публичный ключ виден в HTML и не является секретом, но должен принадлежать выбранному каналу.

White-label оформление

Название, логотип, основной цвет и тексты задаются в Web Chat-канале конкретного проекта. Посетитель не видит обязательного брендинга Kenyman; без логотипа или при ошибке загрузки используется нейтральная иконка чата.

Передача контекста

javascriptKanyman docs

window.addEventListener("load", function () {
  window.KenymanChat.open({ contextToken });
});

// После смены страницы или выбранного объекта:
window.KenymanChat.setContextToken(nextContextToken);

Жизненный цикл

Создание сессии с контекстом использует Idempotency-Key.
Обновление контекста выполняется через setContextToken и PUT endpoint сессии.
Невалидный или истёкший контекст не блокирует обычный чат.
Токен самой chat-сессии остаётся в sessionStorage, как в предыдущей версии.
Опубликованные v1–v3 не меняются; актуальный white-label runtime — v4.

Content Security Policy

textKanyman docs

script-src 'self' https://app.kanyman.ru;
connect-src 'self' https://app.kanyman.ru;
img-src 'self' https://app.kanyman.ru data:;

Продолжить

Подписанный контекстJWT-конверт, JSON Schema, подпись и защита от повторов.API и ошибкиПубличные endpoints Web Chat и безопасные коды ошибок.Безопасность и запускЧеклист ключей, токенов, сетевых ограничений и production UAT.