> ## Documentation Index > Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt > Use this file to discover all available pages before exploring further. # Linear > Connect Linear so your team can create Linear issues from Helpdesk tickets ## Overview Connect Linear to turn Helpdesk tickets into Linear issues. When a ticket needs work from another team, such as a bug report or a feature request, the AI drafts the issue from the ticket for you, so your team doesn't have to rewrite it by hand. ## Before you start * A Chatbase AI agent with the [Helpdesk](https://chatbase.co/docs/user-guides/chatbot/help-desk/help-desk-overview.md) * A Linear workspace you can grant access to > [!NOTE] > > Linear needs a plan that includes the Helpdesk. It is not available on HIPAA-compliant accounts: the **Connect** button stays disabled there. ## Connect Linear **1. Open Integrations** Go to your [Chatbase dashboard](https://www.chatbase.co/dashboard/) and select your AI agent. Click **Integrations** in the sidebar. **2. Grant access to Linear** Click **Connect** on the **Linear** card, then grant Chatbase access to your Linear workspace. Once connected, the button on the Linear card changes to **Draft settings**. Connecting a Linear workspace requires permission to manage integrations. Linear opens in a popup. If nothing opens, your browser blocked it: allow popups for Chatbase and click **Connect** again. Only the person who started the connection can finish it. ## Create or link an issue from a ticket Open a ticket in the Helpdesk and find the **Linear Issues** section in the ticket's **Details** panel. ![Linear Issues section in the ticket details panel, with Create issue and Link issue buttons](https://mintcdn.com/chatbase/8kKC8QjeCXY0UDFD/user-guides/images/help-desk/linear/linear-issues.png?fit=max\&auto=format\&n=8kKC8QjeCXY0UDFD\&q=85\&s=316de705fe50a27c87a314b3a72e9e93) * **Create issue**: The AI drafts a new Linear issue from the ticket, following your [draft settings](#draft-settings). * **Link issue**: Link the ticket to an issue that already exists in Linear. Linked issues are listed in the section. If none are linked yet, it shows **No linked issues**. Creating, linking, and unlinking require permission to work on tickets. Anyone with Helpdesk access can see the linked issues. ### Create an issue 1. Click **Create issue**. Chatbase reads the conversation and drafts a title and description. Click **Skip** to write it yourself instead. 2. Choose a **Team** and a **Priority**, and edit the **Title** and **Description**. 3. Click **Create issue**. The priority starts from the ticket's own priority: urgent, high, normal, and low map to Urgent, High, Medium, and Low in Linear. Chatbase remembers the last team you picked for this AI agent in your browser. The issue is created in Linear under your name. Chatbase adds a line to the end of the description, `Chatbase ticket #: `, and attaches a `Chatbase ticket #` link to the issue so your engineers can get back to the ticket. If the issue is created but can't be linked to the ticket, you see a message saying so. Use **Link issue** to attach it rather than creating it again, or you'll end up with a duplicate in Linear. ### Link an existing issue 1. Click **Link issue**. 2. Type part of the title, an issue ID like `ENG-123`, or paste the issue's Linear URL. 3. Click the issue in the results. There is no confirm button: clicking a result links it. Search shows the top 10 matches, so narrow the search if you don't see the issue. Issues already on the ticket are marked **Linked**, and you can't link the same issue twice. ### Linked issues on the ticket Each linked issue shows its ID, title, status, and assignee. The status is read from Linear each time you open the ticket. Changes in Linear don't post anything to the ticket or change its status. When you create, link, or unlink an issue, Chatbase adds a system note to the ticket thread, for example `Jane Doe created ENG-123: Checkout button does nothing`. To remove an issue, click the **Unlink** icon on its row. This only removes the link in Chatbase. The issue and its link back to the ticket stay in Linear. ## Draft settings Draft settings control how the AI writes a Linear issue from a ticket. Click **Draft settings** on the Linear card to change them. You can also open them from the gear icon in the **Create Linear issue** dialog. * **Language**: The language the issue is written in. The default is English. * **Writing instructions**: How the AI should write the issue description, up to 4,000 characters. Click **Reset to default** to go back to the default instructions. By default, the description is written in Markdown with these sections: | Section | What it contains | | - | - | | **Summary** | One or two sentences on what the customer needs | | **Request** | What the customer asked for or reported, with any context from the ticket | | **Steps to reproduce** | Numbered steps, only when the ticket reports something broken and describes them | | **Expected vs actual** | Only when the ticket reports something broken | | **Customer impact** | Who is affected and how badly, based only on the ticket | | **Customer details** | The customer's name, email, phone, and any account or order identifiers they gave | Click **Save** to apply your changes. The settings apply to everyone drafting issues for this AI agent. The draft reads the most recent part of the conversation, not the whole history, so check long tickets for details it missed. ## Disconnect Linear To disconnect, click the **•••** menu on the Linear card. Links made before you disconnect are kept. The **Linear Issues** section is hidden until you connect Linear again, and then the links come back. ## Troubleshooting > [accordion] Linear access was revoked > > If someone removes the Chatbase app in Linear or its access expires, the card shows **Linear access was revoked** and a **Reconnect** button. Click it and approve access again. Your draft settings are kept. > [accordion] A linked issue says status unavailable > > Chatbase couldn't reach Linear, or the ticket has more than 50 linked issues. The issue still shows the title and details saved when it was linked. Open the ticket again later for the current status. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.