Jira Integration

Create Jira tickets directly from feedback.

Requirements

• Jira Cloud account
• API token from Atlassian
• Project admin access

Setup

Step 1: Create API Token

1. Go to Atlassian API Tokens
2. Click Create API token
3. Name it "Annot8"
4. Copy the token

Step 2: Connect to Annot8

1. Go to Integrations in Annot8
2. Click Jira
3. Enter:
   • API Token - From step 1
   • Domain - e.g., yourcompany.atlassian.net
   • Project Key - e.g., PROJ
   • Your Email - Atlassian account email
4. Click Connect

Ticket Creation

When feedback is received:

Summary: [Feedback] The checkout button is hard to find
Description:
  From: John Doe
  
  The checkout button is hard to find on mobile devices.
  I had to scroll to find it.
  
  ---
  View on page: https://example.com/cart

Configuration

Issue Type

Set the default issue type:

• Task (default)
• Bug
• Story
• Custom type

Components

Auto-assign components based on project or page URL.

Custom Fields

Map Annot8 data to Jira custom fields:

Best Practices

1. Use a dedicated project - Or component for feedback
2. Set up automation - Auto-assign, auto-label
3. Create JQL filters - Find feedback tickets easily
4. Link related issues - Connect feedback to existing work