Connecting Microsoft Teams to Status Hero

How to install the Status Hero bot into your Microsoft Teams team and connect it to a channel

Here's how to connect a bot from Status Hero to a channel in Microsoft Teams. Once connected, the bot can collect check-ins from team members with private direct messages, and then display the check-ins and summaries into your Microsoft Teams channel. Our overview and usage guide have more details.

Before you begin

  • Make sure you have a Status Hero account set up first, and that you are the Administrator of the Status Hero account or the Team Lead for the team in Status Hero you want to use with Microsoft Teams.

  • Nobody from your Microsoft Teams instance will get any messages or emails from the Status Hero bot until you explicitly add them to your Status Hero team. (See "Add Users from Status Hero" below).

Installation Steps

In Microsoft Teams, go to "Apps" in the lower left-hand corner.

Search for "Status Hero" and select "Add".

The Status Hero bot will send you a chat with information on the next steps:



Go to the channel that you want to add Status Hero to. Now, from the channel you just selected, @mention the Status Hero bot and give it the connect command:



The Status Hero bot will send you a direct message with an expiring activation code (it's hidden until you click on the "Show the activation code" button:



Next copy that code, log in to Status Hero and paste it into the Team Settings > Integrations > Microsoft Teams and paste it into input box there, and click on the "Connect" button:



In Microsoft Teams, Status Hero will send you a message that it's connected:

Congratulations! Status Hero and Microsoft Teams are now connected. Next, you can add users to Status Hero from Microsoft Teams (see below). And be sure to visit our usage guide to see how the bot works.


Note that you currently cannot connect bots to private channels in Microsoft Teams. More information here:

Add Users to Status Hero from Microsoft Teams

Once connected, you can add users from the team members list in Status Hero, just click on the "Add from MS Teams" button.

Check off the users you want to add. (If your Microsoft Teams instance is large one, a search box will show up so you don't have to scroll down a lot.)

Note: when the bot is first connected, it will try and match up existing users in Status Hero to your Microsoft Teams instance, so those people might already be checked off.


Click on the "Add selected Microsoft Teams users" to add the selected users.

That's it! The new Status Hero users will get a welcome email, and the bot will check them in when the next round of check-ins are scheduled. (You can adjust the check-in notification times and methods for both the team and team members individually.)

Disconnecting the integration

To disconnect Status Hero, visit the Team Settings > Integrations > Microsoft Teams panel in Status Hero and click on the "Remove Microsoft Teams connection" link.

In Microsoft Teams, you can disconnect the integration by @mentioning the bot and sending a disconnect command in the channel it's connected to.