Подключение календаря Битрикс24 к переговорной
Портал Битрикс24, подключённый в интеграциях, сам по себе ничего не синхронизирует: события начинают ходить только после того, как переговорная связана с конкретным календарём-локацией портала. Связь настраивается отдельно для каждой комнаты — по одному календарю на переговорную.
До начала
- Портал Битрикс24 подключён в разделе Настройка → Интеграции → Синхронизации (порядок — в статье «Настройка синхронизации календарей с Битрикс24»).
- В портале есть календарь-локация для этой переговорной. Обычные и личные календари в списке для связи не появятся.
- Права на управление пространствами (роль «Администратор офисов») — чтобы подключить и отключить календарь. Кнопка ручного запуска синхронизации доступна только роли «Владелец».
Как подключить календарь
Откройте Настройка → Управление офисом → Рабочие пространства и найдите переговорную в дереве пространств. Наведите курсор на её строку — справа появятся действия. Нажмите «Подключить календарь».
В окне «Настройка календаря переговорной» выберите плитку Bitrix24.
На втором шаге UnSpot покажет календари-локации, которые нашёл в портале. Отметьте нужный и нажмите «Подключить».
Повторите для каждой переговорной, которая должна синхронизироваться. Один календарь портала связывается с одной переговорной.
Плитки Bitrix24 нет в окне выбора
Так выглядит то же окно, когда портал Битрикс24 в интеграциях ещё не подключён: доступны только Google Workspace, Cloud Microsoft и On-premise Microsoft.
Что проверить, если плитки нет:
- подключён ли портал в блоке «Синхронизация календарей» — в карточке Bitrix24 должен стоять домен портала, а не кнопка «Подключить»;
- российский ли это контур UnSpot — вне него карточки Bitrix24 нет ни в интеграциях, ни здесь;
- не подключён ли у переговорной другой календарь: в этом случае окно показывает его, а не плитки поставщиков.
Что происходит сразу после подключения
UnSpot запускает первую сверку: забирает события календаря за период от вчерашнего дня до 182 дней вперёд и создаёт по ним бронирования. Дальше обмен идёт постоянно — по вебхуку и регулярной сверкой. Ручной запуск синхронизации в первый час после подключения недоступен: этот час уже израсходован первой сверкой.
Хорошая проверка сразу после подключения — забронировать переговорную в UnSpot и найти встречу в календаре портала, а затем создать событие в портале и найти бронь в UnSpot.
О чём предупредить сотрудников. После привязки календарь портала становится главным: если время занято встречей из Битрикс24, бронь в UnSpot отменится сразу после создания, а событие, созданное в портале, вытеснит конфликтующую бронь. Подробно — в статье «Синхронизация календарей с Битрикс24: как устроена», раздел «Кто главный при конфликте».
Переподключение и отвязка
| Действие | Что делает |
|---|---|
| «Запустить синхронизацию» | Принудительно сверяет календарь этой переговорной с порталом. Доступно не чаще одного раза в час: пока час не истёк, кнопка заблокирована, а рядом указано время, когда она снова станет активна. Отсчёт начинается и от момента подключения календаря, поэтому в первый час после привязки кнопка недоступна. Запускать может только «Владелец» |
| «Переподключить» | Появляется вместо «Запустить синхронизацию», если подключение к порталу перестало действовать — например, вебхук отозвали. Для подключения по вебхуку кнопка ничего не делает: восстанавливать надо сам вебхук в Битрикс24 и, если он создан заново, пересоздать подключение в интеграциях |
| «Отключить» | Снимает связь только для этой комнаты; остальные переговорные продолжают синхронизироваться. Бронирования, созданные из событий портала, у этой комнаты остаются |
| Отключить Bitrix24 в интеграциях | Снимает связи у всех переговорных сразу. События в портале при этом остаются |
Ошибки и ограничения
| Что видно | Причина и что делать |
|---|---|
| К переговорной уже подключен календарь «…». Пожалуйста, сначала отключите его. | У комнаты есть действующая связь с календарём — любого поставщика. Отключите её и подключите заново |
| Список календарей на втором шаге пуст, UnSpot пишет «Все ваши календари уже используются» | Все календари-локации портала уже связаны с другими переговорными: занятые в списке не показываются. Освободите нужный календарь в другой комнате или создайте новую локацию в портале |
| Список пуст без такого сообщения | В портале нет календарей-локаций. Если же не хватает прав вебхука, вместо пустого списка появится ошибка портала |
| Нужного календаря нет в списке | В список попадают только календари-локации, не связанные с другими переговорными. Обычный, личный или групповой календарь портала для переговорной не подойдёт |
| Встречи приходят, а участники в портале не видны | Участник попадает в событие, только если его почта совпадает с почтой пользователя Битрикс24. Несовпадение UnSpot не сообщает |
