Установка приложения UnSpot в Битрикс24
Приложение UnSpot в портале Битрикс24 позволяет открывать UnSpot прямо в интерфейсе портала: сотрудник переходит на вкладку приложения и оказывается в системе, не вводя пароль. Устанавливается один раз, привязка портала к рабочему пространству UnSpot тоже делается однократно.
Что понадобится
- Права администратора в портале Битрикс24 — установка приложения из магазина.
- Адрес вашего рабочего пространства UnSpot — его поддомен понадобится при первом открытии приложения.
- Облачный Битрикс24: у Битрикса на своём сервере магазина приложений нет.
Установка и привязка
- Установите приложение UnSpot из магазина приложений Битрикс24 и подтвердите своё согласие.
- Откройте приложение и укажите название вашего рабочего пространства UnSpot — тот же поддомен, по которому вы входите в UnSpot из браузера.
После первого входа UnSpot запомнит связь с вашим порталом Битрикс24 и больше не будет её запрашивать.
Видео записано в предыдущей версии интерфейса — расположение элементов могло измениться, порядок действий прежний.
Одно рабочее пространство UnSpot связывается с одним порталом Битрикс24: привязать второй портал к тому же пространству нельзя. Обратное ограничение технически не проверяется — тот же портал можно привязать и к другому пространству UnSpot, но так делать не нужно: два пространства начнут спорить за одни данные.
Разрешение на передачу данных пользователя
Чтобы сотрудники заводились в UnSpot автоматически при первом открытии приложения, в магазине приложений Битрикс нужно разрешить передачу данных пользователя в UnSpot.
Из профиля UnSpot сохраняет только адрес электронной почты, имя и фамилию — остальные поля ответа портала отбрасываются. Без заполненной почты сотрудник войти не сможет: связывать учётные записи будет не по чему. Если имя и фамилия в портале не заполнены, в оба поля попадёт адрес почты целиком, поэтому лучше заполнить их заранее.
Что видит сотрудник дальше
Сотрудник открывает вкладку UnSpot в портале и попадает в систему. Заведётся ли учётная запись, если её ещё нет, зависит от настроек на странице Настройка → Интеграции → Способы входа / SSO:
- домен почты есть в списке корпоративных доменов — учётная запись создаётся автоматически;
- домена нет, но включён запрос доступа — создаётся заявка;
- домена нет и запрос доступа выключен — вход отклоняется.
Приложение в портале и кнопка Битрикс24 на странице входа — независимые механики. Приложение не требует настройки входа через Битрикс24, а настройка входа не требует приложения; их можно включить по отдельности или обе.
Ограничения и ошибки
| Что видно | Причина и что делать |
|---|---|
| Компания уже подключена. | К этому рабочему пространству UnSpot уже привязан другой портал Битрикс24. Одно пространство — один портал |
| Домен компании должен состоять не менее чем из 2 двух символов | Поддомен рабочего пространства введён слишком коротким или пустым |
| Компания не найдена. | Самая частая ошибка этого шага: в поддомене опечатка, либо рабочее пространство заблокировано или удалено. Проверьте адрес, по которому вы входите в UnSpot |
| Что-то пошло не так, попробуйте перезагрузить или выполнить интеграцию позднее | Страница привязки не получила от UnSpot внятного ответа — сетевой сбой или ошибка сервера. Повторите попытку; если повторяется — обратитесь в поддержку |
| Попытка запуска приложения вне среды Битрикс24. | Адрес обработчика приложения открыт напрямую в браузере. Открывайте UnSpot из портала |
| Вместо UnSpot открылась обычная страница входа | Так заканчивается неудача автоматического входа из портала: у сотрудника не заполнена почта, портал не ответил или доступ не разрешён. Текста ошибки UnSpot при этом не показывает — причину администратор смотрит в Настройка → Интеграции → Способы входа / SSO → История входов |
