> ## 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.

# Create Linear issues from Helpdesk tickets

> Connect Linear so your team can create Linear issues from Helpdesk tickets

The Chatbase Linear integration turns Chatbase 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 title and description from the ticket, so your support team doesn't have to rewrite it by hand. Drafts cost no message credits.

## 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 the Chatbase Helpdesk, which is available on the Basic plan or higher. 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**.

Each AI agent connects to one Linear workspace through its own sign-in. Connecting again replaces the workspace. The same Linear workspace can be connected to several AI agents.

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 ticket 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 dialog has four fields: **Team**, **Title**, **Description**, and **Priority**. You can't set an assignee, labels, project, or state from Chatbase. Set those in Linear after the issue is created. Chatbase remembers the last team you picked for this AI agent in your browser.

The priority starts from the ticket's own priority:

| Chatbase ticket priority | Linear priority |
| - | - |
| No priority | No priority |
| Urgent | Urgent |
| High | High |
| Normal | Medium |
| Low | Low |

The issue is created in Linear under your name. As the dialog says, "A link to this ticket is added at the end." Chatbase adds a line to the end of the description, `Chatbase ticket #<number>: <link>`, and attaches a `Chatbase ticket #<number>` 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. The options are the same languages offered for [Helpdesk translation](https://chatbase.co/docs/user-guides/chatbot/help-desk/translation.md#supported-languages). Chatbase tells the AI to write the draft in this language.
* **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.

These are the default writing instructions, word for word. Copy them as a starting point if you want to add a section or change the tone:

```
Write the description in Markdown with these sections:

## Summary
One or two sentences on what the customer needs.

## Request
What the customer asked for or reported, with any context the ticket gives.

## Steps to reproduce
Only when the ticket reports something broken. Numbered steps, only if the ticket describes any. Leave this section out otherwise.

## Expected vs actual
Only when the ticket reports something broken. What the customer expected to happen and what happened instead. Leave this section out otherwise.

## 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, so the team can find them.
```

Click **Save** to apply your changes. The settings apply to everyone drafting issues for this AI agent.

### What the draft reads

The AI builds the draft from:

* **Ticket fields:** subject, priority, tags, the customer's name, email, and phone, and every custom field value. Image fields are passed as the file name.
* **The first customer message.**
* **The AI agent conversation:** up to the last 10 messages before the handoff to the Helpdesk.
* **The ticket thread:** the newest 50 replies and internal notes. System messages are left out.

Attachments are passed as file names only, so the AI can't read what's inside a screenshot or PDF. Each message is cut at 2,000 characters, and the whole input at 20,000 characters, keeping the newest messages. On long tickets, check the draft for details it missed.

> [!WARNING]
>
> Internal notes are included in the draft. Remove anything from the description that shouldn't be in Linear before you click **Create issue**.

## 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.

## Limitations

* Issues are created by hand from a ticket. A [Trigger](https://chatbase.co/docs/user-guides/chatbot/help-desk/triggers.md) can't create a Linear issue.
* The dialog sets team, title, description, and priority only.
* Changes in Linear don't update the ticket.
* Linear is not available on HIPAA-compliant accounts.

## 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.

## Frequently asked questions

> [accordion] Does drafting a Linear issue use message credits?
>
> No. The AI draft of the title and description costs no message credits.

> [accordion] Can a trigger create a Linear issue automatically?
>
> No. Triggers have no Linear action. Issues are created or linked by a teammate from the ticket's **Linear Issues** section.

> [accordion] Can I set the assignee, labels, or project from Chatbase?
>
> No. The **Create Linear issue** dialog has **Team**, **Title**, **Description**, and **Priority** only. Set anything else in Linear after the issue is created.

> [accordion] What Linear priority does a ticket with no priority get?
>
> **No priority**. Urgent, High, and Low keep their names, and Normal becomes **Medium**. You can change it in the dialog before creating the issue.

> [accordion] Does the draft include internal notes and attachments?
>
> Internal notes, yes: the newest 50 replies and notes on the ticket are read. Attachments are passed by file name only, so their contents aren't read.

> [accordion] Can one Linear workspace connect to several AI agents?
>
> Yes. Each AI agent connects separately and stores its own connection, and nothing stops several agents from using the same Linear workspace. Each AI agent connects to only one workspace at a time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.