How to Connect WorkerB to Microsoft Teams

How to Install the WorkerB application in MS Teams

Before you start:

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

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

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

Type LinkUser and click on the button to "Link my account".

You can also connect your Teams instance from LinearB. Go to Company Settings → Microsoft 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.