Table of Contents

Quick Start Guide

Brian Mohr Updated by Brian Mohr

What to know

  • Setting up the integration requires installing an application into both Microsoft Teams and Jira
  • Any user can install the Teams application, however a Jira administrator needs to install and configure the Jira application
The following guide illustrates each installation step. Click here to view an animation of all steps

Install the Microsoft Teams application

  1. Click the 3 dots on the left bar in Microsoft Teams
  2. Type "Jira"
  3. Select the "Jira Integration Plus" application
  4. Click the "add" button to install the application in to your Teams environment

Install the Jira application

  1. Click the "Add Jira plugin" button inside of Teams
  2. Click the "Try if free" button in the Atlassian Marketplace website
  3. Select Cloud, Server, or Data Center depending on your installation
  4. Click "Start free trial"
  5. In case you are signed in to more than once Jira account, select the site to install the application
  6. Again, click "Start free trial"
  7. Wait while Jira installs the application
  8. Once loaded, click "Manage app"
  9. Click the "configure" button next to "Getting started"

Pro tip: Open multiple browser windows when configuring the Jira application link. That will help copying values between screens
  1. Click the "Copy" button next to step 1
  2. Click the "Open link in JIRA" button
  3. Paste the copied link in the text box under "Configure Application Links"
  4. Click "Create new link"
  5. Return to the setup screen and click "Next" under step

  1. Click "Copy" under step 1 on the next screen
  2. Paste the value into "Application Name" in Jira
  3. Click "Create incoming link" at the bottom on the form
  4. Click the "Continue" button
  5. Return to the setup screen and click "Next" under step 3

Configure Consumer and Public Keys

  1. Click the "Copy" button next to the "Consumer Key" field
  2. Navigate back to Jira and paste that value into the first 2 fields: "Consumer Key" and "Consumer Name"
  3. Return to the setup screen and click the "Copy" button next to "Consumer Key"
  4. Navigate back to Jira and paste that value into the "Public Key" field
  5. Return to the setup screen and click "Next" under step 2

  1. Click the "Save connection" button
  2. Click "Allow" to grant the application permission to access your Jira instance

Connect Teams to Jira

  1. Click the "Copy" button next to the connect code
  2. Click the "Open Teams" button
  3. Paste the connect code into the direct chat w/ the Teams bot application

Connect Teams and Jira personal user account

Each user in your Teams organization will need to complete this step once.

  1. Click "Connect Now" to connect your individual Teams user to your Jira user account
  2. Click "Allow" to grant the system access to your user account
  3. Success !!!

How did we do?

Install to Data Center and Server Jira Instances

Add to your teams channels

Contact