Koji can be installed as an app in Microsoft Teams. This page describes what Jira administrators and users must to in order to how to find and install Koji.

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.

3. Send the information on how to log in to Koji to users.

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.

...

Installing Koji

1. In your Microsoft Teams, click Apps in the navigation area 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. Open Koji backoffice and go to Configuration > Tenants > Deploy to Microsoft Teams.

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

3. Click Download the app to get the archive.

4. Send the archive to customers, so they can install the app in their Microsoft Teams. The steps are described on this page.

...

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

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. Once Koji is installed, a new chat automatically opens.

Logging in

Now your Koji is ready to go. The next step is actually taken by users: they must log in to the app. As the administrator, please, send your users the information about what they must enter:

• Domain: my-company.atlassian.net

• Login: typically, this is the email a user is entering to log in to Jira.

• Contact details of a person users can contact in case they fail to log in.

Note that the authentication procedure is slightly different for Jira customers and Jira users. The point is that a Jira customer is asked to type a password, while a Jira user is given an authorization link.2. In the search field of the Apps view, enter “Koji”.

3. Click the card of Koji.

...

4. In the Koji installation dialog, click Add. The installation takes a few seconds.

...

What’s next?

Once the installation is finished, Koji is opened automatically. Also, its icon is available in the navigation area on the left side of the window.

Now you can start communicating with your virtual assistant. First of all, you must log in Jira. To do so, click the Login to JIRA button.

...