База знаний UtiClock

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

Архитектурная реализация REST API у компании Битрикс предполагает установку отдельного приложения (модуля) на корпоративный портал, а также пользователя, из-под которого будут выполняться API запросы.

1. Установка модуля

Модуль, разработанный под Битрикс24, называется «Навигатор.Момент». Этот модуль служит только для получения событий пользователей из корпоративного календаря и отображения её на планшете. Модуль не передаёт информацию третьим лицам.

Запросите ссылку на установку модуля написав нам на почту

2. Создание пользователя

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

Все запросы должны выполняться от имени какого-то пользователя. В теории, можно использовать и текущего, но мы рекомендуем создать отдельного системного «бота». У «бота» должны быть права на календарь переговорной комнаты и на все календари сотрудников. Так он сможет оценить занятость при создании новых событий. Все запросы выполняются от учётной записи бота. Битрикс24 проверяет доступ бота к календарю. Если у бота нет прав на календарь, значит при HTTP запросе Битрикс24 вернёт ошибку: Access denied.

3. Настройка прав

Предоставьте для пользователя полные права во всех вкладках в модуле календаря

Настройки доступа к модулю календаря в Битрикс24

4. Настройка прав

Создайте тестовое событие в календаре через интерфейс Битрикс24, чтобы проинициализировать календарь в базе данных.

5. Получить ID календаря

ID календаря можно получить в браузере в режиме просмотра кода (F12)

Скриншот как получить ID календаря в Битрикс24

Схема работы с Битрикс24 в общих чертах:

На корпоративном портал клиента создаётся отдельный пользователь с соответствующими правами.
На планшете сохряняются логин и пароль пользователя, из-под которого будут выполняться API запросы. Запросы в Битрикс24 должны идти от какого-то пользователя, поскольку так у них реализован REST.
При сохранении настроек выполняется один запрос с передачей логина и пароля в Битрикс24, после чего планшет получает access токен и refresh токен. С помощью токена происходит дальнейший обмен запросами.
Планшет делает HTTP запрос на получение событий календаря переговорной комнаты
Битрикс24 возвращает информацию в формате JSON.
Планшет обрабатывает эти данные, и на их основе выводит текущий статус, а также ближайшие события.

Никакие данные сотрудников и событий не передаются третьим лицам или на сторонние ресурсы.

Подробнее про работу REST API c Битрикс24 можно прочитать здесь: https://dev.1c-bitrix.ru/rest_help/rest_sum/index.php

Читайте так же:

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