Перейти к содержимому

Разместите Quickchat AI на сайте как плавающий Widget, встроенный Встроить или отдельную Страница чата. Установка, доступ, оформление, тексты и пользовательские параметры.

Разместить AI-агента Quickchat AI в интернете можно тремя способами. Выберите подходящий формат:

  • Widget: плавающий значок чата в углу сайта. Подходит для поддержки общего назначения.
  • Встроить: встроенное окно чата именно в том месте страницы, которое вы выберете. Подходит для размещения AI на определённом экране приложения, странице справочного центра или странице товара.
  • Страница чата: полноэкранный чат, размещённый на стороне Quickchat, без установки и кода. Подходит, когда нужно поделиться ссылкой, например в письме поддержки, внутреннем Slack или с бета-тестировщиками, ничего не меняя в их браузере.

Установите выбранный формат в Каналы → Ваш сайт → Установка. На странице три подраздела: Установка для выбора способа добавления агента, Внешний вид для оформления и Текстовое содержимое для текстов и подписей, которые видят посетители. Вкладка Установка начинается с выбора способа, содержит отдельный раздел доступности и контроля доступа и показывает копируемый Scenario ID, необходимый плагинам и API.

  • Сравните способы развёртывания. Сопоставьте указанные вами каналы, доступ к сайту и необходимые функции с вариантами настройки Quickchat AI. Инструмент не проверяет ваш сайт или аккаунт.

  • Сравните HTML и Markdown страницы-примера. Получите исходный HTML, содержимое Markdown и ссылки на инструменты из фиксированного примера Quickchat AI. Инструмент не выполняет JavaScript и не проверяет произвольные сайты.

Widget позволяет встроить AI-агента Quickchat AI непосредственно в сайт, чтобы пользователям было удобно общаться с AI. Обычно Widget отображается значком чата в правом нижнем углу страницы. При нажатии открывается окно чата, где можно задать вопрос, получить помощь или найти информацию.

Откройте Каналы → Ваш сайт → Установка. Вкладка начинается с вопроса “Как вы хотите добавить AI-агента?” и перечисляет способы установки от самых простых. Выберите подходящий вашему сайту:

  • WordPress: установите бесплатный плагин Quickchat AI Agent, вставьте Scenario ID, и Widget появится автоматически, без редактирования кода темы.
  • Shopify: добавьте Widget через редактор темы магазина. См. руководство Shopify.
  • Webflow, Wix и другие: скопируйте один фрагмент кода и вставьте его в общую настройку пользовательского кода конструктора, действующую на всех страницах. Не используйте элемент Встроить или HTML внутри отдельной страницы. См. Конструкторы сайтов.
  • Поделиться ссылкой вместо этого: ничего не устанавливайте, а поделитесь ссылкой на размещённую Страница чата.
  • Установить вручную с кодом: скопируйте исходный код Widget или Встроить и самостоятельно вставьте его в HTML.

Каждый способ открывает отдельную пошаговую панель только с необходимым кодом или идентификатором.

Scenario ID находится вверху вкладки Установка в копируемом поле. Это идентификатор, который нужен плагинам и API. Копируйте его отсюда, когда он требуется на этапе настройки.

Если вы сами управляете HTML, раскройте Установить вручную с кодом на вкладке Установка и:

  1. Скопируйте код Widget.
  2. Откройте HTML-файл страницы. В конструкторе используйте общую настройку кода сайта, как описано в разделе Конструкторы сайтов.
  3. Вставьте код непосредственно перед закрывающим тегом </body> на каждой странице, где должен появляться Widget.

Проверьте код Widget относительно указанного Scenario ID. Проверка читает вставленный код, но не загружает ваш сайт.

В Webflow, Wix, Squarespace, Hostinger и подобных конструкторах добавляйте Widget один раз через общую настройку кода сайта:

  1. Откройте настройку добавления кода на все страницы. Она может называться Custom code, Code injection, Footer code или Body end.
  2. Вставьте туда код Widget и примените его ко всем страницам. Если можно выбрать размещение, укажите подвал или конец body. В head этот код не работает.
  3. Опубликуйте сайт. Значок чата появится на каждой странице.

