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

Web Chat v3

Versioned-виджет с необязательным подписанным контекстом и обратной совместимостью.

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

Установка

htmlKanyman docs

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

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

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

javascriptKanyman docs

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

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

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

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

Content Security Policy

textKanyman docs

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

Продолжить

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