Интеграция с Yclients

Подключение интеграции с Yclients и настройка ролей

Этот гид объясняет, как подключить интеграцию с Yclients, открыть личный кабинет, выдать роли сотрудникам, пригласить их в систему и управлять доступом (активация/деактивация).

Кому доступен личный кабинет

• Company_admin и/или Ответственный за интеграцию в филиале.
• После подключения интеграции в маркетплейсе Yclients вы автоматически попадёте в личный кабинет. Регистрация не требуется — мы создадим кабинет и загрузим сотрудников выбранных филиалов.

Статусы подключения

• Идёт синхронизация: первичная загрузка из Yclients (или повторная). Действия временно недоступны.
• Ошибка подключения: требуется повторное подключение в Yclients или обращение в поддержку.
• Активно: интеграция настроена; можно управлять ролями и доступом.
• Отключено: интеграция отключена; редактирование заблокировано до повторного включения.

Пример сценария подключения (кратко):

1. Нажмите «Подключить» в маркетплейсе Yclients, выберите филиалы →
2. Вас перенаправит в наш сервис, кабинет создастся автоматически →
3. В разделе «Личный кабинет» назначьте роли «Мастер» и «Проверяющий» →
4. Пригласите сотрудников и/или создайте им ссылки для входа →
5. Готово.

Вот как выглядит страница личного кабинета:

Приглашение сотрудников в систему

Сотрудник без аккаунта отмечается статусом «Нет аккаунта» и кнопкой «Пригласить».

• Нажмите «Пригласить» — система создаст аккаунт и активирует доступ сотрудника.
• После приглашения вы сможете сгенерировать персональную ссылку для входа (установки пароля).

Рекомендации:

• Приглашайте только тех, кому собираетесь назначить какую-либо роль.
• Минимум один Проверяющий на филиал для контроля качества.

Работа со списком сотрудников и ролями

На странице компании отображается таблица сотрудников с ролями и действиями.

• Поиск: строка «Поиск сотрудника» фильтрует по ФИО/специализации.
• Пагинация: кнопки «Назад»/«Вперёд», на странице до 10 записей.
• Роли:
  • Мастер — создаёт фото работ через приложение.
  • Проверяющий — проверяет и принимает работы.
  • Салон админ — администрирование в рамках салона.

Кто и как может выдавать роли

• Выдавать роли могут администраторы кабинета филиала (например, Салон админ).
• Если у сотрудника включена роль Салон админ, его строка может быть заблокирована для редактирования в интерфейсе текущим салон‑админом (видна подсказка при наведении).
• Роли назначаются переключателями (чекбоксами) в соответствующих колонках. Изменения копятся локально.
• Нажмите «Сохранить изменения», чтобы отправить обновления и закрепить роли.

Примечания:

• У сотрудников без аккаунта (не приглашенных) или деактивированных (см. ниже) переключение ролей недоступно до приглашения или активации.
• При статусе интеграции «Отключено» все элементы редактирования (поиск, роли, сохранение) заблокированы.

Ссылки для входа (установка пароля)

Для сотрудника с активным аккаунтом доступна кнопка «Создать ссылку».

• Нажмите «Создать ссылку» — откроется модальное окно со ссылкой вида https://snipstory.ru/set-password/<token>.
• Нажмите «Скопировать» и передайте ссылку сотруднику удобным способом (мессенджер, почта).

Примечания:

• Ссылка ведёт на защищённую страницу установки пароля в нашем приложении.
• Если аккаунт деактивирован, кнопку «Создать ссылку» использовать нельзя до повторной активации.

Активация и деактивация доступа

В колонке «Действия» доступны кнопки «Активировать» и «Деактивировать» (для сотрудников с аккаунтом).

• Деактивировать — временно блокирует доступ сотрудника к приложению.
• Активировать — восстанавливает доступ.

Примечания:

• У деактивированного пользователя недоступна генерация ссылки для входа и большинство действий.
• Для прозрачности статус отображается бейджем: «Активен» / «Деактивирован».

Состояния интеграции и что они означают

Идёт синхронизация

Во время первичной/повторной синхронизации управление недоступно. Страница обновится автоматически после завершения.

Ошибка подключения

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

Отключено

Редактирование ролей, приглашений и доступа блокируется до включения интеграции.

Хорошие практики распределения ролей

• Мастера: все сотрудники, выполняющие работы и создающие фото‑отчёты.
• Проверяющие: администраторы и/или опытные сотрудники, ответственные за контроль качества.
• Салон‑админ: 1–2 ответственных за управление ролями и доступами для сотрудников на сайте в рамках одного салона. Не раздавайте эту роль широкому кругу сотрудников.
• Минимальный состав: ≥1 Проверяющий на филиал; у каждого мастера должен быть активный аккаунт.

Частые вопросы

• Нужно ли регистрировать сотрудников вручную? Нет. Достаточно пригласить и сгенерировать ссылку для установки пароля.
• Почему не могу изменить роли у „Салон‑админ“? У пользователей с ролью Салон-админ есть права на выдачу ролей мастер и проверяющий. Такие пользователи не могут редактировать роли для существующих Салон-админов.
• Почему неактивны элементы управления? Возможные причины: идёт синхронизация; интеграция отключена; у сотрудника нет аккаунта или он деактивирован.