Не добавляйте Widget через элемент Embed или HTML на отдельной странице. Многие конструкторы отображают такие элементы в небольшом отдельном фрейме, где Widget не может открыться. Даже если он загрузится, то будет виден только на этой странице.

Где находится общая настройка кода:

КонструкторОбщая настройка кода сайта
WebflowSite settings → Custom code → Footer code
WixSettings → Custom Code, затем All pages и Body - end. Требуется подключённый домен.
SquarespaceCustom Code → Code Injection → Footer. Тарифы Core, Plus, Advanced и некоторые старые тарифы.
Hostinger Website BuilderMore (⋯) → Integrations → Custom code. Скрипты автоматически загружаются в конце страницы.

Меню могут меняться и быть переведены на язык вашего конструктора. Если конструктор или тариф не предоставляет общую настройку кода, поделитесь ссылкой на Страница чата.

Не занимаетесь разработкой? На вкладке Установка в разделе Нужна помощь? есть два варианта:

  • Попросить AI о помощи: открывает помощника в приложении с готовым вопросом о добавлении агента на сайт.
  • Отправить инструкции разработчику: отправляет коллеге всё необходимое для установки: код Widget, Scenario ID и ссылку на это руководство.

За дополнительной помощью обращайтесь на contact@quickchat.ai.

Страница чата представляет собой полноэкранную версию AI-агента, размещённую по адресу Quickchat. Устанавливать ничего не нужно: поделитесь ссылкой, и посетители смогут общаться с агентом прямо в браузере. Используйте её, когда:

  • Нужен чат, но нет сайта или вы не хотите менять его код.
  • Вы делитесь AI внутри небольшой группы, например с бета-тестировщиками, поддержкой или потенциальными клиентами, и нужна ссылка с ограничением доступа вместо публичного виджета.
  • Вы хотите отправить AI как канал для дальнейшего общения по электронной почте, в Slack или CRM.

Настройте, кто может открывать Страница чата, в Установка → Доступ к странице чата. См. Контроль доступа ниже.

Чтобы сбросить чат и начать заново:

  • Widget или Встроить: откройте чат и нажмите кнопку с ручкой в квадрате в правом верхнем углу окна.
  • Страница чата: выберите New chat в боковом меню или нажмите кнопку с ручкой в квадрате в заголовке.

Так начинается новая беседа с AI-агентом. Предыдущая остаётся в Входящие. Закрытие и повторное открытие Widget или обновление страницы может возобновить текущую беседу. Просьба к AI «сбросить» или «очистить чат» не создаёт новую беседу. Удалять cookie в браузере не нужно.

На вкладке Установка настройки доступа находятся в сворачиваемом разделе Доступность и доступ. Разверните его, чтобы увидеть два элемента управления развёртыванием:

Переключатель вверху Доступность и доступ. Когда он включён, скрипты Widget и Встроить работают в браузерах посетителей как обычно. Когда выключен, Widget и Встроить недоступны на сайте, даже если код всё ещё вставлен. Это удобно для временного отключения AI без удаления кода или ограничения публичного доступа при сохранении Страница чата для приглашённых пользователей.

Независимо от переключателя Widget и Встроить можно ограничить доступ к Страница чата:

  • Любой: URL Страница чата публичен. Им может пользоваться любой, у кого есть ссылка.
  • Только приглашённые пользователи: Для доступа к Странице чата необходимо войти в аккаунт и иметь роль у этого AI-агента. Для людей, которым нужно только общение, выберите роль Пользователь чата.
  • Никто: Страница чата полностью отключена.

Ссылка Пригласить пользователей чата открывает Настройки → Организация → Участники команды. Выберите Пользователь чата в форме приглашения, чтобы предоставить доступ к Странице чата без доступа к панели управления. Для приглашений нужны свободные места, а устаревший тариф Basic не позволяет выбирать роль. Лимиты тарифов описаны на странице Участники команды и роли.

