REST: календарь и события

Календарь Битрикс24 доступен через REST-группу calendar.*: можно создавать и изменять события, управлять участниками встреч, повторами по RRULE, секциями календарей и напоминаниями. Ниже — практический разбор методов, полей и типичных ошибок при интеграции внешних систем с календарём портала.

Что умеет группа calendar.*

REST-календарь Битрикс24 покрывает три сущности: события, секции (отдельные календари внутри владельца) и статусы участников встреч. Все методы работают в контексте владельца — пользователя или рабочей группы, — который задаётся парой параметров type и ownerId.

• calendar.event.get — список событий за период;
• calendar.event.add / calendar.event.update — создание и правка;
• calendar.event.delete — удаление;
• calendar.event.get.nearest — ближайшие события пользователя;
• calendar.section.get / add / update / delete — секции календарей;
• calendar.meeting.status.get / set — приглашение и ответ участника;
• calendar.accessibility.get — занятость пользователей на интервале;
• calendar.resource.list и calendar.resource.booking.list — бронирование ресурсов (переговорок).

Чтение событий: calendar.event.get

Метод возвращает события конкретного владельца за интервал. Обязательны type (user или group), ownerId, а также границы периода from и to в формате YYYY-MM-DD.

Пример запроса на вебхуке:

POST https://portal.bitrix24.ru/rest/1/xxxx/calendar.event.get.json

{ "type": "user", "ownerId": 1, "from": "2026-07-01", "to": "2026-07-31", "section": [12, 15] }

Параметр section ограничивает выборку конкретными секциями. Каждое событие содержит поля ID, NAME, DATE_FROM, DATE_TO, RRULE, ATTENDEE_LIST и служебный PARENT_ID — для повторяющихся серий он указывает на родительское событие.

Создание события: calendar.event.add

Минимальный набор полей — владелец, интервал и название. Разберём основные параметры в таблице.

Пример создания встречи с напоминанием и участниками:

{ "type": "user", "ownerId": 1, "section": 12, "name": "Демо для клиента", "from": "2026-07-20 15:00:00", "to": "2026-07-20 16:00:00", "is_meeting": "Y", "attendees": [1, 4, 9], "host": 1, "remind": [{"type": "min", "count": 30}] }

Метод возвращает ID созданного события. Если секция не указана, событие попадёт в календарь владельца по умолчанию.

Повторяющиеся события и RRULE

Регулярные встречи задаются объектом rrule по стандарту iCalendar. Основные ключи:

• FREQ — периодичность: DAILY, WEEKLY, MONTHLY, YEARLY;
• INTERVAL — шаг (каждые N периодов);
• BYDAY — дни недели для еженедельных серий (MO, TU, WE…);
• COUNT или UNTIL — ограничение серии по числу или дате.

Планёрка каждый понедельник:

"rrule": { "FREQ": "WEEKLY", "INTERVAL": 1, "BYDAY": ["MO"], "UNTIL": "2026-12-31" }

Участники, статусы и занятость

Для событий-встреч (is_meeting = Y) каждый приглашённый получает уведомление и может подтвердить участие. Управление статусом:

• calendar.meeting.status.get — узнать статус участника по событию;
• calendar.meeting.status.set — установить статус: Q (под вопросом), Y (принял), N (отклонил).

Проверить, свободны ли сотрудники на интервале, до отправки приглашения помогает calendar.accessibility.get:

{ "users": [1, 4, 9], "from": "2026-07-20", "to": "2026-07-20" }

Метод вернёт занятые интервалы по каждому пользователю — удобно для автоподбора свободного слота при интеграции с внешней системой бронирования.

Секции календарей

Секция — это отдельный календарь внутри владельца (например, «Отпуска», «Переговоры», «Личное»). Методы calendar.section.* позволяют создавать их программно и раскладывать события по цветам и правам доступа.

1. calendar.section.get — список секций владельца;
2. calendar.section.add — создать (поля type, ownerId, name, color);
3. calendar.section.update — переименовать, сменить цвет;
4. calendar.section.delete — удалить (события внутри тоже удаляются).

Итог

Группа calendar.* закрывает полный цикл работы с расписанием: чтение и запись событий, повторы по RRULE, приглашения и статусы участников, проверку занятости и управление секциями. Ключевые риски интеграции — часовые пояса, каскадное удаление секций и режимы правки серий (recursion_mode). Заложите их в архитектуру синхронизации с самого начала.

Если нужно связать календарь Битрикс24 с внешней CRM, системой бронирования или мобильным приложением, мы проектируем такие обмены под ключ: от согласования модели данных до устойчивой обработки очередей и ошибок. Поможем и с разовой интеграцией, и с высоконагруженным сценарием, где события создаются пакетами.