Встроенный чат: встраивание и Настройки

Встроенный чат

Встроенный чат (<web-chat-agent-inline>) отображается внутри макета страницы, а не поверх нее. Используйте его для справочного центра, консультанта по продуктам, внутреннего портала или полностраничного ассистента.

Откройте Панель управления → ваш ассистент → Каналы → Встроенный чат. У канала есть собственный код установки, настройки и предпросмотр. Он может работать на том же сайте, что и плавающий виджет чата, с другим заголовком, приветственным контентом, высотой, подсказками и оформлением.

Онлайн-чат с вашей командой работает во встроенном чате так же, как в плавающем виджете чата. Оба используют один и тот же переключатель на карточке Онлайн-чат и передача оператору во вкладке Функции. Что видят посетители, описано ниже в разделе Онлайн-чат во встроенном чате.

Установите встроенный чат

Разверните Показать сведения об установке и скопируйте готовый код. Формат для ручной установки:

<script src="https://webchatagent.com/widget/chat-widget-inline.js" async></script>
<web-chat-agent-inline chatbot-id="YOUR_CHATBOT_ID"></web-chat-agent-inline>

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

<div style="max-width: 720px; margin: 0 auto;">
  <web-chat-agent-inline chatbot-id="YOUR_CHATBOT_ID"></web-chat-agent-inline>
</div>

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

Внешний вид

НастройкаЧто изменяет
TitleЗаголовок на начальном экране. Оставьте пустым, чтобы скрыть заголовок.
Основной цветАкцентный цвет для кнопок и сообщений посетителя.
Цвет текста темы, сообщений бота и пользователяСобственные цвета для текста на основном цвете (кнопка отправки), а также фон и текст ответов и сообщений посетителя. Пустые поля автоматически подстраиваются под основной цвет, стрелка рядом с полем сбрасывает его. Если текст плохо читается, панель предупреждает и показывает коэффициент контраста.
Семейство шрифтовШрифт виджета. Выберите в поиске Google Fonts или укажите название своего шрифта.
ВысотаВысота контейнера чата в виде CSS единицы измерения, например 600px, 80vh или 100%.
Приветственное сообщениеКонтент, который отображается до первого сообщения посетителя.

Предпросмотр обновляется с учетом этих настроек. Отправка сообщения в предпросмотре обращается к реальному ассистенту и расходует стандартную квоту сообщений.

Изображения

Добавьте необязательное Приветственное изображение с помощью загрузки или по URL. Оно отображается на начальном экране над приветственным сообщением. Используйте оптимизированный логотип или баннер и проверьте результат при минимальной ширине контейнера на вашем сайте.

Контент и поведение

НастройкаЧто изменяет
Приветственное сообщениеВводный текст с форматированием над полем ввода до первого сообщения.
Показывать источникиДобавляет ссылки на доступные источники к ответам.
Пометка ИИ под ответами ботаОтмечает каждый ответ ассистента как созданный искусственным интеллектом. Всегда включено.
Автоматический переводПереводит элементы интерфейса на определенный язык посетителя.
Загрузка файловПозволяет посетителям прикреплять файлы, если это предусмотрено тарифом.
Кнопки подсказокСтартовые вопросы на начальном экране, также называемые предложенными вопросами или подсказками для начала диалога. Каждый элемент содержит отображаемый заголовок и отправляемое сообщение ассистенту. До 10 элементов.

Кнопки подсказок можно сгенерировать с помощью ИИ или добавить вручную. Не делайте список слишком длинным и используйте вопросы, демонстрирующие реальные знания ассистента.

Дополнительно

НастройкаЧто изменяет
Источник определения языкаИспользует язык браузера или атрибут <html lang> страницы для автоматического перевода.
Скрыть брендингУдаляет ссылку «Powered by», если это разрешено тарифом.
Пользовательский CSSВнедряет CSS во встроенный виджет с использованием документированных стабильных селекторов.

Редактор CSS содержит готовые шаблоны, справочник стабильных селекторов, счетчик символов и предпросмотр. См. Пользовательский CSS.

Онлайн-чат во встроенном чате

Когда Онлайн-чат включен, встроенный чат передает диалог вашей команде так же, как плавающий виджет чата. После того как чат-бот передал диалог:

  • Строка состояния над полем ввода показывает «Ожидание оператора...», а когда сотрудник подключился, «Оператор присоединился к чату.»
  • Сообщения посетителя идут напрямую сотруднику.
  • В меню чата есть пункт Завершить живой чат. Пункты Начать новый чат и Просмотр недавних чатов во время онлайн-чата недоступны.
  • У сообщений вашего сотрудника нет пометки «ИИ-агент» и нет оценки пальцем.
  • Загрузка файлов во время онлайн-чата скрыта.

Ваша команда видит встроенный чат в Панели управления онлайн-чата, как только посетитель что-то написал, и может перехватить его без запроса. В AI Team Wiki онлайн-чат недоступен.

Необязательные атрибуты контекста

Встроенный элемент принимает атрибуты tracking-consent и context-data в дополнение к chatbot-id. Данные контекста позволяют передавать неконфиденциальную информацию о сессии со страницы встраивания:

<web-chat-agent-inline
  chatbot-id="YOUR_CHATBOT_ID"
  context-data="Customer=Jane Doe;OrderID=A-1023"
></web-chat-agent-inline>

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

Плавающий или встроенный

Виджет чатаВстроенный чат
РазмещениеФиксированная плавающая кнопка и оверлейВнутри макета страницы
Элемент<web-chat-agent><web-chat-agent-inline>
Скрипт/widget/web-chat-agent.js/widget/chat-widget-inline.js
Облачко сообщения и проактивные триггерыДаНет
Action Bar и формыДаНет
Переключение на живой чатДаДа
НастройкиКаналы → Виджет чатаКаналы → Встроенный чат

Проверка перед публикацией

  1. Сохраните настройки встроенного чата.
  2. Отправьте один вопрос по базе знаний в окне предпросмотра.
  3. Откройте реальную страницу и проверьте высоту, прокрутку, загрузку шрифтов, источники и кнопки подсказок.
  4. Проверьте отображение в самом узком мобильном контейнере.
  5. Если установлены оба типа виджетов, убедитесь, что они используют независимые настройки.