integrations

Integração com o Linear

A IA do Flowsery analisa as suas gravações de sessões e aponta o que quebrou. A integração com o Linear envia esses problemas para o seu workspace do Linear, para que a equipe os corrija onde já planeja o trabalho. Você pode criar uma issue no Linear a partir de qualquer problema do Flowsery, ou deixar o Flowsery registrar cada problema novo. Quando a issue é fechada no Linear, o Flowsery resolve o problema correspondente.

Requisitos

  • Um site do Flowsery com a gravação de sessões ativada. Os problemas vêm das sessões gravadas.
  • A função Admin ou Editor no workspace do Flowsery. Membros com outras funções veem a conexão, mas não podem alterá-la.
  • Uma conta do Linear no workspace do Linear que deve receber as issues. Qualquer membro do Linear pode aprovar a conexão. Você não precisa ser administrador do Linear.

Todos os planos do Flowsery incluem a integração com o Linear.

Conectar o Linear

  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 de escrita para criar issues e enviar as gravações.
  5. O Linear traz você de volta ao Flowsery. O cartão mostra Conectado e o nome do seu workspace do Linear.

A conexão pertence ao site. Para criar issues a partir de vários sites, conecte cada um deles.

Criar uma issue no Linear a partir de um problema do Flowsery

  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, e clique em Criar.

A issue no Linear traz:

  • o título e a descrição
  • a severidade
  • quantas sessões foram afetadas
  • quando o problema foi visto pela primeira e pela última vez
  • um link para o problema no Flowsery e outro para a gravação da sessão

O Flowsery também anexa o vídeo da gravação à issue no Linear.

Registrar problemas novos automaticamente

Com o Linear conectado, o cartão Linear mostra Tickets automáticos.

  1. Ative Tickets automáticos.
  2. Escolha a Equipe do Linear que vai receber as issues.
  3. Escolha uma Severidade mínima, de Baixa ou superior a Apenas crítica.

A partir daí, cada problema novo que o Flowsery detectar com essa severidade ou maior vira uma issue no Linear nessa equipe, com os mesmos dados de um ticket manual. Os tickets automáticos vão para um único tracker por site. Ativá-los para o Linear desativa-os para o Jira ou o Notion no mesmo site.

Fechar no Linear resolve o problema no Flowsery

Quando uma issue do Linear criada pelo Flowsery passa para um estado concluído ou cancelado, o Flowsery marca o problema correspondente como resolvido. Só mudam os problemas que ainda estão abertos ou em andamento. O Linear avisa o Flowsery sozinho, então não há nada para configurar. Editar uma issue que já está concluída não muda nada.

Sites conectados com uma chave de API

Antes de o Flowsery suportar OAuth, os sites se conectavam ao Linear com uma chave de API pessoal. Esses sites continuam funcionando. O cartão deles diz Conectado com uma chave de API. Mude para OAuth em Gerenciar.

Para mudar para OAuth, clique em Gerenciar, depois em Mudar para OAuth, e aprove o acesso no Linear. A conexão OAuth substitui a chave de API, que você pode apagar no Linear depois.

Desconectar o Linear

  1. Vá em Configurações do site → Integrações.
  2. No cartão Linear, clique em Gerenciar e depois em Desconectar.

O Flowsery revoga o acesso dele no Linear e apaga a conexão. As issues que já estão no Linear continuam lá. O Flowsery para de criar tickets no Linear para esse site, inclusive os automáticos.

Você também pode remover o Flowsery do seu workspace nas configurações do Linear. Nesse caso, o Flowsery mostra que o site precisa ser reconectado.

Solução de problemas

O cartão diz "Reconectar". 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 iguais.

Criar ticket pede para conectar um tracker primeiro. Este site não está conectado ao Linear. Conecte-o em Configurações do site → Integrações.

A lista de equipes está vazia. A conta do Linear que aprovou a conexão não vê nenhuma equipe. Peça a um administrador do Linear para adicioná-la a uma equipe, ou reconecte com uma conta que faça parte de uma.

Uma issue fechada no Linear não resolveu o problema no Flowsery. O Flowsery só resolve os problemas cuja issue ele mesmo criou no Linear, e só quando a issue passa para um estado concluído ou cancelado. Se o problema já estava resolvido ou suspenso no Flowsery, ele fica como está.

Para qualquer outra dúvida, escreva para contact@flowsery.com com o domínio do site e o link do problema no Flowsery.