Руководство пользователя и администратора
Руководство описывает работу в панели управления программы «Парсвайс» и во встраиваемом виджете чата. Правообладатель — индивидуальный предприниматель Крылов Руслан Хуважиевич. Названия разделов, полей и кнопок приводятся так, как они показаны в русском интерфейсе.
Рабочее пространство, в котором хранятся база знаний, настройки ассистента, чаты и команда, в руководстве называется проектом.
Руководство для пользователя — разделы 1–3, 5 и 9. Руководство для администратора — все разделы.
1. Структура панели
Слева расположено меню проекта. Состав меню зависит от роли участника.
| Группа меню | Пункты | Кому доступны |
|---|---|---|
| Обзор | Главная | всем, кроме гостя |
| База знаний | Товары, Профили, Файлы | всем, кроме гостя |
| Ассистент | Персона, Скилы, Коннекторы, Виджет | владельцу, администратору и редактору |
| Ассистент | Чаты | всем ролям |
| Настройки | Команда, API токены, Биллинг, Общие | владельцу и администратору |
| Недавние чаты | последние чаты проекта | всем ролям |
| Быстрые действия | Новый чат, Поиск, Центр помощи | всем ролям |
Над меню находится переключатель проектов, внизу — меню учётной записи.
2. Роли
| Роль | Что доступно |
|---|---|
| Владелец | всё, что доступно администратору, и передача владения проектом другому участнику |
| Администратор | все разделы меню, управление командой, API-токенами, биллингом и общими настройками проекта |
| Редактор | главная, база знаний, чаты, «Персона», «Скилы», «Коннекторы» и «Виджет»; создание, импорт и изменение товаров, профилей и файлов, настройка ассистента и виджета, установка и изменение скилов |
| Наблюдатель | главная, база знаний и чаты; база знаний доступна для просмотра без изменения |
| Гость | только собственные чаты: общение с ассистентом, оценка ответов, новый чат |
Гость — внешний пользователь, приглашённый по ссылке для гостей. Гость видит только те чаты, которые создал сам.
3. Вход и учётная запись
Вход
Страница «Вход» содержит поля «Email» и «Пароль», флажок «Запомнить меня» и ссылку «Забыли пароль?». Под формой в блоке «Или продолжите через» расположены кнопки входа через Яндекс ID, VK ID и «Корпоративный вход (SSO)». Корпоративный вход работает, если для организации пользователя настроен SSO; в противном случае программа сообщает «Для этого домена вход через SSO не настроен».
Регистрация
- Откройте страницу «Регистрация» по ссылке «Зарегистрироваться» на странице входа.
- Заполните поля «Email», «Имя», «Фамилия», «Пароль» и «Подтвердите пароль». Пароль должен содержать не менее 8 символов, заглавную и строчную буквы и цифру.
- При желании отметьте «Получать письма об обновлениях продуктов».
- Отметьте согласие «Я принимаю Условия использования и Политика конфиденциальности». Условия использования опубликованы по адресу https://parsewise.ru/policy/offer, политика конфиденциальности — https://parsewise.ru/policy/privacy.
- Нажмите «Регистрация».
- Введите шестизначный код из письма и нажмите «Подтвердить». Если письмо не пришло, нажмите «Отправить код повторно».
Восстановление пароля
- На странице входа нажмите «Забыли пароль?».
- Укажите адрес электронной почты и нажмите «Отправить ссылку».
- Перейдите по ссылке из письма и задайте новый пароль.
Меню учётной записи
Меню содержит пункты «Мой аккаунт», «Сменить аккаунт», «Добавить аккаунт», «Политика конфиденциальности», «Оставить отзыв» и «Выйти». В одном браузере можно держать несколько учётных записей и переключаться между ними без повторного ввода пароля; лишние записи удаляются в окне «Управление аккаунтами».
Настройки аккаунта
| Блок | Что можно сделать |
|---|---|
| Профиль | изменить имя и фамилию, загрузить фото профиля или выбрать стандартный аватар |
| Изменить Email | указать новый адрес и подтвердить смену кодом из письма |
| Изменить пароль | ввести текущий и новый пароль |
| Связанные аккаунты | привязать или отвязать Яндекс ID и VK ID |
| Настройки интерфейса | выбрать внешний вид — системный, светлый или тёмный — и язык интерфейса |
| Удалить аккаунт | безвозвратно удалить учётную запись с подтверждением словом delete |
4. Проект
Создание проекта
- В переключателе проектов выберите «Новый проект…».
- Укажите «Название проекта» и «Описание проекта». Описание помогает ассистенту лучше понимать контекст общения.
- Нажмите «Создать проект».
Главная
Раздел «Главная» открывает обзор проекта. В шапке расположены кнопки «Настройки», «Ссылки-приглашения» и «Пригласить участника»; две последние доступны владельцу и администратору.
Блок «Аналитика» показывает показатели за выбранный период: «Создано чатов», «Ср. сообщений в чате», «Ср. время сессии», «Средняя оценка», «Предложено товаров», «Предложено профилей», «Показов документов», «Предложено скилов», «Запусков коннекторов». Ниже расположены списки «Недавние чаты», «Недавние треды», «Недавние товары», «Последние профили» и «Последние файлы».
Общие настройки
Раздел «Настройки → Общие» доступен владельцу и администратору.
| Блок | Параметры |
|---|---|
| Основная информация | название и описание проекта, логотип |
| Цвета | основной цвет, цвет текста |
| Адрес проекта | адрес проекта: строчные латинские буквы, цифры и дефисы, от 3 до 32 символов |
| Корпоративный вход (SSO) | «Включить SSO», «Issuer (адрес IdP)», «Client ID (audience дашборда)», «Client Secret» с кнопками «Сгенерировать» и «Перегенерировать» |
| Безопасность | «Разрешать пользователям загружать файлы», «Подсвечивать файлы», «Автоостановка при запросе оператора», «Лимит токенов на пользователя в день», «Режим разработчика» |
| Вопросы | «Период сбора вопросов»: день, неделя, месяц, квартал, полгода или год |
Кнопка «Удалить» в шапке раздела удаляет проект со всеми данными. Для подтверждения нужно ввести название проекта.
5. Чаты
Раздел «Ассистент → Чаты» предназначен для общения с ассистентом и анализа обращений. В шапке расположены кнопки «Треды», «Темы» и «Вопросы», которые прокручивают страницу к соответствующему блоку, и кнопка «Новый чат». Гость видит только кнопку «Новый чат» и свои чаты.
Диалог
- Нажмите «Новый чат» или откройте чат из списка.
- Введите сообщение в поле «Введите сообщение...» и нажмите «Отправить». К сообщению можно прикрепить файлы: не более 10 файлов, до 5 за один раз, каждый размером до 10 МБ.
- Ассистент отвечает текстом, карточками товаров и профилей, карточками скилов и ссылками на файлы базы знаний с подсвеченным фрагментом, на который он опирался.
- Оцените ответ кнопками «Плохо», «Средне» или «Хорошо».
- Чтобы оценить весь чат, нажмите «Оценить» и поставьте от одной до пяти звёзд с комментарием.
Участник команды может взять диалог на себя: кнопка «Остановить агента» выключает ответы ассистента в этом чате, после чего команда ведёт переписку вручную. Кнопка «Включить агента» возвращает автоматические ответы. Если в общих настройках включена «Автоостановка при запросе оператора», ассистент останавливается сам, когда пользователь просит оператора.
Аналитика
Блоки расположены на странице сверху вниз.
| Блок | Содержание |
|---|---|
| Аналитика | «Всего чатов», «Ср. сообщений в чате», «Ср. время сессии», «Средняя оценка» |
| Список чатов | чаты проекта; «Режим выбора» для удаления нескольких чатов |
| Треды | законченные вопросы: «Всего тредов», «Ср. сообщений в треде», «Средняя оценка», «Решено»; фильтры «Все темы» и «Все авторы», сортировка, кнопка «Экспорт CSV» |
| Темы | «Всего тем», «Новые темы», «Активные темы», «Топ-тема»; дерево тематик обращений с вложенными подтемами, которое строится автоматически; «Поиск по темам», период, сортировка; выбор темы фильтрует треды |
| Вопросы | «Активные вопросы», «Веток в топе», «Веток на вопрос», «Средняя оценка»; группы типовых вопросов с частотой и оценкой, «Поиск по вопросам», сортировка |
Список вопросов пересобирается раз в сутки. Период сбора задаётся в разделе «Общие», блок «Вопросы».
6. База знаний
Файлы
- Нажмите «Загрузить файлы» или перетащите файлы в окно раздела.
- Если файл с таким именем уже есть, программа покажет окно «Обнаружены дубликаты файлов»: «Загрузить» сохраняет копию, «Заменить» заменяет существующий файл.
Панель принимает файлы размером до 50 МБ: документы PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, CSV, JSON, XML, MD, RTF, ODT, ODS, ODP, HTML, а также изображения, видео, аудио и архивы.
Кнопка «Загрузить по ссылке» открывает окно «Документы по ссылке». Источником может быть «Облачная папка (S3)», «Папка на сайте», «Список ссылок» или «Сайт». Программа скачивает содержимое и обновляет его раз в сутки, а также по кнопке «Обновить»; загрузку можно прервать кнопкой «Остановить». Состояние источника показывается статусами «Выполнено», «Остановлено», «Ошибка» или «Ещё не синхронизировано». При удалении источника программа спрашивает, оставить загруженные файлы или удалить их.
Товары
Создание вручную. Кнопка «Создать товар» открывает форму:
| Блок | Поля |
|---|---|
| Медиа товара | изображения и видео, не более 10 файлов на товар |
| Основная информация | «Название товара», «Описание», «Цена», «Цена со скидкой», «Артикул / SKU», «Бренд» |
| Ссылки | адреса страниц товара и «Текст кнопки» для каждой ссылки |
| Атрибуты товара | характеристики: размеры, цвет, материал и другие |
| Скрыть из ответов | ассистент не будет предлагать товар |
Импорт из файла. Кнопка «Импорт из файла» принимает файлы CSV, XLSX, XLS, JSON, XML, YML и YAML. Если товары уже есть в проекте, программа предлагает загрузить их повторно или заменить существующие.
Фид по ссылке. Кнопка «Загрузить по ссылке» открывает окно «Фиды товаров». Можно добавить одну или несколько ссылок на фид в форматах YML, XML, CSV, XLSX или JSON. Фид синхронизируется раз в сутки и по кнопке; товары сопоставляются по артикулу.
Карточка товара. Блок «Аналитика товара» показывает «Предложено», «Открыто карточек», «Кликов на CTA» и «Конверсия» за выбранный период. Кнопка «Удалить товар» удаляет товар.
Профили
Раздел «Профили» содержит каталог людей, которых рекомендует ассистент: специалистов, сотрудников, консультантов.
- «Создать профиль» — создание профиля вручную.
- «Импорт из файла» — загрузка файлов CSV, XLSX, XLS, JSON, XML, YML и YAML; соответствие колонок полям профиля определяется автоматически.
- «Загрузить по ссылке» — окно «Фиды профилей»; фид синхронизируется раз в сутки и по кнопке, профили сопоставляются по внешнему коду — табельному номеру, идентификатору сотрудника или коду из CRM.
7. Ассистент
Персона
Раздел «Персона» доступен владельцу, администратору и редактору. Блок «Настройки ассистента» содержит поля «Имя ассистента» — имя, которое отображается в чате виджета, — и «Правила ответов (опционально)», где свободным текстом задаются тон, стиль и границы ответов. «Аватар ассистента» можно загрузить или выбрать среди стандартных аватаров в группах «Фотографии» и «Иллюстрации».
Скилы
Раздел «Скилы» доступен владельцу, администратору и редактору; удаление скила, публикация, отправка на ревью и снятие с публикации — только владельцу и администратору. Скил — навык ассистента со своим интерфейсом в ленте ответа: интерактивной карточкой, формой, калькулятором, расписанием.
- Установите скил из каталога по кнопке «Маркетплейс» или загрузите файл по кнопке «Загрузить .skill».
- При загрузке стороннего файла подтвердите доверие в окне «Доверять этому скилу?» кнопкой «Доверяю и установить».
- Если скил с таким именем уже есть, выберите «Обновить» или «Создать копию».
Кнопка «Скил-креатор» открывает материалы для разработки собственных скилов. Несколько скилов можно отключить или удалить через «Режим выбора».
Карточка скила содержит блоки «Общее», «Карточка», «Drawer», «Ресурсы», «Заявки», «Коннекторы» и «Логи». В блоке «Заявки» собираются данные форм скила, их можно выгрузить кнопкой «Скачать CSV»; журнал вызовов выгружается кнопкой «Скачать .log». Действия со скилом:
| Кнопка | Действие |
|---|---|
| Активировать / Деактивировать | включить или выключить скил в чате |
| Сделать форк | создать копию установленного скила в проекте для доработки |
| Опубликовать / Отправить на ревью | отправить скил или правки на проверку для публикации в маркетплейсе |
| Снять с публикации | скрыть скил из каталога маркетплейса |
| Удалить из проекта | удалить установленный из маркетплейса скил из проекта |
| Удалить | безвозвратно удалить скил |
Коннекторы
Раздел «Коннекторы» доступен владельцу, администратору и редактору; удаление коннектора — только владельцу и администратору. Коннектор — пакет без интерфейса, который даёт ассистенту доступ к инструментам внешних систем.
- Установите коннектор по кнопке «Маркетплейс» или загрузите файл по кнопке «Загрузить .skill».
- При загрузке стороннего файла подтвердите доверие кнопкой «Доверять и установить».
- В карточке откройте блок «Коннекторы» и нажмите «Настроить», чтобы задать секреты авторизации.
- Проверьте инструменты сервера кнопкой «Тест».
Виджет
Раздел «Виджет» доступен владельцу, администратору и редактору. Блок «Аналитика» показывает «Показов виджета», «Открытий виджета», «Создано чатов» и «Конверсия».
| Блок | Параметры |
|---|---|
| Настройки виджета | «Текст кнопки»; «Язык» интерфейса виджета, при этом ассистент отвечает на языке вопроса; «Ширина кнопки»; «Позиция» — «Слева внизу», «По центру внизу», «Справа внизу»; «Тема»; «Прозрачность»; «Показать виджет после прокрутки» и «Порог прокрутки» |
| Доступ и авторизация | «Кто может писать в чат» — «Все посетители» или «Только авторизованные»; «Способ авторизации пользователей» — «Общий секрет (HS256)» с полем «Секрет подписи» или «Корпоративный SSO (Keycloak/ADFS)» с полями «Issuer (адрес IdP)» и «Client ID (audience виджета)»; «Автозачисление сотрудников в команду» |
| Доверенные домены | домены, на которых разрешено подключение виджета; пустое поле — без ограничений |
При включённом «Автозачислении сотрудников в команду» авторизованные пользователи виджета становятся участниками проекта и занимают места тарифа; при выключенном — тарифицируются как треды.
Установка виджета на сайт. Кнопка «Установка» в шапке раздела переходит к инструкции. В списке «Выберите платформу» доступны HTML/CSS, Tilda, 1С-Битрикс, InSales, OpenCart, Shop-Script, CS-Cart, uniSiter, Smink, WordPress, Next.js, React и Angular; для каждой платформы показаны пошаговые действия. Для сайта на HTML:
- Скопируйте код установки, нажав на поле с кодом.
- Откройте HTML-файл сайта, например index.html или главный шаблон.
- Вставьте код перед закрывающим тегом
</head>. - Сохраните файл и откройте сайт: в нижней части страницы появится кнопка виджета.
8. Команда, API токены, биллинг
Команда
Раздел «Команда» доступен владельцу и администратору.
- Нажмите «Пригласить участника», укажите «Email адрес» и «Роль» — администратор, редактор, наблюдатель или гость — и нажмите «Отправить приглашение».
- Чтобы пригласить нескольких человек, нажмите «Ссылки-приглашения» и создайте ссылку кнопкой «Для администраторов», «Для редакторов», «Для наблюдателей» или «Для гостей». Активные ссылки можно скопировать или удалить.
В окне участника можно изменить роль в поле «Изменить роль» и сохранить, удалить участника кнопкой «Удалить участника», для неподтверждённого приглашения — «Отменить приглашение». Владелец может нажать «Сделать владельцем» и подтвердить «Передать владение» вводом слова transfer; после передачи прежний владелец становится администратором.
API токены
Раздел «API токены» доступен владельцу и администратору.
- Нажмите «Создать токен».
- Укажите «Название токена» и «Роль»: «Наблюдатель» — доступ к API чата и поиска, «Редактор» — дополнительно создание, изменение и удаление товаров. Роль «Администратор» отмечена как недоступная.
- Скопируйте токен сразу: он показывается только один раз.
В списке токенов видны дата создания и «Последнее использование». Ненужные токены удаляются через «Режим выбора».
Биллинг
Раздел «Биллинг» доступен владельцу и администратору и называется «Биллинг и использование».
| Блок | Содержание |
|---|---|
| Лимиты использования | потребление токенов, команда, товары, профили, хранилище, скилы, коннекторы |
| Контракт организации | показывается, если проект подключён к контракту организации: «Места организации», «Вопросы организации в этом месяце», «Вклад этого проекта»; условия меняются через менеджера |
| Тарифы | карточки продуктов «Команда» и «Треды» из каталога тарифов и переключатель периода оплаты «Ежемесячно» / «Ежегодно» |
Команда — тариф за места: место занимает любой участник проекта, включая гостей. Треды — тариф за решённые вопросы: тред — завершённая ветка диалога с ответом ассистента. Карточка продукта показывает использование, стоимость, текущий план, цену за единицу, оплаченный объём и использование сверх пакета.
Порядок оплаты:
- Нажмите «Оплатить Команду» или «Оплатить Треды».
- Укажите количество мест или тредов в месяц — не меньше минимального — и проверьте сумму «К оплате».
- Ознакомьтесь с условиями публичной оферты по ссылке https://parsewise.ru/policy/offer и нажмите «Перейти к оплате».
Использование сверх оплаченного объёма оплачивается по факту в конце периода. Места, добавленные к годовому пулу тарифа «Команда», оплачиваются по месячной цене места за каждый месяц, оставшийся до конца годового срока. Подписку на тариф «Команда» можно отменить кнопкой «Отменить подписку».
Для оплаченного продукта задаётся предохранитель расходов по ссылке «Изменить»: «Лимит мест» — сверх него пригласить участника нельзя; «Лимит тредов в месяц» — при его достижении ассистент перестаёт открывать новые треды до конца месяца. Лимит не может быть ниже оплаченного объёма; пустое поле означает отсутствие лимита.
9. Виджет на сайте
Посетитель сайта открывает чат кнопкой виджета и пишет сообщение в поле «Напишите сообщение...». Ассистент отвечает текстом, карточками товаров и профилей, интерактивными карточками скилов и ссылками на документы базы знаний. Каждый ответ можно оценить.
В окне поиска и действий доступны недавние чаты, поиск по ним и действия «Новый чат», «Скачать историю» и «Помощь». Под полем ввода показывается ссылка на политику конфиденциальности https://parsewise.ru/policy/privacy.
Если в разделе «Виджет» выбран режим «Только авторизованные», посетитель без входа на сайте видит сообщение о том, что чат доступен только авторизованным пользователям.
Проверьте на своих данных
Загрузите свои документы и каталог — и задайте ассистенту те вопросы, которые задают вам. Это единственная проверка, которая что-то значит.
