CRM роботы 2.0 + AI (300+ роботов)

Создать свою встречу по ключу операции

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

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

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

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

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

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

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

Поле в настройке	Тип	Обязательность и исходное значение
Ожидаемый пользователь интеграции	Целое число	Обязательное; значение по умолчанию не задано
Личный календарь	Целое число	Обязательное; значение по умолчанию не задано
Название встречи	Строка	Обязательное; значение по умолчанию не задано
Начало с часовым поясом	Дата и время	Обязательное; значение по умолчанию не задано
Конец с часовым поясом	Дата и время	Обязательное; значение по умолчанию не задано
ID участников с организатором (JSON)	Текст	Обязательное; значение по умолчанию не задано
Частная встреча: Y/N	Строка	Обязательное; значение по умолчанию не задано
Доступность: busy/absent/quest/free	Строка	Обязательное; значение по умолчанию не задано
Оповещать об ответах участников: Y/N	Строка	Обязательное; значение по умолчанию не задано
Разрешить участникам приглашать: Y/N	Строка	Обязательное; значение по умолчанию не задано
Скрыть участников: Y/N	Строка	Обязательное; значение по умолчанию не задано
Описание	Текст	Необязательное; по умолчанию пустая строка
Место встречи	Строка	Необязательное; по умолчанию пустая строка
Напоминания (JSON)	Текст	Необязательное; по умолчанию `[]`
Уникальный ключ операции	Строка	Обязательное; значение по умолчанию не задано

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

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

Укажите ожидаемого пользователя подключения и ID его личного календаря.
Введите название, начало и конец с часовым поясом и целыми секундами. Продолжительность: до 31 суток.
Передайте от 1 до 20 участников вместе с организатором массивом ID.
Явно задайте приватность встречи Y/N, доступность busy/absent/quest/free, уведомления об ответах, разрешение приглашать и скрытие участников Y/N.
При необходимости заполните описание, место и напоминания массивом объектов type/count; пустой массив оставляет встречу без напоминаний.
Закрепите ключ за одной встречей и сохраняйте ID и версию результата для последующих изменений.

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

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

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

ID встречи: целое число.
Текущая версия встречи: целое число.
Получен сохранённый результат: да/нет (Y/N).

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

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

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

Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.

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

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

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

ID участников с организатором (JSON)

[
  21,
  22
]

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

Напоминания (JSON)

[
  {
    "type": "min",
    "count": 15
  }
]

Массив до 10 напоминаний. У каждого объекта ровно два обязательных ключа: type со значением min, hour или day и count с целым числом 0–525600. Пример означает напоминание за 15 минут. Повторяющиеся пары запрещены. [] допустим и используется по умолчанию, это встреча без напоминаний; {} вместо массива неверен.