Star us on GitHub

Microsoft Teams self-hosted


If you want to use the Microsoft Teams integration in your self-hosted instance, you can create a custom Teams app and use its client id and secret as your MICROSOFT_TEAMS_BOT_ID and MICROSOFT_TEAMS_BOT_PASSWORD environment variables.

Azure App Registration setup
  • Create an Azure App Registration here. Once your app is created, use the "Application (client) ID" as your MICROSOFT_TEAMS_BOT_ID environment variable.

  • In the "Certificates & secrets" section, add a new client secret. Use its value as your MICROSOFT_TEAMS_BOT_PASSWORD environment variable.

  • In the "API permissions" section, add the following Microsoft Graph Application permissions to your app:

    • Channel.ReadBasic.All
    • Team.ReadBasic.All
    • TeamsAppInstallation.ReadForTeam.All
Bot Framework setup
  • Go to Bot Framework to create a new bot.

  • Enter your Microsoft App ID from step 1.

Microsoft Teams app setup
  • Download and unzip the example Teams app bundle here. In manifest.json, replace all occurrences of YOUR_APP_ID with the Microsoft App ID from step 1. Create a new zip file from the 3 files.

  • In the Microsoft Teams app, under "Apps > Manage your apps", upload a custom app using the zip file from the previous step. Install this for each team you would like to recieve alerts in. integration setup
  • In your self-hosted instance, navigate to the Integrations page, e.g. Connect to Microsoft Teams and sign in using your Microsoft credentials.

  • At this point, the integration should be successfully installed. When configuring a new or existing alert, you can add one or more Microsoft Teams channels to notify.