Получить состав группы или проекта с ролями
Робот «Получить состав группы или проекта с ролями». Возвращает действующих участников группы и их роли для дальнейших шагов процесса.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для владельца проекта и администратора групповых уведомлений. Позволяет получить реальный действующий состав с ролями, не включая приглашённых, которые ещё не вступили.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID группы или проекта | Целое число | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID группы или проекта.
- После чтения выберите нужную категорию: владелец, модераторы либо обычные участники.
- Для полного состава используйте JSON участников и ролей.
- Передайте выбранный список в следующий шаг уведомления или проверки обязательной команды.
- Если готовите изменение состава, сохраните актуальные роли как ожидание непосредственно перед правкой.
Учебный пример и ожидаемый результат
В проекте 50 владелец 21, модератор 22, обычный участник 23 и непринятое приглашение 24. Ожидаемый действующий состав: 21, 22 и 23; приглашение 24 в него не входит. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- Участники и роли в формате JSON: строка.
- Владелец: сотрудник.
- Модераторы: сотрудник, список.
- Участники без роли модератора: сотрудник, список.
- Всего участников: целое число.
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
До 10 000 участников, владелец сверяется с карточкой группы. Чтение состава не подтверждает активность рабочего дня и занятость сотрудников. Отдельный список обычных участников не включает модераторов; для всей команды используйте полный JSON.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.