Настройка интеграции с Битрикс24

Шаг 1. Создание системного пользователя

Все запросы от планшета UtiClock к Битрикс24 выполняются от имени пользователя. Поэтому нужно создать отдельного пользователя-«бота» с нужными правами.

Хотя можно использовать существующего пользователя, мы рекомендуем создать нового. Это безопаснее и удобнее.

Инструкция от Битрикс24: Как пригласить сотрудников.

Шаг 1.1. Настройка прав доступа

У пользователя-«бота» должны быть права:

• Чтение и запись событий в календаре переговорной комнаты.
• Чтение имён и email сотрудников.
• Чтение и запись событий в календарях сотрудников.

Эти права нужны, чтобы планшет мог проверять занятость переговорной и сотрудников.

Если вы хотите настроить права точнее, воспользуйтесь официальной документацией: Права доступа к календарю.

Шаг 1.2. Войдите под учётной записью «бота»

Войдите в Битрикс24 в браузере под учётной записью созданного пользователя. Все дальнейшие шаги в инструкции выполняйте от его имени.

Шаг 2. Создание переговорной комнаты

Создайте переговорную комнату, если её ещё нет.

Инструкция от Битрикс24: Переговорные комнаты: как создать и забронировать.

Шаг 2.1. Создайте пробное событие

Перейдите в календарь переговорных и создайте любое событие (например, на завтра в 11:00). Это активирует календарь для API.

Шаг 2.2. Получите ID переговорной комнаты

ID комнаты понадобится для настройки планшета. Чтобы его найти:

1. Откройте список переговорных комнат в Битрикс24.
2. Наведите курсор на нужную комнату и нажмите правую кнопку мыши.
3. В меню выберите «Исследовать элемент» (или аналогичный пункт).
4. В коде найдите атрибут data-bx-calendar-section. Его значение — это ID комнаты.
   Пример: <li class="calendar-list-slider-item" data-bx-calendar-section="22">

Сохраните этот ID — он понадобится позже.

Шаг 3. Создание входящего вебхука

Вебхук — это ключ для доступа планшета к API Битрикс24.

1. Перейдите в раздел «Разработчикам».
   
2. Выберите «Другое» → «Входящий вебхук».
   
3. Заполните форму:
   • Укажите название вебхука (например, «Для планшета UtiClock»).
   • Скопируйте «Вебхук для вызова REST API» — он понадобится для настройки планшета.
   • В «Настройке прав» выберите: «Календарь» и «Пользователи».
   
4. Нажмите «Сохранить».

Шаг 4. Настройка Битрикс24 на планшете UtiClock

1. На планшете откройте настройки UtiClock.
2. Перейдите в раздел «Интеграции» и выберите «Битрикс24».
   *Как открыть настройки UtiClock
   
3. Заполните поля:
   • Вебхук: вставьте скопированную ссылку.
   • ID переговорной: введите ID, полученный на шаге 2.2.
   
4. Нажмите «Сохранить».

Если настройки верны, события из календаря Битрикс24 появятся на планшете.

Как это работает

• Планшет периодически отправляет запрос через API Битрикс24.
• Битрикс24 возвращает данные о событиях в календаре переговорной.
• Планшет показывает текущий статус комнаты и ближайшие события.

Конфиденциальность: данные о событиях и сотрудниках не передаются третьим лицам и обрабатываются только для отображения на планшете.

Подробнее об API Битрикс24: https://dev.1c-bitrix.ru/rest_help/rest_sum/index.php

Полезные ссылки

• Как бронировать переговорную через Битрикс24