Integrate Opsgenie with Microsoft Teams

What does Opsgenie offer to Microsoft Teams users?

Opsgenie has a powerful integration with Microsoft Teams. Our integration allows Microsoft Teams users to execute actions on Opsgenie alerts within Microsoft Teams such as acknowledge, close, snooze, etc. List your alerts, integrations, policies, and more. Messages are sent to Microsoft Teams channel when an action is executed on Opsgenie alerts.

Functionality of the Integration

• Executing commands on Opsgenie alerts within Microsoft Teams.

• Forwarding Opsgenie alert actions to Microsoft Teams channels.

Add an Incoming Webhook Connector in Microsoft Teams

1. Download Opsgenie’s Microsoft Teams application package for US from here, for EU from here.

2. In Microsoft Teams, click on Teams section from the left menu.

3. Select the team that you want to connect with Opsgenie, and click on the
   ... button of that team and select Manage team.

4. Open Bots tab (if Developer preview is active, open Apps tab instead.)

5. Click on Sideload a bot or tab (if Developer preview is active, click on Upload a custom app instead.)

6. Select the package you've downloaded and click Open.

7. Click Teams from the left menu.

8. Select the channel to forward Opsgenie alert actions to, and click the ... button on that channel and select Connectors.

9. Add Opsgenie connector.

10. Click Visit site to install to be redirected to a page for connecting Microsoft Teams.

11. Click Connect to Office 365 to be directed to Opsgenie Microsoft Teams integration page.

12. The integration is automatically created. (If not logged into Opsgenie, please log in.) On this page, view the default configurations of the integration. If configuration is not changed, then there's no need to click on Save Integration since it is already saved.

Action Mapping Feature

• Opsgenie allows customers to choose which alert actions to be forwarded to Microsoft Teams.

• By default, create, acknowledge, unacknowledge, close, add note and assign ownership actions are forwarded to Microsoft Teams.

• Add more actions or remove the actions that don't need to be forwarded.

• Forwarding Create action is mandatory.

Using Opsgenie’s Microsoft Teams Bot

1. Go to Settings > Integrations. Search for Microsoft Teams and select Add. 

2. Copy the API key on the integration page.

3. Type @Genie for US, @GenieEU for EU and see that Microsoft Teams suggests the name of the bot. Select it and then type setup [YOUR_OPSGENIE_API_KEY] and hit enter.

4. An "Integration configured successfully." message appears from our bot.

5. Now start executing commands on Opsgenie alerts in the channel.

To use Genie from Chat

1. Click on Chat section from the left menu.

2. Click on New chat button (next to the Search bar).

3. Paste 18de29f7-8984-43fa-b5e6-05294e1a12bd to the To field.

4. See that our bot is suggested, and select it.

5. Type commands to the bot now, e.g. help, list alerts or get tinyId.

Chat User Mapping

1. "Require Matching a User" is used to force matching Microsoft Teams accounts with Opsgenie accounts.

2. Associate your Microsoft Teams account to your Opsgenie account by using the * @Genie connect for US, @GenieEU connect for EU command.

3. Chat user mapping flow: