Conecte o Jira e vincule issues a tickets

Conecte seu site do Jira

Você precisa da permissão Gerenciar integrações, que os administradores têm.

1. Abra Configurações > Integrações > Jira e clique em Conectar Jira.
2. Entre na Atlassian, escolha seu site na tela da Atlassian e aceite.
3. Se sua conta Atlassian alcança mais de um site do Jira, o Deskwoot mostra Escolha seu site do Jira. Clique em Usar este site ao lado do site que sua equipe usa.
4. Em Padrões para novas issues, escolha um Projeto, um Tipo de issue e, se quiser, um Componente, e clique em Salvar. Os agentes podem escolher outra coisa em cada issue.

Conecte sua própria conta Atlassian

Uma issue criada no Deskwoot nasce na conta Atlassian do agente que a cria, então leva o nome dele no Jira e segue as permissões dele no Jira. Cada agente conecta a conta uma vez em Configurações > Perfil > Contas conectadas com Conectar conta Atlassian, ou direto na janela da primeira vez que cria uma issue. Quem conectou o site para o workspace não precisa de uma segunda conexão. Ver e vincular issues funciona sem ela.

Vincule uma issue existente

1. Abra o ticket. A seção Issues vinculadas fica na aba Detalhes do ticket, à direita.
2. Clique em Vincular issue e busque pela chave da issue, como TAB-123, ou por palavras do título.
3. Escolha a issue. O Deskwoot escreve uma linha no ticket, e a issue ganha um link de volta para o ticket no Jira.

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 e confirme. O link de volta para o ticket também é removido no Jira.

Crie uma issue nova

1. Em Issues vinculadas, clique em Criar issue. 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 título, do resumo, do contexto e dos comentários do ticket. O Copilot não recebe o nome do cliente e é orientado a deixar dados pessoais de fora, e o rascunho conta como uso do Copilot, como os outros rascunhos do Copilot.
3. Confira Projeto, Tipo de issue e Componente e clique em Criar issue.

O texto é copiado para o Jira e sai do Deskwoot. Se você excluir ou exportar os dados de um cliente no Deskwoot, a cópia no Jira não entra, então deixe de fora dados pessoais de que os desenvolvedores não precisam.

Acompanhe o status no Deskwoot

O Jira 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. Issues vinculadas mostra a chave, o status e o título completo de cada issue. Na lista de tickets, a linha do ticket mostra a chave da issue com um ponto na cor do status (cinza para A fazer, azul para Em andamento, verde para Concluída), e ao apontar para ela você vê o nome do status. Busque uma chave de issue na lista de tickets para achar todos os tickets vinculados a ela. Uma issue excluída no Jira mostra Excluída no Jira.

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 Jira. As condições Mudança na issue, Categoria do status da issue (A fazer, Em andamento, Concluída), Categoria anterior do status da issue e Status da issue (o nome do status no Jira) escolhem as mudanças em que ela age. Essas regras nunca rodam em tickets resolvidos. Mais sobre regras em Criar regras de automação.

O cartão Regras na página do Jira 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.

Desconecte ou reconecte

Quando a Atlassian não aceita mais a conexão, por exemplo porque o acesso foi removido ou ela ficou 90 dias sem uso, a página do Jira mostra O Jira 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 remove as conexões Atlassian dos próprios agentes. O Deskwoot mantém os vínculos, mas não os mostra nos tickets enquanto o Jira não estiver conectado. Quando o Jira for conectado de novo, as issues voltam a aparecer com o último status conhecido. Enquanto isso, um token de API ou um token MCP ainda pode lê-las.

Perguntas frequentes

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 Jira está conectado. Conversas com clientes não têm issues vinculadas.

Por que o Deskwoot pede para eu conectar a minha conta Atlassian?

Uma issue que você cria nasce na sua própria conta Atlassian e leva o seu nome no Jira. Você conecta a conta uma vez. Ver e vincular issues funciona sem ela.

O cliente vê a issue do Jira?

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.

O Deskwoot pode colocar uma issue no topo do backlog do Jira?

Não. A ordem do backlog pertence ao seu quadro no Jira, então ordene as issues lá ou com a automação do próprio Jira.

A API ou uma conexão MCP podem trabalhar com issues do Jira?

Um token de API ou um token MCP pode ler as issues de um ticket, vincular issues existentes e desvinculá-las. Uma issue nova precisa da conta Atlassian de uma pessoa, então só membros criam issues, a partir do ticket.