Deploying Koji in Microsoft Teams requires some steps to be taken by both Jira administrators and Jira customers.

Prerequisites

Make sure that the Microsoft Bot connection is configured. To learn about it, see the Configuring Microsoft Bot connection page.

Jira administrators

An administrator has to take 2 steps:

1. Add new customers to a project;

2. Generate and send the Koji app to these customers.

Adding new customers

To be able to install Koji in Microsoft Teams, people must be added as customers to a project. As a Jira administrator, perform the following:

1. In your Jira environment, open your project.

2. Click Customers on the left side of the window.

3. Click Add customers in the upper right of the window.

4. Type a customer’s email to send an invitation and click Add. Once they receive an invitation, they can sign up in the project.

Sending the Koji application

When customers have signed up, send them an archive with the Koji app for Microsoft Teams.

1. In your Jira environment, open your project.

2. Open Koji backoffice and go to Configuration > Tenants > Deploy to Microsoft Teams.

3. If necessary, change the name of the application. By default it is Koji.

4. Click Download the app to get the archive.

5. Send the archive to customers, so they can install the app in their Microsoft Teams.

Customers

Customers have to take 3 steps:

1. Register for a project;

2. Log in using proper login and password;

3. Install Koji as a custom app in Microsoft Teams.

Registering for a project

1. Open an email with invitation and follow the sign up link.

2. Enter your name, set a password, and click Save and continue.

Logging in Microsoft Teams

A customer might have several accounts for Teams. It is important to use the proper credentials in order to install and use Koji:

• The tenant name: your-tenant.atlassian.net

• Username (email) that was used for the account creation

• Password

Installing a custom app

You can add the app either for yourself, or for a team. Regardless of your choice, the installation processes are similar. 

Installing for yourself

1. Open Microsoft Teams.

2. On the left side of the window, click Apps and select Upload a customised app.

3. Find and select the archive with Koji, and click Open.

4. In the installation dialog, click Add.

The installation process is quite fast. When Koji is installed, a new chat automatically opens.

Installing for a team

1. Open Microsoft Teams.

2. On the left side of the window, click Apps and select Upload a customised app.

3. Find and select the archive with Koji, and click Open.

4. In the installation dialog, click the down arrow and click Add to a team.

5. Select a team for Koji and click Set up a bot.

When Koji is installed, it is available in your team.

Starting conversation with Koji

To start communicating with Koji, Jira customers or internal Jira users must authenticate in Microsoft Teams. The procedure is slightly different for customers and users: the main difference is that customers are asked to type a password, while Jira users are given an authorization link.