• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Microsoft Teams

Microsoft Teams logo

Deprecation notice

Opsgenie MS Teams Integration v. 1 is has been deprecated, please use Microsoft Teams V2 Integration for the new MS Teams connections.

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.

Microsoft Teams 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.)

If you do not see Sideload a bot or tab option, you must enable sideloading option from your Microsoft Office 365 settings. For more information see here.

Microsoft Teams sideload bot

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

Microsoft Teams Sideload open package

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.

Microsoft Teams connector

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

Microsoft Teams connect to Opsgenie

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.

Microsoft Teams Genie connect

Using Opsgenie’s Microsoft Teams Bot

If your Opsgenie account is not verified you cannot use the Microsoft Teams Bot and the Bot does not respond any of the commands that you send.

If you're using Opsgenie's Free or Essentials plan or if you’re using Opsgenie with Jira Service Management's Standard plan, you can add this integration from your team dashboard only. The Integrations page under Settings is not available in your plan.

  1. Go to Teams and select your team.

  2. Select Integrations on the left navigation and then select Add integration.

Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only. Follow the rest of the steps in this section to set up the integration.

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

  2. Copy the API key on the integration page.

Microsoft Teams settings

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.

Microsoft Teams bot type
Microsoft Teams bot setup

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

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

Microsoft Teams bot help

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.

Microsoft Teams bot chat

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

Microsoft Teams bot help chat

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:

Microsoft Teams Genie connect
Microsoft Teams Genie connect
Microsoft Teams Genie connect

 

Still need help?

The Atlassian Community is here for you.