Guides

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 and a 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.
  2. Find Driver for Jira in the list of installed apps.
  3. Click the ... menu next to the app and select Get started.
  4. Paste your pairing code into the Pairing Code field.
  5. Click Pair with Driver.

You should see a green checkmark and the message "Connected to Driver!"

Step 7: Configure Codebase Access

Return to the Driver tab. 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.

Note: Without a machine identity selected, Driver cannot search codebases and ticket analysis will be limited.

Behavior Settings

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

Setting Description Default
Webhooks enabledMaster switch for processing ticket eventsOn
Post analysis commentsPost Driver's analysis as a comment on the ticketOn
Re-analyze on new commentsTrigger fresh analysis when someone comments on a ticketOn
Respond to @mentionsAnalyze when someone @mentions Driver in a commentOn

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