#Jira Cloud Integration

Connect your Jira Cloud site to Driver for automatic support ticket analysis. When a support ticket is created or updated in Jira, Driver analyzes it against your codebases and replies with a detailed analysis based on its codebase context.

Requirements:

• Driver account with Organization Admin access
• Jira Cloud site with admin permissions

#Step 1: Create a Machine Identity

Driver needs a machine identity to search your codebases during ticket analysis.

1. In Driver, go to Settings > Machines.
2. Create a new machine identity (or use an existing one).
3. Grant it access to the sources you want Driver to search when analyzing tickets. The Source member role is adequate for ticket analysis.

#Step 2: Enable Ticket Analysis

Ticket analysis is a Labs feature that must be enabled by an Organization Admin.

1. In Driver, go to Settings > Labs.
2. Find Support Ticket Analysis and toggle it on.

Once enabled, the Issue Tracking section will appear on the Integrations page and Support Tickets will appear in the sidebar.

#Step 3: Open the Jira Cloud Integration Page

1. In Driver, go to Settings > Integrations.
2. Scroll down to the Issue Tracking section.
3. Click Configure next to Jira Cloud.

#Step 4: Install the Driver Forge App in Jira

1. On the Jira Cloud integration page, click Install Jira App. This opens the Atlassian Marketplace installation page in a new tab.
2. Follow the Atlassian prompts to install the Driver app into your Jira Cloud site.
3. Once installation is complete, return to the Driver tab.

#Step 5: Generate a Pairing Code

1. Back on the Jira Cloud integration page in Driver, click Generate Pairing Code.
2. A code will appear (e.g., DRV-XXXX). Click the copy button to copy it to your clipboard.
3. The code is valid for 15 minutes.

#Step 6: Pair the App in Jira

1. In your Jira Cloud site, go to Apps > ... (three dots) > Manage your apps (or navigate to your site's app management page).
2. Find Driver for Jira in the list of installed apps.
3. Click the ... menu next to the app and select Get started. This opens the Driver Setup page.
4. Paste your pairing code into the Pairing Code field.
5. Click Pair with Driver.
6. You should see a green checkmark and the message "Connected to Driver!"

#Step 7: Configure Codebase Access

Return to the Driver tab in your browser. After pairing, the Jira Cloud integration page in Driver will show a Connected state.

1. Under Step 2: Codebase Access, select the machine identity you created earlier from the dropdown.
2. This allows the analysis pipeline to search your codebases when responding to tickets.

#You're Done!

New Jira tickets will now be automatically analyzed by Driver. You can view analyses in the Support Tickets page in the Driver sidebar.

#Optional: Behavior Settings

Once connected, you can fine-tune how Driver interacts with your tickets under the Behavior section on the integration page:

Toggling Webhooks enabled off pauses all ticket processing without disconnecting the integration.