Automatize o rastreamento de bugs no Linear com os bugs que o Flowsery encontra em sessões reais

Quase todo rastreamento de bugs no Linear começa com uma pessoa. Alguém esbarra num checkout quebrado, descreve de memória, chuta os passos e cola um print numa issue nova. O Flowsery começa antes. A IA do Flowsery assiste às suas gravações de sessão, encontra os rage clicks, botões mortos e formulários quebrados com que visitantes reais toparam, e registra cada caso no Linear com a gravação anexada, muitas vezes antes que alguém da equipe perceba.

O Flowsery está no diretório de integrações do Linear na categoria Bug Reporting. Nós desenvolvemos o Flowsery, e cada nome de botão abaixo corresponde ao cartão do Linear nas configurações de um site.

A versão curta: no Flowsery, abra Configurações do site > Integrações, clique em Conectar no cartão do Linear e aprove o acesso no Linear. Depois clique em Criar ticket em qualquer problema, ou ative Tickets automáticos, escolha uma equipe do Linear e uma severidade mínima, e deixe o Flowsery registrar os bugs novos para você.

O que a integração do Flowsery com o Linear faz?

A integração do Flowsery com o Linear transforma os problemas que a IA do Flowsery encontra nas gravações de sessão em issues do Linear, e os resolve no Flowsery quando são fechados no Linear. Ela funciona de três jeitos:

• Criar ticket. Você abre um problema do Flowsery, escolhe uma equipe do Linear e cria a issue.
• Tickets automáticos. O Flowsery registra cada problema novo a partir de uma severidade mínima numa equipe do Linear, sem que ninguém abra o Flowsery.
• Sincronização de volta. Quando uma issue do Linear criada pelo Flowsery é concluída ou cancelada, o Flowsery marca o próprio problema como resolvido.

O Flowsery agrupa todas as sessões afetadas pela mesma falha num único problema, então um bug que atingiu 38 sessões vira uma issue do Linear com a contagem de sessões, não 38 issues. É esse agrupamento que torna o registro automático seguro para um backlog de verdade. A página de tickets de bugs automáticos mostra como a lista de problemas e os tickets se encaixam.

Registrar um bug no Linear à mão e com o Flowsery

À mão

• Alguém esbarra num checkout quebrado
• Descreve de memória
• Chuta os passos
• Cola um print numa issue nova

Com o Flowsery

• A IA encontra rage clicks, botões mortos e formulários quebrados nas gravações
• As sessões afetadas pela mesma falha são agrupadas num único problema
• A issue do Linear leva a severidade, o número de sessões e o vídeo da gravação
• Muitas vezes ela é registrada antes de alguém da equipe perceber

Do que você precisa antes de conectar o Linear?

Você precisa de um site no Flowsery com a gravação de sessões ativada, da função Admin ou Editor no workspace do Flowsery e de uma conta do Linear no workspace onde quer registrar as issues. O Flowsery encontra problemas em sessões gravadas, então um site sem gravação de sessões não tem nada para enviar.

Qualquer membro do Linear pode aprovar a conexão. Você não precisa ser administrador do Linear. Membros do Flowsery com outras funções veem a conexão, mas não podem alterá-la.

Todos os planos do Flowsery incluem a integração com o Linear. Ou seja, Team por $250 por mês e Pro por $500 por mês, e os dois começam com um teste grátis de 14 dias sem cartão de crédito.

Como conectar o Linear ao Flowsery?

Você conecta o Linear ao Flowsery pela aba Integrações do site, e a tela de aprovação do próprio Linear faz o resto.

1. No Flowsery, abra o site e vá em Configurações do site > Integrações.
2. No cartão Linear, clique em Conectar.
3. Clique em Conectar com o Linear. O Flowsery leva você ao Linear.
4. Escolha o workspace do Linear e aprove o acesso. O Flowsery pede acesso de leitura para listar suas equipes e acesso de escrita para criar issues e enviar as gravações.
5. O Linear traz você de volta ao Flowsery, e o cartão mostra Conectado com o nome do seu workspace do Linear.

A conexão pertence ao site, não a você nem ao workspace. Se você acompanha três sites no Flowsery e quer que todos registrem no Linear, conecte cada um. Todas as opções também estão na página de documentação da integração com o Linear.

Como criar uma issue do Linear a partir de um bug do Flowsery?

Você cria uma issue do Linear a partir de um bug do Flowsery clicando em Criar ticket no problema, escolhendo Linear e uma equipe, e clicando em Criar.

1. Abra um problema no Flowsery e clique em Criar ticket.
2. Escolha Linear como tracker e depois a Equipe.
3. Confira o título, a descrição e os passos para reproduzir, que o Flowsery preenche para você, e clique em Criar.

A issue do Linear traz tudo o que um engenheiro pergunta nos primeiros cinco minutos:

