How to Connect WorkerB to Microsoft Teams

How to Install the WorkerB application in MS Teams

Before you start:

To install WorkerB in your Teams org, contact your LinearB CSM or email to receive a WorkerB install .zip file.

In order to install WorkerB, make sure to have the below logins/credentials ready.

  • To add the WorkerB application to your Teams org, have your MS Teams admin credentials handy
  • To connect Teams to LinearB, have your LinearB admin credentials handy
  • To connect MS Teams users, have a user that can connect MS Teams to your Git provider

Follow these steps to install WorkerB in Teams and connect the application to LinearB

  1. Install WorkerB into your MS Teams instance
  2. Connect MS Teams to LinearB
  3. Connect WorkerB to your team channels
  4. Connect WorkerB for individual users

Install WorkerB into your Teams instance

You must be an MS Teams admin in order to install the WorkerB app.

Browse to your MS Teams org admin panel and click on the “Upload” option as shown in the below pictures.

  • Upload the .zip file that you downloaded in the previous step
  • Search for WorkerB application

Connect MS Teams to LinearB

You must be a LinearB admin to connect WorkerB to MS Teams.

Once the .zip file is installed, go to the Apps section in MS Teams, search for WorkerB, and click into the applications.

You can also connect your Teams instance from LinearB. Go to Company SettingsMicrosoft Teams and click on “Connect”. (Or click here.)

You will be prompted to connect to Microsoft Teams. Accept the permissions request and you will be taken back to the LinearB admin page.

The LinearB admin page will now include a URL link in the center of the page. This link is a public invitation for your team to install the WorkerB application personally.

Post this link in your team channel in order to invite your team members. See below how this message will appear in your team channel:

Connecting WorkerB to an MS Teams channel

Go to the WorkerB app and type “link team”

Choose a LinearB team and MS Teams team and press next, and wait for the success message to pop up.

Choose an MS Teams channel and press next, you'll next see a confirmation message.

In the connected Teams channel, you will see the following alert.

Customizing WorkerB team alerts

Once a team channel is connected to WorkerB, you will see the team listed in the LinearB team settings page, as well as in company settings, under Microsoft Teams. Click "Edit notifications" to select which notifications are sent to your team channel. You can also customize the thresholds for triggering an alert from the edit notifications page. You can read more on configuring these alerts here: How Do I Manage and Customize Notifications?

Connecting WorkerB for individual users

Once the WorkerB invite link is generated, any user in Teams can click on the link to connect WorkerB to their Teams user account. The WorkerB app will now also be visible

Click Add to activate the WorkerB app in your Teams user account. Once added, type LinkUser in the LinearB app, and click on "Link my account" in the popup that opens.

You'll be taken to the LinearB app in your browser and prompted to log in with your Git credentials.

Once connected you'll receive an alert in Teams confirming you're connected. You can communicate with WorkerB via the chat section of Teams.

For ease of use, we'd recommend pinning WorkerB to your top chats. Click on the 3 dots next to the WorkerB bot, and select "pin" to always have this app available.

How to customize your personal alert preferences

You can configure which alerts you receive from WorkerB by typing Pref in your WorkerB app. Select and deselect alerts you would like to receive, and click Save.

How to use WorkerB personal commands

Once connected, you can start using WorkerB commands in Teams to perform the following actions in any channel. Type Help to see a list of all available commands.


Opens a help message with all current availble commands.


Link your Teams account with your LinearB account.


Invite your team members to use personal notifications and commands.


Customize your personal notification preferences.


Display all open pull requests issued by you.

Prs long

Display all of your PRs which have been open for a long time.

Prs done

Display all completed PRs.


Display your latest PR updates.


Display all your open PR reviews.


Unlink your Teams account from LinearB ☹️


How did we do?

Powered by HelpDocs (opens in a new tab)