> For the complete documentation index, see [llms.txt](https://docs.nisa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nisa.ai/connecting-data-sources/jira.md).

# Jira

Atlassian Jira is a comprehensive solution offering bug tracking, workflow streamlining, and agile project management capabilities for teams, irrespective of their size. Our Business Chatbot integrates seamlessly with Jira Cloud, and automatically gathers, synchronizes, and indexes the following elements:

<table data-header-hidden><thead><tr><th width="358"></th><th></th></tr></thead><tbody><tr><td>Epics</td><td>This includes the Epic ID, Content, Type, and associated timestamps.</td></tr><tr><td>Projects</td><td><p>We capture Project ID, Content, Type, Slug, and relevant timestamps.</p><p><br></p></td></tr><tr><td>Issues</td><td>Our integration covers Issue ID, Content, Status, Priority, associated Comments, Project, Slug, Collaborators, and pertinent timestamps.<br></td></tr><tr><td>Attachments</td><td>We index Attachment ID, Size, Type, Content, the corresponding Project, Collaborators, and timestamps.</td></tr></tbody></table>

By connecting your Jira with our Business Chatbot, you are essentially boosting ChatGPT's ability to understand your projects better and provide more contextual responses.

## Setting Up the Jira Cloud Connector

Before you can connect Jira Cloud to our Business Chatbot dashboard, you'll need to create an OAuth App on the Jira Cloud platform. Follow these steps after logging into [Atlassian's Developer Portal](https://developer.atlassian.com/console/myapps/):

\
**Step 1.** Click "Create", then choose "OAuth 2.0 integration".

**Step 2.** Provide a suitable name for the integration, agree to the terms, then click "Create".

**Step 3.** On the sidebar, click "Settings". Here, add a description and image, then hit "Save changes".

**Step 4.** Note down the application’s `Client ID` and `Client Secret` displayed on this page. You'll need these soon. It will only be displayed after you have added an API.

**Step 5.** To create API access with the correct permissions, click "Authorization" in the sidebar, find "OAuth 2.0 (3LO)", and select "Configure" or "Add".

**Step 6.** You'll see a Callback URL form. Enter the OAuth redirect URL for your Business Chatbot deployment here. Then save changes.

* [https://YOUR\_DASHBOARD\_DOMAIN/oauth/atlassian](http://localhost:3001/oauth/atlassian)

**Note: Replace your own dashboard domain url.**

**Step 7.** You'll be prompted to add APIs. Click the "Add APIs" hyperlink.

**Step 8.** Next, click "Permissions", locate the "Jira platform REST API" and hit "Add", then "Configure".

**Step 9.** You'll need to enable certain permissions. Add the following:

* `read:jira-work` - to view Jira issue data
* `read:jira-user` - to view user profiles

<figure><img src="/files/Nr8dfiQy4mSrezhp5rr8" alt=""><figcaption></figcaption></figure>

Then, save your changes.

**Step 10.** Now, head over to the Sources section in the Business Chatbot dashboard, find Jira, and enter both the `Client ID` and `Client Secret` which you can get in the "Settings" tab. Also input your Jira instance Base URL without a trailing slash (for example, "[https://example.atlassian.net](https://example.atlassian.net/)").

And there you have it! Your Jira Cloud connector is set up and ready to synchronize content. To start capturing data, you need to connect a Jira Cloud instance using the correct authentication credentials.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nisa.ai/connecting-data-sources/jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.