Campo na issue do Linear	De onde vem
Título e descrição	O problema do Flowsery, editável antes de criar
Severidade	Baixa, Média, Alta ou Crítica, conforme a nota do Flowsery
Sessões afetadas	Quantas sessões gravadas passaram pelo problema
Primeira e última ocorrência	Quando o Flowsery viu o problema pela primeira e última vez
Links	O problema no Flowsery e a gravação da sessão
Anexo	O próprio vídeo da gravação

O vídeo anexado é a parte de que eu não abriria mão. Um engenheiro vê o visitante tocar no botão três vezes sem sair do Linear, e isso encerra quase toda discussão de "não consigo reproduzir" antes de ela começar. Nosso guia sobre passos para reproduzir explica por que essa lista decide se um bug é corrigido ou não.

Como ativar tickets de bugs automáticos no Linear?

Você ativa os tickets de bugs automáticos ligando Tickets automáticos no cartão do Linear e escolhendo uma equipe do Linear e uma severidade mínima. Os controles aparecem assim que o Linear está conectado.

1. No cartão Linear, ative Tickets automáticos.
2. Escolha a Equipe do Linear que deve receber as issues.
3. Escolha uma Severidade mínima.

A partir daí, cada problema novo que o Flowsery detecta com essa severidade ou acima vira uma issue do Linear nessa equipe, com os mesmos campos de um ticket manual. Cada problema é registrado uma única vez, e o problema do Flowsery guarda um link para o ticket do Linear.

Os tickets automáticos vão para um único tracker por site. Ativá-los para o Linear desativa para o Jira ou o Notion no mesmo site. Se a chave estiver ligada sem equipe escolhida, o cartão diz Escolha um destino para ativar. e nada é registrado até você escolher uma.

Qual severidade mínima você deve escolher?

Escolha Alta ou superior para uma equipe do Linear cheia de trabalho e Baixa ou superior para uma equipe pequena que quer ver tudo. A severidade mínima é o único filtro entre a lista de problemas do Flowsery e o seu backlog do Linear, então ela decide quanto barulho a integração faz.

Severidade mínima	O que chega ao Linear
Baixa ou superior	Todo problema novo que o Flowsery detecta
Média ou superior	Problemas de severidade Média, Alta e Crítica
Alta ou superior	Problemas de severidade Alta e Crítica
Apenas crítica	Só os problemas que o Flowsery classifica Crítica

Os problemas abaixo do limite ficam no Flowsery, e você ainda pode mandar qualquer um deles para o Linear com Criar ticket. Meu conselho é começar um nível mais rígido do que você acha que precisa. Afrouxar o filtro depois de uma semana tranquila é fácil. Tirar 40 problemas de severidade Média de um quadro de sprint, não.

O que acontece no Flowsery quando você fecha a issue do Linear?

O Flowsery marca o problema como resolvido quando a issue do Linear que ele criou passa para um estado concluído ou cancelado. O Linear avisa o Flowsery sozinho, então não há webhook para configurar.

Algumas regras evitam que a sincronização brigue com o seu fluxo de trabalho:

• Só mudam os problemas do Flowsery que ainda estão abertos ou em andamento. Um problema que você já resolveu ou suspendeu no Flowsery fica como está.
• Só contam as issues que o Flowsery criou no Linear. Uma issue do Linear escrita à mão não mexe no Flowsery.
• Editar uma issue já concluída no Linear não faz nada.

O efeito é que a lista de problemas do Flowsery acompanha o que a engenharia entregou, e ninguém precisa fechar o mesmo bug duas vezes. Se o bug voltar depois da correção, o Flowsery o vê em gravações novas, e isso é um sinal de regressão melhor do que esperar um e-mail no suporte.

Como manter falsos positivos fora do seu backlog do Linear?

Marque um falso positivo como Não é um problema no Flowsery, e o Flowsery o suspende e adiciona uma regra que ignora relatos parecidos. O mesmo padrão não volta mais como ticket ou alerta novo.

Dois outros hábitos mantêm o backlog limpo. O filtro de severidade visto acima deixa os problemas de severidade Baixa fora do Linear até você pedir. E o agrupamento faz um bug recorrente atualizar um único problema do Flowsery com mais sessões, em vez de registrar um ticket novo a cada ocorrência. Se a sua equipe já faz uma triagem de bugs semanal, os problemas do Flowsery chegam já ordenados por severidade e número de sessões, e a reunião fica mais curta.

O que fazer se o cartão do Linear disser "Reconectar"?

O cartão do Linear diz Reconectar quando o Flowsery perdeu o acesso ao workspace do Linear, geralmente porque alguém removeu o app no Linear. Clique em Reconectar e aprove o acesso de novo. Suas configurações de tickets automáticos continuam como estavam.

Outros três casos aparecem:

