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