Встраивание

Раздел Настройки → Встраивание — место, где берётся код для сайта и тонкие настройки публикации. Если нужно просто запустить виджет, начните с «Установки виджета на сайт»; здесь — полный набор вариантов.

Чат-виджет или iframe

Два способа встроить агента на сайт:

Чат-виджет (рекомендуем)

Плавающая кнопка-пузырь в углу сайта. Поддерживает все возможности агента: проактивные триггеры и автоприветствия, программный API, персонализацию. Рендерится в изолированном iframe (~14 КБ) — его стили и скрипты гарантированно не конфликтуют с вашим сайтом. Код вставляется перед закрывающим тегом </body>.

Есть переключатель «читаемый вид» — компактный и развёрнутый код работают одинаково.

Iframe

Чат встроен прямо в страницу отдельным блоком, без кнопки-пузыря. Подходит для отдельной страницы «Напишите нам» или раздела поддержки. Требует, чтобы агент был «Открытый» и включён.

В iframe недоступны: плавающая кнопка, триггеры-автоприветствия, программный API (Chatbot("open"/"close")) и персонализация по JWT. Для полного набора возможностей выбирайте «Чат-виджет».

Публичная ссылка

Готовая страница с чатом по адресу /chat/..., которую можно отправить клиенту напрямую — в соцсетях, мессенджере или письме. Включается переключателем «Открытый / Закрытый»; агент при этом должен быть включён.

Рецепты установки

Готовые пошаговые инструкции с уже подставленными ключом и идентификатором агента — для популярных платформ: Google Tag Manager, WordPress, Shopify, Next.js, Webflow. Выберите свою платформу и следуйте шагам.

Персонализация (JWT) — для разработчиков

Чтобы бот узнавал залогиненного пользователя, передайте подписанный токен. На странице сайта вызывается Chatbot("identify", { token }), а сам токен (JWT, HS256) подписывается на вашем бэкенде с помощью identity-секрета проекта (Проект → Настройки → API).

• Секрет никогда не публикуйте в коде страницы — только на сервере.
• Срок жизни токена — до 24 часов, обновляйте по мере необходимости.
• После выхода пользователя вызывайте Chatbot("reset"), чтобы история не попала к другому пользователю.

В разделе есть готовые примеры подписи для Node.js, Python, PHP и Ruby. Что именно передаётся и как это видит бот — в статье «Персонализация».

Реквизиты

Технические идентификаторы агента — пригодятся при отладке или обращении в поддержку: API-ключ проекта, идентификатор агента и публичный ID.

Что дальше

• Установка виджета на сайт — быстрый старт.
• Персонализация — данные залогиненных пользователей.