> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gurubase.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Bot

> AI-powered ticket responses directly in your Jira issues

Add Gurubase to your Jira workspace to automatically answer support tickets, provide documentation links, and assist your team — all without leaving Jira.

## Why Use the Jira Bot?

<CardGroup cols={2}>
  <Card title="Auto-Answer Tickets" icon="bolt">
    Bot automatically responds to new tickets matching your JQL query
  </Card>

  <Card title="Reduce Response Time" icon="clock">
    Instant answers from your knowledge base while agents handle complex issues
  </Card>

  <Card title="JQL-Powered Targeting" icon="filter">
    Control exactly which tickets the bot monitors using Jira Query Language
  </Card>

  <Card title="Context-Aware" icon="brain">
    Answers consider ticket title, description, and comments
  </Card>
</CardGroup>

## How It Works

| Mode       | Behavior                                                                                  |
| ---------- | ----------------------------------------------------------------------------------------- |
| **Auto**   | Bot automatically responds to new tickets matching your JQL. Also responds when mentioned |
| **Manual** | Bot only responds when explicitly mentioned with `@gurubase`                              |

<Note>
  **Self-hosted:** This integration is currently in beta for selected users.
  **Cloud:** Available to all users.
</Note>

***

## Setup

<Steps>
  <Step title="Create Atlassian API Token">
    1. Go to [Atlassian API Token settings](https://id.atlassian.com/manage-profile/security/api-tokens)
    2. Click **Create API token**
    3. Copy the token
  </Step>

  <Step title="Navigate to Jira Bot">
    Go to **Gurubase Dashboard** → Select your Guru → **Integrations** → **Deployments** → **Jira**
  </Step>

  <Step title="Connect Your Jira">
    Fill in the connection details:

    | Field          | Value                                                     |
    | -------------- | --------------------------------------------------------- |
    | **Domain**     | Your Atlassian domain (e.g., `your-domain.atlassian.net`) |
    | **User Email** | Your Atlassian account email                              |
    | **API Token**  | The token you created in Step 1                           |

    <Frame>
      <img src="https://mintcdn.com/gurubase/O6mo4rszDqTtuRsW/images/bots/jira/before.png?fit=max&auto=format&n=O6mo4rszDqTtuRsW&q=85&s=3baea7d078bdebd7ce0d61d5ba7001f1" alt="Jira Integration Fields" width="3062" height="1858" data-path="images/bots/jira/before.png" />
    </Frame>
  </Step>

  <Step title="Configure Bot Settings">
    After connecting, configure the bot behavior:

    <Frame>
      <img src="https://mintcdn.com/gurubase/jeAHiHwl0JAA3N8C/images/bots/jira/after.png?fit=max&auto=format&n=jeAHiHwl0JAA3N8C&q=85&s=c092b6e6a41cadbb3783134f1f19b0a0" alt="Jira Bot Settings" width="3124" height="1982" data-path="images/bots/jira/after.png" />
    </Frame>

    **Bot Mode:** Choose Auto or Manual mode.

    **JQL Query:** Define which tickets the bot monitors. Click **Validate** to test your query.

    Example JQL queries:

    ```
    project = SUPPORT AND status = Open
    ```

    ```
    project IN (HELP, SUPPORT) AND created >= -7d
    ```
  </Step>
</Steps>

<Warning>
  The Jira Bot only processes **new tickets** created after setup. Updates to JQL only apply to future tickets — historical tickets are not processed.
</Warning>

***

## Using the Bot

Once configured, the bot automatically monitors tickets matching your JQL query and responds based on your mode setting.

To manually trigger a response, mention the bot in any ticket comment:

```
@gurubase How do I reset my password?
```

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Jira Data Ingestion" icon="jira" href="/integrations/ingestion/jira">
    Import Jira tickets as knowledge sources
  </Card>

  <Card title="Slack Bot" icon="slack" href="/integrations/bots/slack">
    Add Gurubase to your Slack workspace
  </Card>

  <Card title="Zendesk Bot" icon="headset" href="/integrations/bots/zendesk">
    Deploy Gurubase in Zendesk
  </Card>

  <Card title="Data Sources" icon="database" href="/guides/data-sources">
    Add documentation the bot will reference
  </Card>
</CardGroup>