Обзор виджета
Виджет UserJot объединяет отзывы, дорожную карту, обновления продукта, статьи справочного центра и личные сообщения в одной панели запуска на вашем сайте.
API, описанный в этой подборке, стабилен. Со временем мы добавляем новые возможности, не переименовывая методы и не нарушая существующую функциональность.
Что входит в виджет
Нижняя панель навигации автоматически адаптируется к функциям, включённым в вашем рабочем пространстве:
Главная: отображается всегда. Здесь показываются последние обновления, ссылки на справку, важные события по текущей дорожной карте (если она включена) и активность текущего пользователя.
Сообщения: отображается, если включены Беседы. Прямой чат между клиентами, Juno и вашей командой.
Справка: отображается, если опубликован ваш Справочный центр. Ищите статьи справки и читайте их в приложении.
Обратная связь: отображается всегда. Просматривайте и ищите отзывы, голосуйте, комментируйте и отправляйте обратную связь, не покидая приложение (дорожная карта также доступна в разделах «Обратная связь» и «Главная» или открывается напрямую с помощью
uj.open({ to: 'roadmap' })). Когда клиент вводит новую идею (от 3 символов), в редакторе в реальном времени отображается карточка-подсказка Уже есть на доске, если похожий запрос уже существует.Обновления: отображается, если включён публичный журнал обновлений; на кнопке открытия виден индикатор непрочитанных обновлений.
Уведомления: у идентифицированных пользователей отображаются в виде колокольчика в заголовке и сообщают об активности в запросах, за которыми они следят.
В окне просмотра на компьютере (шире 760px) открытый виджет запоминает состояние, экран и положение прокрутки при перезагрузке страницы и переходах в той же вкладке в течение 30 минут. Статьи справки и обновления журнала обновлений автоматически открываются в более широкой области просмотра на компьютере, а в ветках бесед есть кнопка разворачивания.
Создание скриншотов и добавление аннотаций
Клиенты могут прикрепить к отправляемому через виджет отзыву до 4 изображений (PNG, JPEG или WebP, размером до 10 МБ каждое): выбрав файлы, вставив их из буфера обмена или нажав кнопку камеры, чтобы сделать скриншот.
Создание скриншота с резервным способом: нажатие кнопки скриншота запускает захват вкладки или экрана браузера (
getDisplayMedia) и автоматически переключается на захват DOM страницы, если захват экрана недоступен (поверхности виджета автоматически скрываются).Встроенный редактор аннотаций: перед прикреплением скриншота клиенты могут добавить на него пометки с помощью шести инструментов с одноклавишными сочетаниями: Выбор (V), Перо (P), Стрелка (A), Прямоугольник (R), Текст (T) и пикселизация для Скрытия (B), а также шести цветов, отмены действия и Удаления / Backspace для удаления выбранных фигур.
Маскирование конфиденциальных данных: при захвате DOM страницы UserJot автоматически маскирует поля ввода
password,emailиtel, поля ввода сtokenилиsecretв ихname, а также текстовые области с атрибутомdata-userjot-sensitive. Добавьтеdata-userjot-capture-ignore, чтобы исключить любой элемент DOM из захвата, илиdata-userjot-capture-mask, чтобы автоматически скрыть его содержимое.
Разрешения, редактирование и модерация
Анонимные и идентифицированные пользователи: анонимные посетители могут просматривать материалы, отправлять новые отзывы, начинать гостевые беседы и реагировать на обновления журнала. Чтобы голосовать за отзывы, оставлять комментарии и просматривать колокольчик уведомлений в виджете, требуется идентифицированный пользователь.
Редактирование и удаление собственных материалов: клиенты могут редактировать (заголовок и текст публикаций; текст комментариев) и удалять собственные публикации и комментарии прямо в меню
.... В виджете для редактирования и удаления собственных публикаций или комментариев требуется подтверждённая идентификация (в сеансахuj.identifyбез идентификации нельзя редактировать или удалять материалы).Модерация: отзывы, отправленные через виджет, проходят модерацию согласно настройкам вашего рабочего пространства. Подтверждение сообщает, что отзыв сохранён; перед публикацией на общедоступной доске он всё ещё может требовать проверки. См. раздел Модерация материалов.
Виджет принимает анонимные отправки на любом тарифе, независимо от настройки Отправка гостями на общедоступной доске. Эта настройка относится только к общедоступной доске. Поскольку виджет можно настраивать программно, вы сами решаете, когда загружать или показывать его (например, только пользователям, вошедшим в систему). Для отправки отзыва идентификация не обязательна.
Что можно сделать с помощью виджета
Виджет работает сразу после установки с помощью простого фрагмента кода, который достаточно скопировать и вставить, а SDK позволяет управлять им программно:
Открывайте любой раздел виджета из собственного интерфейса с помощью open().
Замените стандартную панель запуска собственной кнопкой с динамическим индикатором непрочитанных сообщений.
Идентифицируйте вошедших в систему пользователей, при необходимости проверяя их на сервере с помощью подписанной идентификации (JWT HS256).
Реагируйте на события виджета, например на его открытие и закрытие, изменение статуса присутствия и количества непрочитанных сообщений.
Встраивайте целые страницы прямо в приложение вместо использования плавающей панели запуска.
Рекомендуемый порядок действий
Установите виджет всего за несколько минут.
Идентифицируйте пользователей, чтобы отзывы и сообщения связывались с реальными учётными записями.
Добавьте подписанную идентификацию, чтобы проверять пользователей на сервере, или настройте Автоматический вход и Единый вход для открытых страниц.
Изучите разделы Управление виджетом, Встраивание страниц и Справочник SDK.