Добавление участника(ов) в группу

Активити (робот) "Добавление участника(ов) в группу" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Автоматическое добавление сотрудников в рабочую группу при создании проекта;
Включение участников в группу по результатам поиска или другого активити (робота);
Массовое добавление пользователей в группу при определённых условиях;
Синхронизация состава группы с данными из CRM или других сущностей;
Добавление ответственного за сделку в группу проекта;
Автоматическое формирование рабочих групп при создании задач;
Интеграция с процессами онбординга новых сотрудников;
Добавление участников в группу на основе роли или подразделения;
Управление доступом к группам через бизнес-процессы;
Автоматизация добавления в группу при смене владельца сущности.

Как работает активити (робот):
- Активити (робот) добавляет одного пользователя в указанную рабочую группу Битрикс24;
- Использует метод API sonet_group.user.add;
- При передаче нескольких ID пользователей через параметр list_users добавляется только первый пользователь;
- Для добавления нескольких пользователей используйте активити (робот) в цикле с итератором или последовательно.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Указывается идентификатор рабочей группы, в которую добавляется пользователь. Примеры: - {=Variable:GROUP_ID} - ID группы из переменной предыдущего активити (робота); - {=A12345:search_result_first_string} - ID из результата активити (робота) "Поиск групп"; - 42 - конкретный ID группы; - {=Document:UF_CRM_GROUP_ID} - ID группы из поля документа.
ID пользователя	Обязательный параметр. Указывается идентификатор пользователя (или массив ID), который добавляется в участники группы. При множественном значении добавляется только первый пользователь. Примеры: - {=User:ID} - текущий пользователь; - {=Document:ASSIGNED_BY_ID} - ответственный за документ; - {=Variable:USER_ID} - ID из переменной; - user_1 - в формате user_ID; - {=Iterator:Value} - для каждого пользователя из итератора.
Запускать от имени	Сотрудник, с правами которого выполняется действие. Рекомендуется выбирать администратора системы.

Примеры использования активити (робота)

Описание примера	Решение
Добавить ответственного за сделку в группу проекта	group_id - {=Variable:PROJECT_GROUP_ID}, list_users - {=Document:ASSIGNED_BY_ID}
Добавить текущего пользователя в группу	group_id - {=Variable:GROUP_ID}, list_users - {=User:ID}
Добавить пользователя из результата поиска групп	group_id - {=A12345:search_result_first_string}, list_users - {=Variable:NEW_MEMBER_ID}
Добавить участника при создании группы	group_id - {=A12345:i_group_id}, list_users - {=Template:TargetUser}. Используйте ID созданной группы из активити (робота) "Создание группы".
Добавить пользователя по ID из CRM	group_id - 42, list_users - {=Document:CONTACT_ID}. При добавлении контакта используйте соответствующий user_id.
Добавить нескольких пользователей через итератор	В итератор передайте массив ID. group_id - {=Variable:GROUP_ID}, list_users - {=Iterator:Value}. Активити (робот) выполнится для каждого элемента.
Добавить владельца лида в группу	group_id - {=Variable:GROUP_ID}, list_users - {=Document:ASSIGNED_BY_ID}
Добавить пользователя из переменной предыдущего шага	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_TO_ADD}
Добавить создателя процесса в группу	group_id - {=Variable:GROUP_ID}, list_users - {=Template:TargetUser}
Добавить пользователя в группу по ID из поля формы	group_id - {=Document:ID}, list_users - {=Variable:FORM_USER_ID}

Возвращаемые параметры данного активити (робота):
- Успех выполнения (good_track) - 1 при успешном добавлении, 0 при ошибке.
Используйте в условиях для проверки результата.

При ошибке (например, группа не найдена, недостаточно прав), параметр "Успех выполнения" будет равен 0.
Проверяйте значение перед дальнейшими шагами.

Ограничения и рекомендации:

Один пользователь за вызов:
Активити (робот) добавляет только одного пользователя за один вызов.
При передаче массива ID используется только первый элемент.
Для массового добавления используйте итератор.

Права доступа:
Пользователь "Запускать от имени" должен иметь права на добавление участников в группу.
Обычно требуются права модератора или владельца группы.

Ваша корзина пуста

Добавление участника(ов) в группу