Подразделы Внешний вид и Текстовое содержимое позволяют изменить внешний вид Widget, Встроить и Страница чата, а также тексты для посетителей. Все три формата используют общие настройки: измените их один раз, и они применятся везде, где размещён агент.

В правой части вкладок Установка, Внешний вид и Текстовое содержимое находятся собственные элементы предварительного просмотра. Переключайтесь между Widget, Встроить и Страница чата, а также между Компьютер и Мобильный, чтобы увидеть изменения до публикации.

Оформление чата сгруппировано в Брендинг, Size & Position, Тема и Другие настройки.

  • Аватар AI-агента: изображение профиля или логотип агента. Один файл используется и в заголовке чата, и на кнопке запуска, максимум 5 MB. Это одна настройка, а не две: загрузите изображение, и оно появится в обоих местах, заменяя прежние отдельные “header logo” и “launcher icon”. Каждый агент начинает со встроенного стандартного аватара. Сбросить по умолчанию восстанавливает его, а удаление полностью скрывает аватар. Доступно на всех тарифах, включая Free.

Аватар AI-агента применяется к Widget, Встроить и Страница чата, но не к Discord, где аватар бота берётся из его приложения Discord. См. Discord.

  • Размер кнопки чата: Классический, Только поле ввода или Маленький. Определяет вид кнопки запуска до открытия чата.
  • Закрытие кнопки запуска: у варианта Классический есть маленькая кнопка закрытия в правом верхнем углу. На компьютере она появляется при наведении, на сенсорных устройствах видна постоянно. Она скрывает виджет только до следующей загрузки страницы. У других размеров кнопки закрытия нет.
  • Надпись кнопки чата: отображается только при выборе Маленький. Пользовательский текст на небольшой кнопке запуска, до 25 символов, например “Ask AI” или “Chat”. Оставьте пустым, чтобы показывать только значок.
  • Положение виджета: внизу слева, внизу по центру или внизу справа.
  • Размеры окна чата: ширина (300–700px) и высота (400–1200px).
  • Перетаскиваемая кнопка чата: позволяет посетителям перетаскивать кнопку запуска по странице. Полезно, если она закрывает важное содержимое.

Выберите цвета интерфейса чата:

  • Светлая и Тёмная являются фиксированными вариантами, одинаковыми для всех аккаунтов.
  • Свой вариант позволяет использовать собственную палитру. При выборе Свой вариант появляются настройки цвета фона, заголовка и его текста, акцента для кнопок, например начала чата на предварительном экране, подсказок и оценок, пузырька сообщения и его текста, текста AI, цвета ссылок, поля ввода, границ и других элементов. Каждый цвет проверяется на контраст WCAG AA относительно фона. При трудночитаемом сочетании появляется предупреждение.

Фирменные цвета заголовка и акцента задаются в Свой вариант. Светлая и Тёмная остаются нейтральными вариантами, поэтому переключение между ними не переносит пользовательский цвет.

В Прозрачность настройка Фон определяет прозрачность окна чата. Она работает с любой темой, а оттенок задаётся выбранной темой:

  • Сплошной: непрозрачный фон окна чата. Используется по умолчанию.
  • Стекло: окно становится прозрачным, а сайт за ним размывается, как за матовым стеклом. Оттенок белый в Светлая, тёмный в Тёмная и соответствует вашему фону в Свой вариант. Если в Свой вариант цвет заголовка отличается от фона, он сохраняется, чтобы фирменное оформление оставалось заметным. Непрозрачность стекла определяет, насколько сильно оттенок перекрывает страницу: от минимального уровня, при котором текст читается поверх любого сайта (50% для Светлая, 65% для Тёмная, в Свой вариант зависит от цветов), до 95%. Если ни одна непрозрачность не обеспечивает читаемость с вашими цветами Свой вариант, виджет использует сплошной фон, а настройки объясняют причину. Стекло остаётся выбранным и снова применяется после корректировки цвета текста или фона для достаточного контраста.

