Corpis
Загрузка

Как поставить виджет агента на сайт

Обновлено: 24.07.2026

Чтобы поставить виджет на сайт, в настройках агента откройте вкладку «Виджет», включите публикацию и скопируйте готовую строку script. Её нужно один раз вставить в HTML страницы перед закрывающим тегом body — чат-кнопка появится в углу сайта. Программировать не нужно: виджет работает на любом сайте, куда можно добавить один тег script.

Пошагово

  1. Откройте вкладку «Виджет». В настройках агента перейдите в раздел «Виджет» и включите тумблер публикации — без него виджет на сайте не отвечает.

  2. Настройте вид. Задайте заголовок, приветствие, акцентный цвет и угол экрана (справа или слева), затем сохраните.

  3. Ограничьте домены. В блоке «Разрешённые домены» впишите адреса своих сайтов, по одному в строке. Пусто — виджет работает на любом сайте.

  4. Скопируйте и вставьте строку. Нажмите «Скопировать сниппет» и вставьте строку script в HTML страницы перед закрывающим тегом body. Обновите сайт — кнопка чата появится в углу.

Где включается виджет

Виджет настраивается на вкладке «Виджет» в настройках агента. Ключ виджета создаётся автоматически при первом открытии этого раздела, поэтому готовую строку script видно ещё до публикации. Но пока тумблер публикации выключен, виджет на сайте не отвечает — публикация это отдельный явный шаг.

Виджет использует того же агента, что и остальные каналы: тот же характер, ту же базу знаний и тот же мозг, что личный чат и Telegram-бот. Отдельно настраивать поведение не нужно — правите агента, меняется и виджет.

Как вставить строку на сайт

После публикации скопируйте фрагмент script на вкладке «Виджет» и вставьте его в HTML страницы перед закрывающим тегом body. Строка выглядит так:

Ставить её можно на любой сайт — конструктор, CMS или собственную вёрстку: нужна лишь возможность добавить один тег script. Виджет рендерится в изолированном Shadow DOM, поэтому его стили не влияют на вёрстку сайта, а стили сайта не протекают внутрь виджета.

Ключ виджета и разрешённые домены

Ключ виджета уникален для агента и лежит прямо в HTML страницы — он публичный по своей природе. Основная защита от чужого использования это список разрешённых доменов на той же вкладке: по одному домену в строке. Если список пуст, виджет запустится на любом сайте; если задан — на всех прочих доменах он работать не будет, даже если кто-то скопирует вашу строку script.

Что видит посетитель

Посетитель видит плавающую кнопку-пузырь в углу страницы; по клику открывается панель чата с агентом. Заголовок, приветствие, акцентный цвет и угол (справа или слева) настраиваются на вкладке «Виджет». Тела агента в виджете нет — это текстовый чат в прямоугольнике webview; полное присутствие тела живёт в десктоп-оверлее.

Посетителю не нужен аккаунт: он анонимный собеседник. Его диалог привязан к сессии браузера, поэтому вернувшийся посетитель продолжает разговор, а не начинает с нуля.

Частые вопросы

Куда вставлять строку script?

В HTML страницы перед закрывающим тегом body. Виджет можно ставить на любой сайт — конструктор, CMS или свою вёрстку, — где есть возможность добавить один тег script.

Что будет, если ключ виджета кто-то скопирует?

На чужом домене он не запустится, если вы задали список разрешённых доменов. Ключ публичный по природе (лежит в HTML), поэтому список доменов — основная защита от чужого использования.

Виджет сломает стили моего сайта?

Нет. Он рендерится в Shadow DOM: стили виджета не влияют на страницу, а стили страницы — на виджет. Поэтому его можно ставить на чужие шаблоны и конструкторы без правки их CSS.

Материалы по теме

Создать агента для сайта