Интерфейс виджета для посетителя сайта

Окно и шапка

Эта статья объясняет, как пользоваться уже установленным виджетом. Если вы настраиваете его для своего сайта, начните с подключения и настроек канала. Доступные посетителю кнопки зависят от настроек владельца сайта.

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

Если рядом с названием в шапке есть значок информации, нажмите его, чтобы открыть данные пользователя. В открывшемся окне можно сменить язык, а для уже созданного диалога — скопировать ID диалога, например для обращения в поддержку. Это действия внутри окна информации, а не отдельные кнопки шапки.

Когда доступна новая версия, рядом появляется предупреждение «Доступно обновление». Нажмите его, прочитайте пояснение и выберите «Обновить», чтобы перезагрузить виджет.

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

Сообщение и ответ

Напишите вопрос в поле сообщения внизу чата.

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

Когда сообщение готово, нажмите стрелку отправки. С клавиатуры используйте Ctrl+Enter в Windows и Linux или Cmd+Enter в macOS.

До начала переписки под приветствием могут показываться кнопки с готовыми вопросами. Виджет берёт набор для текущего языка. Нажатие сразу отправляет текст выбранной кнопки как сообщение посетителя; активная кнопка показывает отправку, а остальные до её завершения недоступны. Если нужного варианта нет, посетитель вводит собственный текст обычным способом.

Пока агент готовит ответ, виджет может показывать безопасный этап работы: «Размышляет…», «Ищет информацию…», «Работает с внешним сервисом…», «Анализирует вложение…», «Создаёт изображение…», «Создаёт аудио…», «Готовит результат…», «Готовит вложение…», «Выполняет действие…» или «Завершает ответ…». Эти подписи не раскрывают запросы, результаты инструментов или внутренние рассуждения агента.

Вместо этапов можно оставить обычный статус «Агент печатает» или полностью скрыть индикатор. Вариант выбирается в инструментах агента в поле «Что отображать во время обработки». Отдельный переключатель «Показывать ответ по мере генерации» управляет постепенным появлением уже готовящегося текста и не заменяет эту настройку.

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

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

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

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

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

Вложения

В подготовленном вложении можно открыть изображение или убрать файл перед отправкой. Для аудио доступны воспроизведение и пауза, а также удаление.

В истории изображения открываются через просмотр изображения, видео через просмотр видео, а стикеры через просмотр стикера. Результат распознавания открывается через информацию о вложении, а "Назад" возвращает к сообщению.

Диалоги и поиск

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

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

Чтобы открыть полный список диалогов, нажмите значок списка слева от заголовка «Чаты» в этом меню. На открывшемся экране выберите нужный диалог или воспользуйтесь поиском. Очистка строки возвращает полный список. Если совпадений нет, доступен сброс поиска; если переписок ещё не было — создание первого диалога.

Если список не загрузился, повторная загрузка диалогов запрашивает данные заново.

Лимит кредитов

Если для посетителя действует персональный лимит:

1. Нажмите кольцевой индикатор в шапке. Он показывает процент доступных кредитов.

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

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

Если владелец виджета включил предложение пополнения, посетитель может нажать «Пополнить». Эта кнопка только сообщает сайту о запросе: оплату и последующее начисление организует владелец сайта. Если канал позволяет подключить внешний AI, рядом может появиться «Подключить свой ИИ».

Настройка правил описана в статье «Лимиты кредитов для лидов». Назначение обеих кнопок и различия между ними приведены в разделе «Лимит кредитов посетителя», обработка кнопки «Пополнить» — в Public API виджета, а подключение ИИ-клиентов — в разделе «Работа через MCP».

Просмотр и ошибки

В просмотре изображения доступны увеличение, уменьшение, сброс масштаба и закрытие. У видео есть отдельная кнопка закрытия.

Во время запуска, загрузки диалогов и загрузки сообщений виджет показывает текущее действие, поэтому пустой экран не нужно принимать за готовое состояние. При подключении могут появляться сообщения «Устанавливаем соединение…» или «Восстанавливаем соединение…». Виджет продолжает попытки автоматически и возвращает чат после восстановления связи.

Если связь потеряна, детали соединения помогают понять состояние. Действие «Скопировать для поддержки» копирует диагностические сведения, которые можно передать специалисту без ручного переписывания ошибок. Оно может появиться для разных этапов:

• первая загрузка списка диалогов и его фоновое обновление;
• загрузка списка в меню истории и его обновление;
• первая загрузка сообщений открытого чата и их фоновое обновление;
• отправка сообщения, загрузка вложения и получение потокового ответа.

Общую ошибку можно повторить или исправить перезагрузкой. Если ошибка произошла при самом запуске интерфейса, виджет также предлагает повторить загрузку или перезагрузить окно.

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

Если не загрузилась история открытого чата, повторная загрузка истории восстанавливает сообщения без создания нового диалога.