Integrations
Linear
Create Linear issues from Helpdesk tickets, or link existing ones, and see their status on the ticket
Overview
Connecting Linear lets your team turn a ticket into a Linear issue without leaving QwryAI. QwryAI drafts the issue's title and description from the ticket, you review it, and the issue links back to the ticket. You can also link issues that already exist, and each linked issue shows its current Linear status on the ticket.
Before you start
- A QwryAI account with an AI agent
- A Linear workspace you can grant access to
- Linear isn't available on HIPAA-compliant accounts
Connect Linear
1. Open your AI agent's Integrations
Go to your QwryAI dashboard, select the AI agent, and open the Integrations tab.
2. Connect
Click Connect on the Linear card and grant access to your Linear workspace. When it's connected, the card's button changes to Draft settings.
Create or link an issue from a ticket
Open a ticket on the Tickets page. With Linear connected, its details show a Linear issues section with Create issue and Link issue. Admins and Managers, who can open the Tickets page, can create, link and unlink issues.
Create an issue
- Click Create issue. QwryAI drafts a title and description from the ticket and the most recent part of its conversation. Click Skip to write them yourself.
- Choose the Team and the Priority, and edit the Title and Description. The priority starts from the ticket's priority: Urgent, High, Medium or Low.
- Click Create issue. The issue is created in Linear under your name, the end of its description links back to the ticket, and the ticket is attached to the issue.
QwryAI remembers the last team you picked for this AI agent in your browser.
Link an existing issue
Click Link issue, then type part of an issue's title, an ID such as ENG-123, or paste the issue's URL, and click the result. Issues already linked to the ticket show Linked.
What the ticket shows
- Each linked issue shows its ID, title, status and assignee. The status is read from Linear each time you open the ticket.
- Creating, linking and unlinking an issue each add a line to the ticket's activity, for example "Jane Doe created ENG-123: Checkout button does nothing".
- Unlinking removes only the link on the ticket. The issue, and its link back to the ticket, stay in Linear.
Draft settings
Click Draft settings on the Linear card, or the gear in the Create Linear issue dialog (shown to Admins and Managers), to choose the language of the drafts and the writing instructions QwryAI follows (up to 4,000 characters). Reset to default restores the default sections: Summary, Request, Steps to reproduce, Expected vs actual, Customer impact and Customer details. Saved settings apply to everyone drafting issues for this AI agent.
Disconnect Linear
Open the ••• menu on the Linear card and click Disconnect.
- QwryAI is removed from your Linear workspace, unless another AI agent is still connected to the same Linear workspace. Then it stays until that agent disconnects too.
- The draft settings are reset to the defaults.
- Existing links are kept: the Linear issues section is hidden until you connect Linear again, and then the links come back.
Connecting this AI agent to a different Linear workspace removes QwryAI from the previous one in the same way.
Troubleshooting
Linear access was revoked
QwryAI was removed from your Linear workspace or its access expired. The card shows the message and Reconnect; reconnecting keeps your draft settings.
A linked issue says status unavailable
Linear couldn't be reached, or the ticket has more than 50 linked issues. The ID and title saved when the issue was linked still show.