Integrations: Jira and Linear
Integrations: Jira and Linear
Integrate your support workflow with Jira and Linear to create issues and track them alongside your support tickets.
Overview
Integration buttons appear in the ticket toolbar:
- Jira - Create Jira issues from support tickets
- Jira Service Desk - Create service desk tickets
- Linear - Create Linear issues from support tickets
Prerequisites
Before using integrations, you must:
- Navigate to Settings > Integrations
- Configure Jira or Linear integration
- Set up project/team mappings
- Enable integration for your organization
Jira Integration
Create standard Jira issues:
- Open a support ticket
- Click the Jira button in the toolbar
- Select "Create Jira Issue" from dropdown
- Confirm creation in the dialog
- Issue is created in Jira
- Issue URL opens in a new tab
Jira Service Desk
Create customer-facing service desk tickets:
- Open a support ticket
- Click the Jira button in the toolbar
- Select "Create Service Desk Ticket" from dropdown
- Confirm creation in the dialog
- Ticket is created in Service Desk
- Ticket URL opens in a new tab
Linear Integration
Create Linear issues for tracking:
- Open a support ticket
- Click the Linear button in the toolbar
- Confirm creation in the dialog
- Issue is created in Linear
- Issue URL opens in a new tab
Integration Button States
- Configured - Colored button with integration icon
- Not Configured - Grayed out button with settings hint
- Creating - Loading spinner while creating issue
Jira Configuration Requirements
- Project Key - Jira project identifier (e.g., "PROJ")
- API Token - Jira API authentication
- Base URL - Your Jira instance URL
- Service Desk - Optional service desk configuration
Linear Configuration Requirements
- Default Team ID - Linear team to create issues in
- API Key - Linear API authentication
- Workspace ID - Your Linear workspace
Data Mapped to Issues
When creating an issue, the system maps:
- Subject → Issue Title
- Description → Issue Description
- Conversation → Linked in description
- Attachments → Added as issue attachments
Issue Creation Feedback
- Toast notification confirms success
- Issue key displayed (e.g., "PROJ-123")
- Issue URL opens automatically
- Support ticket remains open for follow-up
Best Practices
- Create issues for bugs that need tracking
- Use Linear for feature requests
- Use Service Desk for customer-facing requests
- Include relevant attachments when creating issues
- Link issues back to support tickets for context