Skip to main content
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
  • A Linear workspace you can grant access to
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 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. 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
  • Create issue: The AI drafts a new Linear issue from the ticket, following your 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: 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.
  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. 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:
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.
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 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

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

No. The AI draft of the title and description costs no message credits.
No. Triggers have no Linear action. Issues are created or linked by a teammate from the ticket’s Linear Issues section.
No. The Create Linear issue dialog has Team, Title, Description, and Priority only. Set anything else in Linear after the issue is created.
No priority. Urgent, High, and Low keep their names, and Normal becomes Medium. You can change it in the dialog before creating the issue.
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.
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.