Linear: crie, vincule e acompanhe issues a partir dos seus tickets

Conecte seu workspace do Linear

No Deskwoot, você precisa da permissão Gerenciar integrações, que os administradores têm. No Linear, você precisa ser admin do workspace, porque o Deskwoot entra nele como um app.

1. Abra Configurações > Integrações > Linear e clique em Conectar Linear.
2. Entre no Linear e permita o Deskwoot na tela do Linear.
3. De volta ao Deskwoot, Equipes que o Deskwoot vê lista as equipes do Linear que o app pode ver. Escolha a Equipe para novas issues e clique em Salvar. Os agentes podem escolher outra equipe em cada issue.

O Deskwoot vê apenas as equipes do Linear às quais você der acesso ao app do Deskwoot. Você pode mudar isso no Linear a qualquer momento e depois recarregar a página do Linear no Deskwoot.

Vincule uma issue existente

1. Abra o ticket. A seção Issues vinculadas fica nos detalhes do ticket, à direita.
2. Clique em Vincular issue e busque pela chave da issue, como ENG-123, ou por palavras do título. Se o Jira também estiver conectado, escolha primeiro Linear no topo da janela.
3. Escolha a issue. O Deskwoot escreve uma linha no ticket, e a issue ganha um link de volta para o ticket no Linear.

Um ticket pode ter várias issues, e uma issue pode estar vinculada a muitos tickets, por exemplo quando muitos clientes relatam o mesmo bug. Para remover um vínculo, clique no x ao lado da issue. O link de volta no Linear também sai.

Crie uma issue nova

1. Em Issues vinculadas, clique em Criar issue. Se o Jira também estiver conectado, escolha Linear no topo da janela. O título e a descrição começam com o título e o resumo do ticket.
2. Clique em Rascunhar relatório de bug com o Copilot para o Copilot escrever um relatório para os desenvolvedores a partir do resumo, do contexto e dos comentários do ticket. O Copilot recebe a instrução de deixar de fora o nome e os dados de contato do cliente, então confira o rascunho antes de criar a issue. O rascunho conta como uso do Copilot, como os outros rascunhos do Copilot.
3. Confira a Equipe e clique em Criar issue.

O Linear mostra a issue como escrita por você pelo Deskwoot, com um link de volta para o ticket. O texto que você envia sai do Deskwoot, e as solicitações de dados no Deskwoot não chegam a ele no Linear. Remova dados pessoais de que os desenvolvedores não precisam.

Acompanhe o status no Deskwoot

O Linear avisa o Deskwoot de cada mudança de status, e uma verificação a cada hora pega o que tiver passado. Cada status novo escreve uma linha em cada ticket vinculado à issue, e a lista de tickets mostra a chave e o status da issue no ticket. Busque uma chave de issue na lista de tickets para achar todos os tickets vinculados a ela. Quando uma issue passa para outra equipe no Linear, a chave muda e o Deskwoot mostra a nova. Uma issue excluída no Linear mostra Excluída no Linear ou Não encontrada no Linear.

Encontre bugs conhecidos com o Copilot

Quando um cliente relata um problema, ou você pergunta ao Copilot sobre um bug conhecido na aba Copilot da conversa, o Copilot pesquisa também no Linear. Ele lê as issues abertas da equipe escolhida em Equipe para novas issues e das equipes vinculadas aos seus tickets, nunca o workspace inteiro do Linear, e as issues já vinculadas aos tickets desta conversa, em qualquer status.

• O Copilot lê até 3 issues do Linear: primeiro as vinculadas ao caso, depois issues abertas cujo título tem palavras suficientes em comum com o problema.
• A resposta cita as issues que correspondem, com chave, título e status, e cada uma tem um link para o Linear. A linha Consultou acima da resposta cita o Linear quando ele foi pesquisado.
• O Copilot só cita uma data prevista de correção quando a issue tem uma que ainda está por vir: a data prevista de um release do Linear, a data de vencimento da issue ou um comentário da sua equipe. Ele lê até 3 comentários escritos por uma pessoa da sua equipe, nunca comentários de bots, convidados ou pessoas de fora da equipe.
• Numa resposta para o cliente, o Copilot é instruído a chamar o problema de conhecido só quando uma issue o descreve e a deixar de fora as chaves das issues e o nome Linear.

