Обзор интеграций
UnSpot связывается с системами компании в нескольких точках: откуда приходят сотрудники, как они входят, где живут календари переговорных, что происходит на проходной и на парковке, куда уходят уведомления. Большая часть подключений собрана в разделе Настройка → Интеграции, остальное настраивается на своих экранах — календарь у карточки переговорной, дисплеи и локеры у пространств. Эта статья не учит настраивать: она показывает, что с чем можно связать, и ведёт в нужную инструкцию.
Что понадобится
- Роль в UnSpot. Раздел «Настройка → Интеграции» открыт Владельцу, Администратору интеграций и Администратору пользователей — последнему в объёме синхронизации сотрудников. Календарь к переговорной привязывает Владелец или Администратор офисов, а общее подключение к Microsoft или Exchange создаёт только Владелец.
- Доступ на стороне внешней системы. Почти каждое подключение требует прав в чужой системе: администратора тенанта Microsoft, суперадминистратора Google Workspace, учётной записи с правами в СКУД, портала Битрикс24. Это чаще всего и есть узкое место — договаривайтесь о доступе до начала настройки.
- Понимание контура. Часть интеграций работает только в российском контуре, и в интерфейсе их просто не видно, если контур другой. Список — в разделе «Что доступно только в российском контуре».
Что с чем можно связать
Таблица отвечает на вопрос «что я хочу получить», а не «какая вкладка за это отвечает». Колонка «С чего начать» ведёт в обзорную статью направления — там развилка между вариантами и порядок шагов.
| Задача | Что подключают | Где настраивается | С чего начать |
|---|---|---|---|
| Завести сотрудников без ручного ввода | SCIM 2.0, Entra ID, AD LDAP или OpenLDAP, ODBC, Google Workspace, 1С, CSV | Синхронизации | Как выбрать способ синхронизации пользователей |
| Пустить сотрудников по корпоративной учётной записи | Яндекс, VK ID, Битрикс24, AD FS, Keycloak, OAuth 2.0, SAML 2.0; в международном контуре — Microsoft 365, Google Workspace, Apple ID | Синхронизации → Авторизация пользователей, Способы входа / SSO | AD FS, Keycloak, вход через Битрикс24 |
| Показывать брони в календаре переговорной | Microsoft 365, Microsoft Exchange, Google Calendars, Битрикс24 | Синхронизации → Синхронизация календарей, затем карточка переговорной | Календарь переговорной: обзор способов подключения |
| Понять, как вообще идёт обмен с календарём | — | — | Как устроена синхронизация календарей |
| Забирать проходы из СКУД | Sigur, RusGuard, любая СКУД по JSON | Входящие подписки | Обзор интеграций со СКУД Sigur, RusGuard, универсальная подписка |
| Отправлять уведомления в мессенджер | Slack, Telegram | Синхронизации → Рассылка уведомлений | Настройка интеграции со Slack |
| Привязывать встречи к сервису видеоконференций | Zoom | Синхронизации → Онлайн конференции | Настройка интеграции с Zoom |
| Повесить дисплей у переговорной | UnSpot Display на планшете или Qbic | Дисплеи переговорных | Дисплеи переговорных: подключение и настройка |
| Открывать ячейки локеров | Pocket Lock | Синхронизации → Оборудование | Настройка интеграции с локерами: Pocket Lock |
| Автоматизировать парковку | Камеры для парковки Trassir, заявки в Claris | Синхронизации → Оборудование | Интеграция с Claris: как устроена |
| Собрать свой сценарий | External API, SCIM API, исходящие и входящие подписки | Настройки API, Входящие и Исходящие подписки | Что такое подписки, Справочник SCIM API |
| Работать с UnSpot внутри портала | Приложение для Битрикс24 | Портал Битрикс24 | Интеграция с Битрикс24: обзор |
Порядок внедрения
Порядок не обязательный, но нарушать его дорого: подключения ниже опираются на результат предыдущих.
- Сотрудники. Сначала источник пользователей — иначе последующие настройки не на кого применять. Развилка между семью способами разобрана в статье «Как выбрать способ синхронизации пользователей».
- Вход. Способ входа настраивается отдельно от синхронизации: то, что сотрудник приехал из каталога, само по себе не даёт ему входа по корпоративной учётной записи.
- Переговорные и их календари. Календарь привязывается к уже заведённой переговорной. Какой из способов подходит — в статье «Календарь переговорной: обзор способов подключения».
- Офисная обвязка. СКУД, парковка, локеры, дисплеи — в любом порядке, они друг от друга не зависят.
- Свои сценарии. API и подписки подключают последними, когда состав данных в UnSpot уже установился: подписки шлют события, а External API отдаёт данные по запросу.
Пользователи и вход
Сотрудники попадают в UnSpot одним из семи способов — от файла CSV до синхронизации с каталогом компании. Способ выбирают один раз: смена источника означает перенос учётных записей, поэтому развилку стоит пройти до настройки.
- Как выбрать способ синхронизации пользователей — таблица-развилка по всем способам и их ограничениям.
- Импорт из CSV, SCIM 2.0 (Entra ID, Okta), Entra ID через Graph API, AD LDAP и OpenLDAP, внешняя база по ODBC, Google Workspace, 1С — как устроен каждый способ; в конце каждой статьи ссылка на её настройку.
- Сервис LDAP-SCIM — мост для закрытого контура, когда прямого доступа к локальному каталогу у UnSpot нет.
- Синхронизация статусов сотрудников из 1С — отпуска и больничные в расписании.
- Вход: AD FS, Keycloak, Битрикс24, OpenID Connect, двухфакторная аутентификация. Провайдеры входа перечислены в блоке «Авторизация пользователей»: Яндекс, VK ID, Битрикс24, AD FS, Keycloak, OAuth 2.0 — Microsoft 365, Google Workspace и Apple ID доступны в международном контуре.
Календари переговорных
Календарь подключается к каждой переговорной и работает в обе стороны: встречи из календаря становятся бронями, брони из UnSpot появляются в календаре. Провайдеров четыре, а у Microsoft внутри ещё четыре варианта подключения — они различаются транспортом и тем, где лежат учётные данные.
- Календарь переговорной: обзор способов подключения — вход в тему: какой способ выбрать и в каком порядке действовать.
- Синхронизация календарей с Microsoft: какой вариант выбрать — развилка между четырьмя вариантами Microsoft 365 и Exchange.
- Подключение календаря Google к переговорной и создание ресурсного календаря в Google Workspace.
- Синхронизация календарей с Битрикс24: как устроена — для компаний, живущих в портале Битрикс24.
- Как устроена синхронизация календарей — что переносится между бронью и событием, что не переносится, как разбираются конфликты и что происходит в каждом сценарии.
СКУД, парковка и оборудование офиса
Эта группа подключений описывает офис как физическое пространство: кто прошёл через турникет, что происходит на парковке, чем открываются локеры и что показывает планшет у переговорной.
- СКУД. Sigur — готовая интеграция с номерами пропусков, уведомлениями о приходе, делегированием доступа и телефоном вместо пропуска. RusGuard — вторая готовая интеграция. Любая другая система подключается универсальной JSON-подпиской.
- Парковка. Камеры Trassir распознают номера на въезде; заявки на парковочные места уезжают в Claris — как устроена интеграция и как её настроить.
- Локеры. Pocket Lock открывает ячейки по брони; протокол обмена с системой замков — в справочнике.
- Дисплеи переговорных. Подключение и настройка, PWA-приложение для планшетов, запуск на Qbic.
Уведомления и онлайн-конференции
Помимо почты и пуш-уведомлений мобильного приложения UnSpot умеет писать в мессенджеры, а переговорные — получать ссылку на видеовстречу.
- Slack. Подключает администратор в блоке «Рассылка уведомлений» — инструкция.
- Telegram. Бота привязывает сам сотрудник в личных настройках уведомлений; администратор не может сделать это за него. Плитка видна не во всех контурах.
- Zoom. Подключается приложением типа Server-to-Server OAuth — инструкция.
- Microsoft Teams, Mattermost, Express, Rocket.Chat, Webex, BlueJeans. Плитки в консоли есть, но отмечены значком «Скоро»: кнопка подключения у них не работает.
Свои сценарии: API и подписки
Если готовой интеграции нет, сценарий собирается самостоятельно: подписки шлют события наружу и принимают события снаружи, External API отдаёт данные по запросу.
- Что такое подписки и как их использовать — механизм целиком.
- Исходящие: пошаговая настройка и справочник событий и форматов.
- Входящие: справочник входящих вебхуков и приём уведомлений от СКУД.
- External API: история бронирований, данные о сотрудниках, мониторинг состояния системы, обновление статуса в расписании.
- Справочник SCIM API — управление пользователями, группами и оргструктурой по стандарту SCIM 2.0.
Что доступно только в российском контуре
Часть интеграций включается только в российском контуре UnSpot. Если контур другой, плитки в консоли не появятся — это не ошибка настройки.
| Интеграция | Где доступна |
|---|---|
| Битрикс24 — приложение, вход, календари | Только российский контур |
| Claris — заявки на парковку | Только российский контур |
| Sigur, RusGuard | Только российский контур |
| Telegram | Российский контур, включается на стороне сервиса |
| Express, Rocket.Chat | Российский контур, плитки со значком «Скоро» |
| Microsoft, Google, Slack, Zoom, SCIM, API и подписки | Оба контура |
Где это находится в консоли
Большинство подключений живёт в разделе Настройка → Интеграции. Раздел состоит из шести вкладок.
| Вкладка | Что настраивается |
|---|---|
| Синхронизации | Источники пользователей, мессенджеры, онлайн-конференции, устройства и парковка |
| Способы входа / SSO | Провайдеры входа, OAuth 2.0, SAML, двухфакторная аутентификация |
| Входящие подписки | Приём событий от внешних систем, в том числе от СКУД |
| Исходящие подписки | Отправка событий UnSpot во внешние системы |
| Дисплеи переговорных | Регистрация и настройка планшетов у переговорных |
| Настройки API | Ключи и параметры доступа к External API |
Самая насыщенная вкладка — «Синхронизации». Она разбита на шесть блоков.
- Синхронизация пользователей — SCIM 2.0, CSV, OpenID Connect, Entra ID (Azure AD), AD LDAP, OpenLDAP, Google Workspace.
- Авторизация пользователей — провайдеры входа компании.
- Синхронизация календарей — общие подключения к Microsoft 365, Microsoft Exchange, Битрикс24 и Google Calendars.
- Рассылка уведомлений — мессенджеры.
- Онлайн конференции — Zoom и анонсированные сервисы.
- Оборудование — камеры для парковки Trassir, замки Pocket Lock, дисплеи переговорных и Claris.
За пределами раздела остаются две вещи: календарь переговорной подключается в её карточке в дереве пространств, а локеры — на экране пространства.
Ограничения и частые заблуждения
- Синхронизация пользователей и вход — разные вещи. Сотрудник, приехавший из каталога, не получает автоматически вход по корпоративной учётной записи: способ входа настраивается на своей вкладке.
- События из СКУД не создают и не отменяют брони. Проходы попадают в отчёты посещаемости и в модуль «Посетители», но бронированием не управляют.
- Подписки не заменяют синхронизацию. Исходящие подписки сообщают о событии постфактум; наполнять внешнюю систему данными они не предназначены — для этого есть External API и SCIM.
- У Microsoft два разных способа хранить доступ. Учётные данные на каждой переговорной и одно «Подключение» на всю компанию — это не одно и то же и не заменяют друг друга; разница разобрана в обзоре Microsoft.
- Плитка со значком «Скоро» — анонс, а не настройка. Кнопка подключения у таких плиток отключена.
- Состав плиток зависит от контура и настроек компании. Отсутствие плитки не означает, что интеграция сломана.
Если что-то пошло не так
| Симптом | Куда идти |
|---|---|
| Бронь есть в UnSpot, в календаре её нет | Бронирование не отображается в календаре |
| Сотрудники не появились после настройки синхронизации | Как выбрать способ синхронизации пользователей |
| Вход по корпоративной учётной записи не проходит | SSO через AD FS или вход через Битрикс24 |
| Проходы из СКУД не видны в отчётах | Обзор интеграций со СКУД Sigur, приём уведомлений от СКУД |
| Исходящий вебхук не приходит | Пошаговая настройка исходящих подписок |
| Заявка на парковку не уехала в Claris | Интеграция с Claris: как устроена |
