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.
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.
- 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.
Create an issue
- Click Create issue. Chatbase reads the ticket and drafts a title and description. Click Skip to write it yourself instead.
- Choose a Team and a Priority, and edit the Title and Description.
- Click Create issue.
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
- Click Link issue.
- Type part of the title, an issue ID like
ENG-123, or paste the issue’s Linear URL. - Click the issue in the results.
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 exampleJane 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.
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.
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
Linear access was revoked
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.
Frequently asked questions
Does drafting a Linear issue use message credits?
Does drafting a Linear issue use message credits?
No. The AI draft of the title and description costs no message credits.
Can a trigger create a Linear issue automatically?
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.
Can I set the assignee, labels, or project from Chatbase?
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.
What Linear priority does a ticket with no priority get?
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.
Does the draft include internal notes and attachments?
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.
Can one Linear workspace connect to several AI agents?
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.