Прозрачность действует для Widget, в том числе на телефонах, и для Встроить. Полноэкранная Страница чата всегда имеет непрозрачный фон. Посетители, включившие на устройстве “Reduce transparency”, видят Сплошной в Chrome и Edge, которые передают эту настройку сайтам. В браузере без размытия Стекло остаётся почти непрозрачным, чтобы текст был читаемым.

При выборе Свой вариант у Страница чата появляются собственные цвета бокового меню: Фон боковой панели, Текст боковой панели, Наведение в боковой панели и Текст боковой панели при наведении. Они относятся только к полноэкранной Страница чата, а не к Widget или Встроить. Если не задавать цвета текста, Страница чата автоматически выберет читаемый цвет для выбранного фона.

Также можно настроить радиус углов, то есть скругление пузырьков, полей и кнопок, и размер текста. Обе настройки действуют во всех темах.

  • Голосовой ввод: посетители могут записывать голосовое сообщение через микрофон в чате. Запись преобразуется в текст в поле ввода, который можно отредактировать перед отправкой. Запись автоматически прекращается через две минуты. Доступно на платных тарифах.
  • Вложения файлов: разрешает прикреплять изображение или документ к сообщению. Включено по умолчанию; отключение убирает кнопку вложения из чата.
  • Автооткрытие виджета: автоматически открывает Widget при загрузке страницы.
  • Скрыть брендинг Quickchat AI: скрывает подпись “Powered by Quickchat AI” для полностью фирменного оформления. Доступно на тарифах с удалением брендинга.

Чтобы разрешить посетителям оценивать беседы, откройте Разговоры → Аналитика → Оценка разговора. На этой вкладке находятся и настройки, и результаты. См. Оценка бесед.

Откройте Каналы → Ваш сайт → Текстовое содержимое, чтобы изменить приветствие и другие тексты для посетителей:

  • Текст заголовка: текст вверху окна чата.
  • Приветственное сообщение: первое сообщение AI-агента в начале каждой беседы, например «Привет, нужна помощь?».
  • Показывать всплывающим: показывает приветствие в плавающем облачке рядом с кнопкой запуска, чтобы привлечь внимание до нажатия. Его также называют “teaser” или “launcher message”. Облачко использует сам текст Приветственное сообщение, поэтому для изменения содержимого редактируйте это поле.
  • Начальные фразы: до 3 примеров сообщений, которые посетитель видит до начала ввода. Нажатие отправляет выбранный пример первым сообщением. Это помогает направить пользователя к сильным сторонам AI, например «Как установить виджет?» или «Какие интеграции вы поддерживаете?».
  • Подсказка поля ввода: подсказка в пустом поле ввода сообщения.
  • Текст оговорки: текст позади беседы, обычно сообщающий, что пользователь общается с AI. Рекомендуем оставлять его понятным и заметным.

Раздел Экран перед чатом расположен под этими полями на той же вкладке Текстовое содержимое. Включите его там и отредактируйте заголовок, кнопку и текст сообщения.

Стандартный виджет сайта показывает на этом экране заголовок, сообщение и кнопку начала разговора. Полей для электронной почты и телефона здесь нет, поэтому сделать их обязательными до начала чата нельзя. Умный сбор данных может запросить их во время разговора. Для обязательного сбора контактов перед предоставлением доступа к чату нужна отдельная форма на сайте или собственная интеграция.

По умолчанию Текстовое содержимое показывается всем посетителям ровно в том виде, как вы его ввели. На платных тарифах можно добавить переводы по языкам, чтобы посетители видели виджет на своём языке.

  1. Откройте подраздел Текстовое содержимое и нажмите Перевести в Другие языки. Откроется панель Перевести текст виджета, где исходный текст показан рядом с переводами как По умолчанию (источник).
  2. Нажмите Добавить язык и выберите язык. Quickchat AI переведёт текущий текст. Проверьте и отредактируйте поля для языка: заголовок, приветствие, начальные фразы, подсказку ввода, предварительный экран и предупреждение. Изменения сохраняются автоматически.
  3. Пустое поле использует текст по умолчанию, поэтому переводить нужно только то, что хотите изменить. Если автоматический перевод не удался, можно ввести текст самостоятельно.

