Обзор интеграций

Все интеграции UnSpot настраиваются в разделе Администрирование → Интеграции. Раздел состоит из вкладок: Синхронизации (каталоги пользователей, календари, мессенджеры, конференции, оборудование), Способы входа / SSO, Входящие подписки, Исходящие подписки, Дисплеи переговорных и Настройки API. Доступ к разделу имеют роли Владелец, Администратор интеграций и Администратор пользователей. Эта статья — карта всех возможностей интеграции со ссылками на подробные инструкции.

Синхронизация пользователей

На вкладке «Синхронизации» доступно семь способов наполнять список сотрудников: SCIM 2.0, CSV, OpenID Connect, Entra ID (Azure AD), AD LDAP, OpenLDAP и Google Workspace. Инструкции:

• Синхронизация с Entra ID (Azure AD) по SCIM — провижининг со стороны IdP; работает также с Okta и любым SCIM-совместимым провайдером.
• Синхронизация с Entra ID (Azure AD) через Graph API — быстрый вариант: достаточно авторизовать аккаунт Microsoft.
• Синхронизация с Active Directory (AD LDAP / OpenLDAP) — прямое подключение к локальному каталогу по ldap:// или ldaps://.
• Сервис LDAP-SCIM — мост для закрытых контуров: локальный AD без прямого доступа к UnSpot SaaS.
• Синхронизация из внешней базы данных по ODBC (UnSpot ODBC SCIM Adapter) — Windows-приложение читает сотрудников из любой СУБД (SQL Server, PostgreSQL, Oracle и др.) через ODBC и передаёт их в UnSpot по SCIM; опционально — оргструктура и статусы расписания.
• Синхронизация с Google Workspace — единственный способ с переносом организационной структуры Google.
• Синхронизация пользователей из 1С (UnSpot SCIM Adapter) и синхронизация статусов сотрудников из 1С — для конфигураций 1С (ЗУП и других).
• CSV — ручное добавление: импорт списка сотрудников из CSV-файла или добавление по одному (карточка ведёт к списку сотрудников).
• OpenID Connect — автосоздание пользователей при первом входе через SSO: сотрудники из доверенных корпоративных доменов автоматически получают доступ и попадают в группу по умолчанию. Домены настраиваются на вкладке «Способы входа / SSO».

Способы входа (SSO)

Вкладка «Способы входа / SSO» управляет тем, как сотрудники попадают в UnSpot: вход по паролю (всем / только администраторам / никому), двухфакторная аутентификация (email или приложение-аутентификатор TOTP — подробнее), запрос доступа, а также преднастроенные провайдеры — Microsoft 365, Google Workspace, Apple ID, Яндекс 360, Bitrix24 и SAML 2.0. Для корпоративных IdP есть универсальное подключение OAuth 2.0 (AD FS, Keycloak, Okta, OneLogin и другие). Здесь же настраиваются доверенные домены OpenID Connect, синхронизация полей профиля по SSO и время действия авторизации (TTL токенов).

• Настройка SSO (OAuth 2.0) через AD FS
• Настройка SSO (OAuth 2.0) через Keycloak
• Установка UnSpot для Битрикс 24 — включает настройку Bitrix24 SSO.

Синхронизация календарей

Чтобы брони переговорных и события календаря совпадали, UnSpot подключается к ресурсным календарям: Microsoft Office 365 (App-подключения с управлением списком подключений), Microsoft Exchange, Google Calendars, а в российском контуре — календарь Битрикс24 по вебхуку.

• Права на ресурсный календарь в Office 365
• Права на ресурсный календарь в Exchange
• Подключение Microsoft Exchange через сервисный аккаунт — единое подключение для всех переговорных, без делегирования прав на каждый календарь
• Права на ресурсный календарь в Google
• Подключение календаря Exchange к переговорной
• Правила синхронизации календарей

API и вебхуки (подписки)

Для собственных сценариев автоматизации у UnSpot есть External API (токены выпускаются на вкладке «Настройки API»), SCIM API, исходящие подписки (вебхуки о событиях) и входящие подписки (приём событий от внешних систем):

• External API: история бронирований, данные о сотрудниках, мониторинг состояния системы, обновление статуса в расписании.
• Справочник SCIM API — управление пользователями, группами и оргструктурой по стандарту SCIM 2.0.
• Что такое подписки и как их использовать — обзор механизма.
• Исходящие подписки: пошаговая настройка и справочник событий и форматов — события бронирования парковки на URL (HTTPS) и системные email-уведомления.
• Входящие подписки: настройка приёма уведомлений от СКУД и справочник входящих вебхуков — универсальный формат JSON и Sigur.

Интеграции со СКУД

События проходов из систем контроля доступа попадают в UnSpot и используются в отчётах посещаемости и модуле «Посетители». Готовая интеграция есть для Sigur и RusGuard; любая другая СКУД (PERCo, Bolid, Parsec и прочие), умеющая отправлять HTTPS-запросы, подключается через универсальную входящую JSON-подписку. История проходов доступна в отчёте «История посещения офиса (СКУД)».

• Обзор интеграций с Sigur
• Синхронизация номеров пропуска из Sigur
• Уведомления от СКУД Sigur при приходе в офис
• Делегирование доступа из Sigur в UnSpot
• Настройка интеграции со СКУД RusGuard
• Универсальная JSON-подписка для любой СКУД

Уведомления и мессенджеры

Помимо почты и пуш-уведомлений мобильного приложения, UnSpot отправляет уведомления в мессенджеры. Сейчас доступны Slack (подключается администратором в блоке «Рассылка уведомлений», сотрудники включают канал у себя в настройках уведомлений) и Telegram (сотрудник привязывает бота в личных настройках уведомлений). Карточки MS Teams, Mattermost, Express и Rocket.Chat отмечены как «Скоро» — эти каналы пока недоступны.

• Настройка интеграции со Slack

Онлайн-конференции

Интеграция с Zoom (тип приложения Server-to-Server OAuth: Account ID, Client ID, Client Secret) позволяет привязывать Zoom-аккаунты к переговорным и подтягивать записи встреч. Карточки Webex и BlueJeans отмечены как «Скоро».

• Настройка интеграции с Zoom

Оборудование и офис

• Дисплеи переговорных — планшеты у переговорных с расписанием и действиями (забронировать, остановить, чек-ин, QR): подключение дисплея, PWA-приложение для планшетов, запуск на Qbic.
• Pocket Lock — электронные замки для ячеек локеров (host и токен в карточке «Управление замками Pocket Lock»): см. раздел про Pocket Lock в статье «Управление локерами».
• Trassir — камеры для парковки (host, порт, пароль в карточке «Камеры для парковки Trassir»): распознавание номеров для парковочных сценариев.
• Claris — передача событий парковки по access token (чекбокс «Отправлять в Claris» в исходящей подписке о бронировании парковки).

Приложения для сотрудников

• PWA-версия UnSpot — установка веб-приложения на телефон или компьютер без магазинов приложений.
• Приложение UnSpot для Битрикс 24 — работа с UnSpot внутри портала Битрикс24 + Bitrix24 SSO.
• Приложение UnSpot для Microsoft Teams — вкладка UnSpot внутри Teams; при первом открытии укажите домен компании (поддомен UnSpot). Инструкция доступна в англоязычном хелп-центре.