Установка на сайт
Один тег script — и агент на странице.
Виджет подключается одним тегом <script>, который нужно вставить перед закрывающим тегом </body> на странице сайта.
Код вставки
<script src="https://cdn.cosai.pro/widget/v1/widget.js"
integrity="sha384-…" crossorigin="anonymous"
data-agent-id="<uuid агента>"
data-agent-key="<cosai_wk_…>"
data-title="Чат с консультантом"></script>Параметры
| Атрибут | Обязателен | Назначение |
|---|---|---|
data-agent-id | да | Идентификатор опубликованного агента |
data-agent-key | да | Ключ со scope chat:widget, ограниченный доверенными доменами (см. Домен-allowlist) |
data-title | нет | Заголовок панели чата (по умолчанию «Чат с консультантом») |
data-api | нет | Адрес API, если используется нестандартный (по умолчанию https://api.cosai.pro) |
Где взять agent-id и agent-key
agent-id— идентификатор агента; можно получить черезGET /v1/agents(см. Примеры запросов) или узнать у команды платформы при подключении.data-agent-key— ключ виджета с ограниченным доступом (см. API-ключи); отдельный от ключа полного доступа к консоли.
Про SRI (integrity)
Атрибут integrity с SRI-хэшем (sha384-…) защищает от подмены содержимого файла виджета, если он будет скомпрометирован на CDN: браузер проверит, что загруженный файл совпадает с ожидаемым, и не выполнит его при несовпадении. Для каждого релиза виджета публикуется свой хэш. Если для вас важна такая защита — зафиксируйте конкретную версию и её хэш; используя тег без integrity, вы автоматически получаете обновления в пределах текущей крупной версии виджета (/widget/v1/).
Проверка после установки
Откройте страницу сайта — в правом нижнем углу должна появиться кнопка чата. Нажмите на неё и задайте тестовый вопрос: ответ должен прийти по потоковому SSE так же, как в чат-превью в консоли. Если чат не открывается — проверьте консоль браузера на ошибки data-agent-id/data-agent-key и убедитесь, что текущий домен добавлен в allowlist ключа.