Число доступных языков зависит от тарифа.

Для Widget и Встроить Quickchat выбирает язык в следующем порядке:

  1. Явное переопределение в загрузчике: _quickchat("language", "de"). Вызовите его до _quickchat("init", ...).
  2. Атрибут <html lang> страницы. Например, <html lang="de"> включает немецкий перевод. Это рекомендуемый способ: корректно задайте lang на каждой локализованной странице, и виджет автоматически подстроится.
  3. Язык браузера посетителя, затем текст По умолчанию, если совпадений нет.

Если для языка посетителя нет перевода, он всегда увидит текст По умолчанию. Ничего не остаётся пустым.

Расширенные возможности: пользовательские параметры

Заголовок раздела «Расширенные возможности: пользовательские параметры»

Widget и Встроить Quickchat AI позволяют передавать пользовательские параметры при инициализации. Их можно использовать, чтобы:

  • улучшать аналитику: они доступны в экспорте CSV на платформе Quickchat
  • передавать значения в API Actions и, где разрешено, персонализировать ответы. AI получает отфильтрованную часть параметров, а не все значения. См. Контекст модели и авторизация

Примеры полезных параметров:

  • visitor_name: Mike
  • customer_tier: VIP
  • order_id: ord_123

visitor_name является распознаваемым ключом контакта. Пользовательские ключи вроде customer_tier можно хранить и использовать в Actions, но сама передача не гарантирует, что AI включит их в ответ. Считайте значения из браузера непроверенными данными, а не разрешением на доступ к аккаунту клиента.

Чтобы добавить такие параметры, включите следующий код в скрипт из Ваш сайт > Установка.

Widget и Встроить используют одинаковый формат вызова:

_quickchat("custom_params", {
"visitor_name": "Mike",
"customer_tier": "VIP",
"order_id": "ord_123",
});

Эти атрибуты назначаются каждой новой беседе. Рекомендуем ограничиться небольшим числом ключей.

Пользовательские параметры с именами snake_case, например order_id и customer_tier, можно подставлять прямо в API Actions как {{metadata_order_id}}, {{metadata_customer_tier}} и так далее. Подробнее в разделе Переменные AI Action.

Пример скрипта:

widget

<script>
(function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat");
_quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"});
_quickchat("init", "abcdefghij");
</script>

Встроить

<div id="quickchat-embedded" style="height:600px;overflow:hidden;"></div>
<script>
(function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat");
_quickchat("containerId", "quickchat-embedded");
_quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"});
_quickchat("init", "abcdefghij");
</script>

Встроить размещает AI-агента Quickchat AI непосредственно внутри страницы как встроенное окно чата вместо плавающего значка. Используйте его, если чат должен находиться в определённом месте: колонке справочного центра, странице контактов, боковой панели приложения и так далее.

  1. Получите код Встроить

    • Войдите в Quickchat AI App.
    • Откройте Каналы → Ваш сайт в левом боковом меню.
    • Нажмите вкладку Установка, затем раскройте Установить вручную с кодом.
    • Скопируйте код Встроить, включающий контейнер <div id="quickchat-embedded"> и загрузочный скрипт.
  2. Откройте HTML-файл сайта или страницу в конструкторе.

  3. Вставьте код

    • Добавьте код Встроить в <body> страницы.
    • Поместите его точно туда, где должно появиться окно чата. Размер задаётся <div>: измените встроенный style="height:600px" под нужное место в макете.
    • В конструкторе добавьте элемент кода или HTML в нужное место и вставьте фрагмент в него.

Встроить работает только тогда, когда конструктор помещает код непосредственно в страницу. Некоторые конструкторы, например Wix, показывают HTML-элементы в отдельном фрейме, где Встроить не загружается. Если чат не появился на опубликованной странице, добавьте Widget через общую настройку кода сайта либо поделитесь ссылкой на Страница чата.

Последнее обновление: