How to Connect WorkerB to Microsoft Teams
- How to Install the WorkerB application in MS Teams
- Before you start:
- Install WorkerB into your Teams instance
- Connect MS Teams to LinearB
- Connecting WorkerB to an MS Teams channel
- Connecting WorkerB for individual users
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
- Install WorkerB into your MS Teams instance
- Connect MS Teams to LinearB
- Connect WorkerB to your team channels
- 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.
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.
Display all of your PRs which have been open for a long time.
Display all completed PRs.
Display your latest PR updates.
Display all your open PR reviews.
Unlink your Teams account from LinearB ☹️