Get project members
The "Get project members" robot returns to a business process the membership of a Bitrix24 (Alaio) workgroup or project by its ID: the owner, the list of moderators, the full member list and their count, plus a Found Y/N flag. Member lists come as arrays of employee IDs, ready to drop into a notification, a task or the next robot.
The standard Bitrix24 (Alaio) business process designer has no way to get a project's membership: no field and no action for workgroups. The robot reads members via REST by group or project ID and returns three lists: the owner (one employee), moderators and all active members including the owner and moderators. Employees invited but not yet accepted are not counted. It also returns the member count and a Found Y/N flag: N means a group with this ID does not exist or is not accessible to the process starter. Typical scenarios: notify every project member when a deal changes stage; create a task for the project moderators; check that a project has at least one moderator and appoint one if not. The robot pairs with "Get employee projects" and "Project info". Requires the "Workgroups" (sonet) permission.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Group / project ID | int | yes |
What does the robot return?
| Parameter | Type |
|---|---|
| Owner | int |
| Moderators | int |
| All members (including owner and moderators) | int |
| Member count | int |
| Found (Y/N) | string |
What errors can the robot return?
The robot writes these messages to the business process log when it cannot complete a step. The text tells you what to fix in the settings or the data.
- Error: group / project ID is not set
- Error accessing the group (check the ID and the "Workgroups" permission)
Scenario: notify the project team
- A deal moves to the Launch stage, a deal field holds the project ID
- The robot gets all project members by that ID
- The process sends each member a launch notification