Kore.ai provides integration for a built-in JIRA Bot that you can use to display message notifications and execute tasks directly from the Kore.ai application. To use the JIRA Bot, you just need to add the Bot to your Kore.ai account, and then configure the settings for the Bot, such as authentication to access JIRA, and the notification messages that you want. This topic describes the JIRA built-in Bot for Kore.ai. For more information about other Kore.ai Bots, see Adding Bots.

About the Kore.ai Bot for JIRA

JIRA is a web-based issue tracking tool that provides bug tracking, issue tracking, and project management functions.

Integration Type	Web Service – Connect to this Bot using a web service integration where Kore.ai polls the service for updates based on a specified interval. Webhook – Connect to this Bot using a webhook integration where the web application pushes message notifications in near real time.
Category	Project Management – This Bot is available in the Kore.ai application in the Project Management category.

Configuring JIRA 

JIRA is a bot which can be configured as a webhook or a web service. Both types of integration offer similar tasks and requires a JIRA account. A webhook integration provides near real-time message notifications to your Kore.ai account. As soon as an event occurs in your JIRA application,JIRA immediately informs Kore.ai at the webhook URL specified. This differs from a JIRA web service where Kore.ai connects to JIRA using your JIRA account credentials to check for messages based on the time interval that you specify for the bot task.

 Configuring Webhook 

To configure a JIRA webhook for Kore.ai, you must have a JIRA account with administrator access as well as API access to configure a webhook. If you don’t, you’ll need to contact theJIRA system administrator for your company. For more information, see the JIRA Administrator’s Guide.
To get started configuring the webhook in JIRA, you’ll need two things:

1. The Kore.ai webhook URL provided when you set up an alert in your Kore.ai account for each alert that you want to enable in JIRA.
2. A valid Username and Password for an account with JIRA API access.

The webhook URL is account-specific and cannot be transferred to any other account. This means that if you configure a JIRA webhook using a test account, you will have to recreate the alert and get a new webhook URL to configure in JIRA. The following URL is an example webhook URL.
https://company.kore.com/hooks/c6089802f36250c179dcb1aa29afd24c
This procedure describes the steps in JIRA to configure a webhook using a Kore.ai webhook URL endpoint.

1. Log on to JIRA and on the Settings menu, click System.
2. In the Advanced section, click Webhooks to display the Webhooks page.
3. Click Create a Webhook to open the Create Webhook dialog.
4. In the Name field, enter the name of your webhook used in the JIRA application.
5. In the URL field, enter the Kore.ai webhook URL.
6. Leave the Exclude details checkbox cleared.
7. In the JQL field, add the Events that will trigger a Kore.ai alert for this webhook. The default is All Issue Events.
8. Click Create to save your webhook in JIRA.

For more information, see Managing Webhooks in the JIRA documentation and Webhooks in the developer documentation for JIRA.
You can setup message notifications to your Kore.ai account using a JIRA webhook. Click , click Get notified when…, and then click one of the JIRA webhooks described in the following table.

TASK	TO CONFIGURE THIS TASK…
Issue Updates via Webhook	In the Setup Task dialog, Copy and save the URL, or click Email Instructions to send the URL to an email account. For more information, see Configuring JIRA Webhooks. Optionally, click the gray box in Filters to setup one or more filters to prevent message notifications for specified criteria. You can filter on one or more of the following: Issue Type Assignee Reporter Project Click Done to save the filter. optionally customize the Task Name  optionally customize the Short Description enable or disable Mute task notifications
Project Updates via Webhook	In the Setup Task dialog, Copy and save the URL, or click Email Instructions to send the URL to an email account. For more information, see Configuring JIRA Webhooks. optionally, click the gray box in Filters to setup one or more filters to prevent message notifications for specified criteria. You can filter on: Project Events Click Done to save the filter. optionally customize the Task Name optionally customize the Short Description enable or disable Mute task notifications

Web Service Configuration

To configure web service tasks, you need to add the JIRA Bot from the Kore.ai Marketplace tab in the Kore.ai application, and then setup the task.
To setup a JIRA task, click Connect to Jira, enter the JIRA URL for your company, for example, MyCompanyName.atlassian.net, your JIRA account user name (not your email address), your password, and then press Enter.
After you are connected, you can perform tasks for JIRA directly from the Kore.ai application and setup message notifications to get notified in the Kore.ai application when an event occurs in JIRA.
The following table describes JIRA tasks that you can integrate with Kore.ai.

TASK	TO CONFIGURE THIS TASK…
Assign Issue	In the Perform Task dialog, search for an Issue and then search for an Assignee. In a space room, you can enter @jira assignissue Bot command to invoke and configure this task.
Post Comment on Issue	In the Perform Task dialog, search for an Issue enter a Comment optionally search for one or more Users, and then click Add for User Mention. In a space room, you can enter @jira commentissue Bot command to invoke and configure this task.
Update Issue Status	In the Perform Task dialog, search for an Issue and then select a Status. In a space room, you can enter @jira changestatus Bot command to invoke and configure this task.
Create Issue	In the Perform Task dialog, select a Project select for an Issue Type enter a Summary title for the issue and then optionally enter Description of the issue. In a space room, you can enter @jira createissue Bot command to invoke and configure this task.
Attach a File	In the Perform Task dialog, search for an Issue and then Attach File. In a space room, you can enter @jira attachfile Bot command to invoke and configure this task.

You can setup message notifications to your Kore.ai account using a JIRA web service. Click , click Get notified when…, and then click one of the following JIRA web services described in the following table.

TASK	TO CONFIGURE THIS TASK…
Get All my Issues	In the Setup Task dialog, Select a Project optionally customize the Task Name  optionally customize the Short Description enable or disable Mute task notifications optionally customize the interval for message notifications in the Check for updates… section
Issues Assigned to You	In the Setup Task dialog, optionally customize the Task Name  optionally customize the Short Description enable or disable Mute task notifications optionally customize the interval for message notifications in the Check for updates… section
Issue Updates	In the Setup Task dialog, optionally, click the gray box in Filters to setup one or more filters to prevent message notifications for specified criteria. You can filter on one or more of the following: Issue Type Assignee Reporter Project Click Done to save the filter. optionally customize the Task Name optionally customize the Short Description enable or disable Mute task notifications optionally customize the interval for message notifications in the Check for updates… section
Project Updates	In the Setup Task dialog,  optionally customize the Task Name  optionally customize the Short Description enable or disable Mute task notifications optionally customize the interval for message notifications in the Check for updates… section

Next Steps

After JIRA is configured as webhook or web service, when any of the events occur in JIRA, a message is displayed on the Bots tab in the Messages section for the Kore.ai account.