Роботека
Роботека · Роботы · Получить участников проекта

Получить участников проекта

Робот «Получить участников проекта» возвращает в бизнес-процесс состав рабочей группы или проекта Битрикс24 по его ID: владельца, список модераторов, полный список участников и их количество, а также признак «Найдено» Y/N. Списки участников приходят массивами ID сотрудников — их можно сразу подставить в уведомление, задачу или следующий робот.

В штатном дизайнере бизнес-процессов Битрикс24 нет способа получить состав проекта: ни поля, ни действия для рабочих групп. Робот читает участников через REST по ID группы или проекта и возвращает три списка: владелец (один сотрудник), модераторы и все активные участники, включая владельца и модераторов. Приглашённые, но ещё не принявшие приглашение сотрудники не учитываются. Дополнительно возвращаются количество участников и признак «Найдено» Y/N: N означает, что группа с таким ID не существует или недоступна пользователю, запустившему процесс. Типовые сценарии: разослать уведомление всем участникам проекта при смене стадии сделки; поставить задачу модераторам проекта; проверить, что у проекта есть хотя бы один модератор, и назначить его при отсутствии. Робот работает в паре с «Получить проекты сотрудника» и «Информация о проекте». Требует право доступа «Рабочие группы» (sonet).

Какие параметры принимает робот?

Параметр Тип Обязательный? По умолчанию
ID группы / проекта int да

Что возвращает робот?

Параметр Тип
Владелец int
Модераторы int
Все участники (включая владельца и модераторов) int
Количество участников int
Найдено (Y/N) string

Какие ошибки может вернуть робот?

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

  • Ошибка: не указан ID группы / проекта
  • Ошибка при обращении к группе (проверьте ID и право доступа «Рабочие группы»)

Сценарий: уведомить команду проекта

  1. Сделка переходит на стадию «Запуск», в поле сделки указан ID проекта
  2. Робот получает всех участников проекта по этому ID
  3. Процесс отправляет каждому участнику уведомление о запуске

Похожие роботы