integrations

Integratie met Linear

De AI van Flowsery bekijkt je sessie-opnames en meldt wat er kapotging. De integratie met Linear stuurt die problemen naar je Linear-workspace, zodat het team ze oplost waar het zijn werk toch al plant. Je kunt van elk Flowsery-probleem een Linear-issue maken, of Flowsery elk nieuw probleem voor je laten aanmaken. Wordt de Linear-issue gesloten, dan markeert Flowsery zijn eigen versie als opgelost.

Wat je nodig hebt

  • Een Flowsery-website waarop sessie-opname aanstaat. Problemen komen uit opgenomen sessies.
  • De rol Admin of Editor in de Flowsery-workspace. Leden met andere rollen zien de koppeling, maar kunnen hem niet wijzigen.
  • Een Linear-account in de Linear-workspace waarin je issues wilt aanmaken. Elk Linear-lid kan de koppeling goedkeuren. Je hoeft geen Linear-admin te zijn.

De integratie met Linear zit in elk Flowsery-abonnement.

Linear koppelen

  1. Open de website in Flowsery en ga naar Website-instellingen → Integraties.
  2. Klik op de kaart Linear op Koppelen.
  3. Klik op Koppelen met Linear. Flowsery stuurt je door naar Linear.
  4. Kies de Linear-workspace en geef toegang. Flowsery vraagt leestoegang om je teams op te halen en schrijftoegang om issues aan te maken en opnames te uploaden.
  5. Linear stuurt je terug naar Flowsery. De kaart toont Gekoppeld en de naam van je Linear-workspace.

De koppeling hoort bij de website. Wil je vanuit meerdere websites issues aanmaken, koppel dan elke website apart.

Een Linear-issue maken van een Flowsery-probleem

  1. Open een probleem in Flowsery en klik op Ticket maken.
  2. Kies Linear als tracker en kies daarna het team.
  3. Controleer de titel, de beschrijving en de stappen om het te reproduceren, en klik op Maken.

De Linear-issue bevat:

  • de titel en beschrijving
  • de ernst
  • hoeveel sessies getroffen zijn
  • wanneer het probleem voor het eerst en voor het laatst is gezien
  • een link naar het probleem in Flowsery en een link naar de sessie-opname

Flowsery voegt ook de video van de opname toe aan de Linear-issue.

Nieuwe problemen automatisch aanmaken

Zodra Linear gekoppeld is, toont de kaart Linear de optie Automatische tickets.

  1. Zet Automatische tickets aan.
  2. Kies het Linear-team dat de issues moet ontvangen.
  3. Kies een Minimale ernst, van Laag en hoger tot Alleen kritiek.

Vanaf dan wordt elk nieuw probleem dat Flowsery op of boven die ernst vindt een Linear-issue in dat team, met dezelfde details als een handmatig ticket. Automatische tickets gaan per website naar één tracker. Zet je ze aan voor Linear, dan gaan ze uit voor Jira of Notion op dezelfde website.

Een issue sluiten in Linear lost het op in Flowsery

Gaat een Linear-issue die Flowsery heeft aangemaakt naar een voltooide of geannuleerde status, dan markeert Flowsery het bijbehorende probleem als opgelost. Alleen problemen die nog open of in behandeling zijn, veranderen. Linear laat het Flowsery zelf weten, dus je hoeft niets in te stellen. Een issue bewerken die al klaar is, doet niets.

Websites die met een API-sleutel zijn gekoppeld

Voordat Flowsery OAuth ondersteunde, werd een website met een persoonlijke API-sleutel aan Linear gekoppeld. Die websites blijven werken. Op hun kaart staat Gekoppeld met een API-sleutel. Stap over op OAuth via Beheren.

Om over te stappen op OAuth klik je op Beheren en daarna op Overstappen op OAuth, en geef je toegang in Linear. De OAuth-koppeling vervangt de API-sleutel; die kun je daarna in Linear verwijderen.

Linear ontkoppelen

  1. Ga naar Website-instellingen → Integraties.
  2. Klik op de kaart Linear op Beheren en daarna op Ontkoppelen.

Flowsery trekt zijn toegang in Linear in en verwijdert de koppeling. Issues die al in Linear staan, blijven daar. Flowsery maakt voor die website geen tickets meer aan in Linear, ook geen automatische.

Je kunt Flowsery ook uit je Linear-workspace verwijderen via de instellingen van Linear. Flowsery toont de website dan als opnieuw te koppelen.

Problemen oplossen

Op de kaart staat "Opnieuw koppelen nodig". Flowsery heeft geen toegang meer tot de Linear-workspace, meestal omdat iemand de app in Linear heeft verwijderd. Klik op Opnieuw koppelen en geef opnieuw toegang. Je instellingen voor automatische tickets blijven zoals ze waren.

Ticket maken vraagt je eerst een tracker te koppelen. Deze website is niet aan Linear gekoppeld. Koppel hem via Website-instellingen → Integraties.

De lijst met teams is leeg. Het Linear-account dat de koppeling heeft goedgekeurd, ziet geen enkel team. Vraag een Linear-admin om dat account aan een team toe te voegen, of koppel opnieuw met een account dat wel in een team zit.

Een gesloten Linear-issue heeft het Flowsery-probleem niet opgelost. Flowsery lost alleen problemen op waarvan het zelf de issue in Linear heeft aangemaakt, en alleen als die issue naar een voltooide of geannuleerde status gaat. Was het probleem in Flowsery al opgelost of opgeschort, dan blijft het zoals het is.

Voor al het andere mail je naar contact@flowsery.com met het domein van de website en de link naar het Flowsery-probleem.