How to integrate Microsoft Teams with Atlassian at enterprise scale (Jira, Confluence, more)

[#1]

Tips how you can integrate Jira, Confluence and other Atlassian apps in Microsoft Teams across your enterprise.

With over 300 million monthly active users Microsoft Teams is the hub for daily collaboration for many enterprises. As part of Atlassian's open platform we have apps that help you integrate Atlassian into Microsoft Teams to help users get work done.

Automatically add to Microsoft Teams

The Jira app integrates seamlessly with Microsoft Teams both on mobile and desktop.

Admins for Microsoft Teams you can use App Setup policy (docs) to automatically install and pin apps. Add Jira to the app bar so it's a one touch experience for users to access and update Jira issues.

Automatically add Atlassian apps with custom Microsoft Team templates

No need to ask users to manually add in an Atlassian app. With custom template in Microsoft Teams they can be automatically installed when a user creates a team.

Imagine having a Dev or Finance team with Jira, Confluence and Atlas apps automatically added during the creation process.

Follow these Microsoft docs to create your own custom templates with Atlassian apps. Video overview of templates and APIs:

Create a team with Atlassian apps using the Microsoft Graph APIs

For organisations want to automatically provision teams they can include Atlassian apps as part of the creation process using Microsoft Graph APIs (source).

Example with Jira & Confluence cloud apps added 

{
    "template@odata.bind": "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
    "displayName": "Dev Team",
    "description": "The team of our devs to collaborate and deliver on the roadmap",
    "channels": [
        {
            "displayName": "Dev",
            "isFavoriteByDefault": true,
            "description": "This is a sample training channel, that is favorited by default, and contains an example of pinned website and YouTube tabs.",
            "tabs": [
                {
                    "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/aa183fd9-7104-46c4-af9f-9ee9b81d717e",
                    "displayName": "Jira"
                },
                {
                    "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/30bb610c-6321-40fe-a047-056e7d0dac96",
                    "displayName": "Confluence"
                }
            ]
        }
    ],
    "installedApps": [
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/aa183fd9-7104-46c4-af9f-9ee9b81d717e"
        },
        {
            "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/30bb610c-6321-40fe-a047-056e7d0dac96"
        }
    ]
}

The sample code will create a new team called 'Dev Team' with a channel that has both the Jira and Confluence apps automatically installed.

What about existing teams and chats?

Scenario: You have existing teams that you want to add apps such as Jira to. Using the Microsoft Graph you can add Atlassian apps to existing teams with:

Add to teams

1. Add app to a team (docs)

2. Add the app to as a tab, such as the General channel (docs)

Add to chat group

• Add app to chat (docs)

Add to personal scope

• Add app to personal scope (docs)

Cloud app IDs (needed for when you run the 'add app'):

App	ID	Teams App Store
Jira Cloud	aa183fd9-7104-46c4-af9f-9ee9b81d717e	Link
Confluence Cloud	30bb610c-6321-40fe-a047-056e7d0dac96	Link
Opsgenie	6f62d397-8b16-48e9-9fea-1a5193c9fc08	Link
Trello	49e6f432-d79c-49e8-94f7-89b94f3672fd	Link
Atlas	69883cee-eb8c-41c2-9533-7fdb0762e913	Link
Atlassian ChatOps	30ad5de7-5a94-4267-8699-9daa9e18132a	Link
Assist	33621d49-05e8-47e9-844b-f0d1c43ef5be	Link

Jira on-premise Microsoft Teams for Jira | Atlassian Marketplace

[Gerald Brady]

Very interesting but what about your Data Center products?  Could you let us know how to do the same thing for integrating MS Teams with both JIRA and Confluence Data Center?

[Dominic Williamson]

@Gerald Brady (updated) with the Microsoft Teams for Jira | Atlassian Marketplace for on-premise.

[Marco Nowak]

Interesting.

I can find a Teams App called "JIRA Server".

@Dominic Williamson Is this usable for JIRA Server and Data Center as well?

[Gerald Brady]

You can use this app to integrate MS Teams and JIRA Data Center:

Microsoft Teams for Jira | Atlassian Marketplace

It is no way near as powerful as what was shown in this article, but it does work.