Проверить занятость участников в календаре

Робот «Проверить занятость участников в календаре». Показывает пересечения выбранного интервала со временем занятости участников.

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

Для кого и какую проблему решает

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

Что подготовить

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
ID участников (JSON-массив)	Текст	Обязательное; значение по умолчанию не задано
Начало проверки с часовым поясом	Дата и время	Обязательное; значение по умолчанию не задано
Конец проверки с часовым поясом	Дата и время	Обязательное; значение по умолчанию не задано

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Передайте от 1 до 20 уникальных ID участников массивом.
2. Укажите начало и конец проверяемого интервала с часовым поясом, не больше 31 суток.
3. После чтения проверьте статус шага и количество подтверждённых участников.
4. Используйте признак занятости и список занятых ID для выбора другой даты.
5. Интервалы результата даны в UTC; переводите их в нужный пояс при показе пользователям.

Учебный пример и ожидаемый результат

Для участников [21,22] проверяется 10:00–11:00 +03:00. У 22 занятость 10:30–11:30. Ожидается положительный признак занятости и ID 22; событие, начинающееся ровно в 11:00, не пересекает полуоткрытый проверяемый слот. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• Есть занятость: да/нет (Y/N).
• Занятые участники: целое число, список.
• Интервалы занятости (JSON): текст.
• Проверено участников: целое число.

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

Занятость, отсутствие и предварительное участие блокируют время, свободные события: нет. До 1000 событий участника и 5000 суммарно. Неполный ответ является ошибкой. События на весь день без точных подтверждённых границ не поддерживаются. Проверка не резервирует слот и не гарантирует фактическую готовность сотрудника.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

ID участников (JSON-массив)

[
  21,
  22
]

Значения массива обозначают ID сотрудников вашего портала. Берите их из результата поиска сотрудников или выбранного сотрудника, не из ID сделки. В массиве нужны положительные целые числа без объектов и фамилий. Нужно от 1 до 20 уникальных ID. Пустой массив не подходит; занятость каждого участника должна быть подтверждена.