Workgroups and Projects: Overview of Methods

Workgroups and projects in Bitrix24 help organize team collaboration. In groups, you can:

  • distribute tasks among participants, set deadlines, and track progress,

  • exchange documents, store, and collaboratively edit files,

  • discuss tasks in chats, leave comments, and hold online meetings.

Quick navigation: all methods and events

User documentation: Workgroups and Projects in Bitrix24

What Distinguishes a Group from a Project

A project is a group with enhanced capabilities. Its main distinction from a group is the ability to set deadlines. The algorithm for creating a group and a project is identical: in both cases, use the method sonet_group.create. For a project, specify additional parameters:

  • PROJECT — indicates that the created object is a project,

  • PROJECT_DATE_START — the project's start date,

  • PROJECT_DATE_FINISH — the project's end date.

Connection of Workgroups and Projects with Other Objects

Users. Collaborate on tasks within workgroups and projects. Use the methods group sonet_group.user.* to manage workgroup participants: add, remove, assign roles, and permissions.

Tasks. Needed to distribute responsibilities among workgroup participants, track completion, and control deadlines. Create and modify tasks using the group of methods tasks.task.*.

Drive. A storage linked to a specific group or project containing necessary materials for work. To manage storages, use the group of methods disk.storage.*.

Universal Lists. Structured lists of items within workgroups. Needed to create registries or data storages, sort and filter information, and automate accounting. Create, update, and delete universal lists using the methods from the group lists.lists.*.

News Feed. Use the method log.blogpost.add to publish messages that will only be visible to users added to the group.

Widgets for Workgroups and Projects

Add your items to dropdown menus to enhance the functionality of workgroups and projects:

Specify the widget embedding code in the PLACEMENT parameter of the method placement.bind.

Specialized Workgroups: Scrum and Flow

Scrum in Bitrix24. A tool for organizing team collaboration using the Scrum methodology. It allows breaking projects into sprints — short iterations during which the team completes a specific volume of tasks.

Flow in Bitrix24. A tool for organizing team collaboration. It allows gathering tasks in one place and quickly distributing them among performers.

Scrum and Flow are implemented based on workgroups.

To create a Scrum, use the method creating a new group. To make a group a Scrum, fill in the SCRUM_MASTER_ID field.

To link a Flow to a group, use the identifier groupId. To obtain the identifier, use the method creating a new group or the method getting a list of groups.

Overview of Methods and Events

Scope: sonet

Who can execute the method: any user

Method

Description

sonet_group.create

Creates a group

sonet_group.update

Modifies group parameters

socialnetwork.api.workgroup.get

Retrieves data on the workgroup

socialnetwork.api.workgroup.list

Retrieves a list of workgroups

sonet_group.get

Retrieves a list of groups

sonet_group.feature.access

Checks the current user's permissions

sonet_group.user.groups

Retrieves a list of the current user's groups

sonet_group.setowner

Changes the group owner

sonet_group.delete

Deletes a group

Managing Users in Groups

Method

Description

sonet_group.user.invite

Invites users to the group

sonet_group.user.request

Sends a request to join the group

sonet_group.user.add

Adds users to the group

sonet_group.user.update

Changes a user's role in the group

sonet_group.user.get

Retrieves a list of group participants

sonet_group.user.delete

Removes users from the group

Event

Triggered

onSonetGroupAdd

After adding a new workgroup

onSonetGroupUpdate

After modifying a workgroup

onSonetGroupDelete

At the moment of deleting a workgroup