Quando o Copilot não consegue pesquisar o Linear, por exemplo porque a conexão precisa de um novo login, uma linha abaixo da resposta avisa. Nesse caso, o Copilot é instruído a nunca dizer que não existe um bug conhecido.

Deixe regras levarem os tickets adiante

Em Configurações > Automação, uma regra com o evento Issue vinculada alterada roda quando uma issue é criada a partir de um ticket, vinculada a ele, desvinculada dele ou muda de status no Linear. As condições Mudança na issue, Categoria do status da issue (A fazer, Em andamento, Concluída) e Status da issue (o nome do status no Linear) escolhem as mudanças em que ela age. Uma issue cancelada ou duplicada conta como Concluída, então use Status da issue quando uma regra precisar diferenciá-la de uma issue terminada. Essas regras nunca rodam em tickets resolvidos.

O cartão Regras na página do Linear nas configurações abre 2 regras prontas para você conferir e salvar:

• Issue criada ou vinculada: definir um status do ticket, por exemplo um status de ticket seu que pausa o SLA enquanto o desenvolvimento trabalha nela.
• Issue concluída: devolver o ticket com uma nota: define um status do ticket, atribui o ticket a quem vinculou a issue e adiciona uma nota que avisa essa pessoa, para que ela informe o cliente.

Se o Jira também estiver conectado, as mesmas regras rodam para issues dos dois.

Desconecte ou reconecte

Quando o Linear não aceita mais a conexão, por exemplo porque o app do Deskwoot foi removido no Linear, a página do Linear mostra O Linear precisa de um novo login. Clique em Reconectar para manter as issues sincronizadas. Desconectar encerra a criação e o vínculo de issues, e o Deskwoot pede ao Linear que encerre o acesso do app. O Deskwoot mantém os vínculos. Enquanto nenhum rastreador de issues estiver conectado, os tickets não os mostram. Quando o Linear for conectado de novo, as issues voltam a aparecer com o último status conhecido. Enquanto isso, um token de API ou um agente de IA por MCP ainda pode lê-las.

Perguntas frequentes

Meus agentes precisam de conta no Linear?

Não. O Deskwoot entra no seu workspace do Linear como um app, então os agentes vinculam e criam issues sem conta no Linear, e o Linear mostra o nome do agente que criou a issue.

Por que não vejo Issues vinculadas em um ticket?

A seção aparece só em tickets, enquanto os tickets estão ativados e o Linear ou o Jira está conectado. Conversas com clientes não têm issues vinculadas.

O cliente vê a issue do Linear?

Não. Tickets são o trabalho interno da sua equipe, então a issue e as linhas de status ficam com a sua equipe.

Posso usar o Linear e o Jira juntos?

Sim. Conecte os dois, e Vincular issue e Criar issue deixam você escolher Jira ou Linear no topo da janela. Um ticket pode ter issues dos dois.

A API ou um agente de IA podem trabalhar com issues do Linear?

Um token de API ou um token MCP pode ler as issues de um ticket, vincular issues existentes e desvinculá-las. Colegas de IA só as leem. Uma issue nova leva o nome da pessoa que a cria, então só membros criam issues, a partir do ticket.

Por que o Copilot não encontra uma issue do Linear que eu conheço?

O Copilot pesquisa só issues abertas da equipe para novas issues e das equipes vinculadas aos seus tickets, e só encontra issues cujo título tem palavras suficientes em comum com o problema do cliente. Vincule a issue ao ticket, e o Copilot a lê em qualquer status.