Виджет на сайте

Виджет показывает посетителю кнопку чата и окно переписки. Через него клиент пишет с сайта, а оператор отвечает из EasyChat или Android-приложения.

Живой виджет на easychat24.ru работает на том же runtime, что и виджет после установки. Его можно открыть на любой странице сайта EasyChat и заранее посмотреть путь посетителя, не устанавливая модуль. На главной странице компьютера демонстрационное окно само раскрывается через 3 секунды. На телефоне оно остаётся свёрнутым, чтобы не закрывать содержание. На сайте клиента автопоказ определяется его собственной настройкой виджета.

Цвета и оформление EasyChat — инструкция со скриншотами.

Где Работает Виджет

Виджет работает на домене, для которого установлен EasyChat, и на разрешенных поддоменах. Например, если EasyChat установлен для example.ru, виджет можно использовать на example.ru, shop.example.ru и других поддоменах этого домена.

Если виджет нужен на другом домене, проверьте настройки лицензии или обратитесь в поддержку EasyChat24.

Язык Виджета

Откройте настройки виджета в админке EasyChat.

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

Автовыбор меняет только интерфейс виджета: кнопки, подсказки и ошибки. Сообщения посетителей не переводятся автоматически.

Положение Кнопки

В настройках выберите сторону экрана и отступы. На компьютере окно чата открывается рядом с кнопкой. На телефоне окно занимает почти весь экран, чтобы посетителю было удобно читать и писать.

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

Приветствие И Контакты

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

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

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

Используйте короткий текст приветствия. Он должен помогать начать диалог, а не повторять описание компании.

Сообщения, Ссылки И Разметка

Авторизованный клиент и заказы

В поддерживаемых CMS EasyChat узнаёт вошедшего на сайте клиента по его учётной записи. Посетителю не нужно повторно вводить email: в шапке появляется короткий статус Вы вошли как … ✓, а оператор получает подтверждённые имя, email и телефон из профиля сайта. Если магазин подключил контекст заказов, первый вопрос «Что с моим заказом?» уже относится к нужному клиенту.

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

В верхней части виджета видны оператор и его статус. Длинное имя аккуратно переносится максимум на две строки, поэтому не сжимает область переписки. Рядом показывается ориентир по времени ответа: до десяти минут — точное значение, при более долгом среднем — спокойное ~10 мин.. Внутренняя аналитика EasyChat при этом сохраняет точные данные.

Виджет поддерживает обычные сообщения, переносы строк и кликабельные ссылки. Если в сообщении есть адрес вида https://..., он становится ссылкой.

Markdown-ссылка тоже отображается понятно: например, [ссылка на наш RuTube канал](https://rutube.ru/...) будет показана как кликабельный текст ссылка на наш RuTube канал.

Ссылки открываются в новой вкладке и проходят безопасную обработку. Небезопасный HTML не выполняется.

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

Когда посетитель действительно увидел ответ оператора, EasyChat может показать оператору отметку Прочитано. Одной загрузки сообщения для этого недостаточно: окно виджета должно быть открыто, вкладка активна, а пузырь ответа находиться на экране короткое время. Так скрытая вкладка и быстрая прокрутка не создают ложное подтверждение.

Файлы И Изображения

Посетитель и оператор могут обмениваться изображениями и документами PDF, DOC, DOCX, ODT, ODS, ODP. PDF-превью открывается в удобном просмотре, а Word/OpenDocument показываются понятной карточкой формата. Оригинальный файл скачивается только по явному действию пользователя.

Если файл не проходит проверку по типу или размеру, EasyChat покажет понятную ошибку.

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

Если в настройках выбран EasyTokens и включён ИИ-консультант, фотография может стать частью вопроса: ИИ учитывает изображение, подпись и предыдущие сообщения. Для приватности EasyChat готовит уменьшенную копию без metadata и не публикует адрес файла. Визуальный ответ приходит через обычную очередь, поэтому закрытая вкладка не прерывает обработку.

На официальном сайте EasyChat справочный консультант начинает готовить ответ сразу после отправки вопроса через отдельный асинхронный запрос. Он не ждёт очередного запуска cron; виджет показывает понятный индикатор подготовки до появления проверенного ответа.

Уведомления Посетителю

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

Проверка:

1. Откройте виджет.
2. Отправьте тестовое сообщение.
3. Нажмите колокольчик.
4. Разрешите уведомления в браузере.
5. Ответьте из EasyChat.
6. Убедитесь, что браузер показал уведомление.

Проверяйте уведомления в обычном окне браузера. В режиме инкогнито браузеры могут вести себя иначе.

Экономия Ресурсов

Когда посетитель активно пишет или читает чат, виджет обновляет переписку быстро. Затем включается экономный режим фоновой вкладки: открытый неактивный чат проверяет ответы примерно раз в 30 секунд, а закрытый или скрытый — не чаще раза в 60 секунд. При включённых уведомлениях скрытая вкладка может полностью уснуть и дождаться push, не создавая лишнюю нагрузку на магазин.

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

По нажатию на push-уведомление EasyChat открывает чат, сразу запрашивает новые сообщения и ставит курсор в поле сообщения. Если ответ ИИ настроен с задержкой, виджет ставит отложенный AI-ответ в серверную очередь, поэтому закрытая вкладка не прерывает обработку.

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

Проверка После Настройки

1. Откройте сайт в новом окне браузера.
2. Нажмите кнопку чата.
3. Отправьте тестовое сообщение.
4. Ответьте из админки или Android-приложения.
5. Проверьте, что ответ появился в виджете.
6. При необходимости проверьте файл, ссылку и уведомление.
7. На тестовом аккаунте войдите в магазин и отправьте первое сообщение про заказ: имя должно появиться без формы email, а в EasyChat — email и телефон.
8. Повторите путь «сообщение гостем → вход → ещё одно сообщение» и убедитесь, что в админке остался один диалог.

Частые Ситуации

• Кнопка не видна. Проверьте, что виджет включен, код добавлен на нужную страницу и кеш сайта очищен.
• Виджет открыт не на том языке. Проверьте ручной язык или автовыбор в настройках.
• Уведомления не включаются. Проверьте HTTPS, разрешение уведомлений в браузере и попробуйте обычное окно без режима инкогнито.
• Файл не отправляется. Проверьте тип и размер файла.
• Сообщение приходит с задержкой. Проверьте фоновую задачу EasyChat на хостинге.

Мини-Чеклист

• Виджет включен в админке.
• Кнопка видна на сайте.
• Язык и положение подходят сайту.
• Тестовый диалог создан.
• Ответ оператора виден посетителю.
• Ссылка, файл и уведомление проверены при необходимости.