Linear

Linear is an issue tracker used by product and engineering teams. Connecting Linear to Resool lets support agents escalate a customer's bug report or feature request as a Linear issue straight from the conversation, in the right team and with a priority, and then see the issue's status from the contact's panel. Workflows can create Linear issues automatically.

#What you can do with Linear

In the Inbox

• Create issue in a Linear team, with a priority and a description.
• See the Linear issues created for the contact with their identifier (for example ENG-142) and status, and open them with View in Linear.

On the contact page

• The Connected apps list shows how many Linear issues the contact has and how many are still open.

In Workflows

• The Create Linear issue step creates an issue in a team with a priority, a title and a description.

Every issue Resool creates includes the contact's name, email and phone and a link to the conversation, so engineers can read the original report.

#Before you begin

• You need a Linear account that is a member of the teams you want to create issues in.
• In Resool, only workspace Owners and Admins can connect apps and change their settings.
• Creating issues from the inbox needs a role that can manage contacts (Owner, Admin, Manager and Agent can by default).

#How to connect Linear to Resool

1. Go to Settings › Apps.
2. Open the Productivity tab and click Connect on the Linear card.
3. The Connect Linear dialog lists what Resool will be able to do: see your teams, create issues, and see the status of the issues created from Resool. Click Continue.

Screenshot placeholder

Settings › Apps › Linear › Connect

The "Connect Linear" dialog with its description, the permission list with three items, and the Cancel and Continue buttons.

File: screenshots/linear-connect-dialog.png

1. Sign in to Linear in the window that opens and authorize Resool.
2. You're returned to Resool and see Linear connected.

#How to configure Linear

Click Manage on the Linear card to open Linear settings. Under Defaults, pick the Team new issues go to. Create issue in the inbox and workflow steps that pick no team use it. Click Save changes to store it.

Screenshot placeholder

Settings › Apps › Linear › Manage

The "Linear settings" side sheet with the Defaults card, its hint text and the Team picker set to "Engineering".

File: screenshots/linear-settings-sheet.png

#How to create a Linear issue from a conversation

1. Open a conversation in the Inbox.
2. Click the Linear icon in the right-hand sidebar.
3. Click Create issue. The New Linear issue form opens with the default team filled in.
4. Check the Team (required) and choose a Priority, or leave No priority.
5. Enter the Title and an optional Description, for example the steps the customer described.
6. Click Create. You see Created in Linear.

Screenshot placeholder

Inbox › open a conversation › Linear icon in the right sidebar

The Linear panel with two issues for the contact, each with its identifier (ENG-142, ENG-157), creation date and a status badge ("In Progress", "Done" with a check mark), and the Create issue and View in Linear buttons.

File: screenshots/linear-inbox-panel.png

When engineering closes the issue, it shows as done in the panel the next time you open it, so you know when to follow up with the customer.

#How to create Linear issues in Workflows

1. Open a workflow and click Add a step.
2. Under Tasks & docs, choose Create Linear issue.
3. Set up the step:
   • Team: leave it on Default or pick another.
   • Priority: Default (the team's default), Urgent, High, Medium, Low or No priority.
   • Title and Description: both accept variables such as {{contact.name}}.
4. Save and publish the workflow.

Screenshot placeholder

Workflows › open a workflow › Add a step › Tasks & docs › Create Linear issue

The step settings with Team on Default, Priority set to High, Title "Bug report from {{contact.name}}" and a Description.

File: screenshots/linear-workflow-step.png

#How to disconnect Linear

1. Go to Settings › Apps and click Disconnect on the Linear card.
2. Confirm in the Disconnect Linear? dialog.

Resool stops accessing your Linear workspace. Issues already created stay in Linear.

#FAQ and troubleshooting

#Can I assign the issue or add labels from Resool?

No. Resool sets the team, priority, title and description. Triage the issue in Linear.

#Does the customer see the Linear issue?

No. The issue is internal. Only your team sees it, in Linear and in the Resool panel.

#A team is missing from the Team picker. Why?

The Linear user who connected must be a member of the team. Reconnect with an account that has access if needed.

#Which plans include Linear?

Apps are included on every plan. See Plans and billing.

#What's next?

• Getting started with apps
• Workflow steps
• Jira
• GitHub