• A lista de equipes está vazia. A conta do Linear que aprovou a conexão não está em nenhuma equipe. Peça a um administrador do Linear para adicioná-la a uma, ou reconecte com uma conta que esteja.
• O cartão diz que o site está conectado com uma chave de API. O site foi conectado antes de o Flowsery suportar OAuth. Ele continua funcionando. Para mudar, clique em Gerenciar, depois em Mudar para OAuth, e aprove o acesso no Linear. Depois você pode apagar a chave antiga no Linear.
• Você quer parar. Clique em Gerenciar e depois em Desconectar. O Flowsery revoga o próprio acesso no Linear e para de criar tickets para esse site, inclusive os automáticos. As issues que já estão no Linear ficam lá.

Quando usar Jira, Notion, Slack ou n8n em vez do Linear?

Use a integração com o Linear quando seus engenheiros planejam o trabalho no Linear. Os outros caminhos do Flowsery atendem equipes que trabalham em outro lugar.

• Jira ou Notion. O Flowsery registra tickets num projeto do Jira ou num banco de dados do Notion do mesmo jeito, com Criar ticket e Tickets automáticos. Um site manda os tickets automáticos para um único tracker.
• Slack. Todo problema do Flowsery tem Enviar ao Slack, e o fluxo do Slack ao pull request deixa você marcar @flowsery na thread para abrir um rascunho de correção.
• ClickUp, Asana, Trello ou GitHub Issues. O Flowsery Trigger do guia de workflows de analytics com n8n inicia um workflow a cada problema novo e cria a tarefa onde você precisar.

Para saber o que um bom ticket deve conter, chegue onde chegar, leia como os relatórios de bugs com session replay chegam aos engenheiros.

Perguntas frequentes

O Flowsery funciona com o Linear?

O Flowsery funciona com o Linear por meio de uma integração OAuth listada no diretório de integrações do Linear na categoria Bug Reporting. Ela cria issues do Linear a partir dos bugs que o Flowsery encontra em gravações de sessão, à mão ou automaticamente, e os resolve no Flowsery quando são fechados no Linear.

Você precisa ser administrador do Linear para conectar o Flowsery?

Qualquer membro do Linear pode aprovar a conexão com o Flowsery, e não é preciso um administrador do Linear. No Flowsery, você precisa da função Admin ou Editor no workspace. A conta do Linear que aprova precisa pertencer a pelo menos uma equipe, senão a lista de equipes fica vazia.

O que uma issue do Linear criada pelo Flowsery contém?

Uma issue do Linear criada pelo Flowsery contém o título, a descrição, a severidade, o número de sessões afetadas e quando o bug foi visto pela primeira e pela última vez. Ela tem links para o problema no Flowsery e para a gravação da sessão, e o Flowsery anexa o vídeo da gravação à issue do Linear.

O Flowsery pode registrar issues do Linear automaticamente?

O Flowsery registra issues do Linear automaticamente assim que você ativa Tickets automáticos no cartão do Linear, escolhe uma equipe do Linear e define uma severidade mínima. Todo problema novo dessa severidade ou acima vira uma issue do Linear nessa equipe, e cada problema é registrado uma única vez.

Fechar uma issue do Linear resolve o bug no Flowsery?

Fechar uma issue do Linear criada pelo Flowsery resolve o problema correspondente no Flowsery quando a issue passa para um estado concluído ou cancelado. Só mudam os problemas do Flowsery que ainda estão abertos ou em andamento, e o Linear avisa o Flowsery sem nenhuma configuração.

Quanto custa a integração do Flowsery com o Linear?

Todos os planos do Flowsery incluem a integração com o Linear. O Team custa $250 por mês e o Pro $500 por mês, e os dois começam com um teste grátis de 14 dias sem cartão de crédito.

Você pode escolher em qual equipe do Linear o Flowsery registra as issues?

Você escolhe a equipe do Linear a cada ticket criado à mão. Para os Tickets automáticos, você escolhe uma equipe do Linear no cartão do Linear, e todo problema novo com a severidade mínima ou acima vai para lá. Se a chave estiver ligada sem equipe escolhida, nada é registrado.

O Flowsery registra o mesmo bug duas vezes no Linear?

O Flowsery registra cada problema uma única vez, e o problema do Flowsery guarda um link para o ticket do Linear. Ele também agrupa num único problema todas as sessões afetadas pela mesma falha. Um bug que atingiu 38 sessões vira uma issue do Linear com a contagem de sessões, não 38 issues.

Como desconectar o Linear do Flowsery?

Abra o cartão do Linear em Configurações do site > Integrações, clique em Gerenciar e depois em Desconectar. O Flowsery revoga o próprio acesso no Linear e para de criar tickets para esse site, inclusive os automáticos. As issues que já estão no Linear ficam lá.

Um site pode enviar tickets automáticos para o Linear e para o Jira?

Os tickets automáticos vão para um único tracker por site. Ativá-los para o Linear desativa para o Jira ou o Notion no mesmo site. Os problemas abaixo da sua severidade mínima ficam no Flowsery, e você ainda pode mandar qualquer um deles com Criar ticket.