Linear : créez, liez et suivez des issues depuis vos tickets

Connecter votre espace de travail Linear

Dans Deskwoot, il vous faut l'autorisation Gérer les intégrations, que les administrateurs ont. Dans Linear, vous devez être admin de l'espace de travail, car Deskwoot le rejoint en tant qu'app.

1. Ouvrez Paramètres > Intégrations > Linear et cliquez sur Connecter Linear.
2. Connectez-vous à Linear et autorisez Deskwoot sur l'écran de Linear.
3. De retour dans Deskwoot, Équipes visibles par Deskwoot liste les équipes Linear que l'app peut voir. Choisissez l'Équipe pour les nouvelles issues et cliquez sur Enregistrer. Les agents peuvent choisir une autre équipe pour chaque issue.

Deskwoot ne voit que les équipes Linear auxquelles vous donnez accès à l'app Deskwoot. Vous pouvez changer cela dans Linear à tout moment, puis recharger la page Linear dans Deskwoot.

Lier une issue existante

1. Ouvrez le ticket. La section Issues liées se trouve dans les détails du ticket, à droite.
2. Cliquez sur Lier une issue et cherchez par clé d'issue, comme ENG-123, ou par des mots du titre. Si Jira est aussi connecté, choisissez d'abord Linear en haut de la fenêtre.
3. Choisissez l'issue. Deskwoot écrit une ligne dans le ticket, et l'issue reçoit dans Linear un lien vers le ticket.

Un ticket peut avoir plusieurs issues, et une issue peut être liée à de nombreux tickets, par exemple quand beaucoup de clients signalent le même bug. Pour retirer un lien, cliquez sur le x à côté de l'issue. Le lien dans Linear disparaît aussi.

Créer une nouvelle issue

1. Dans Issues liées, cliquez sur Créer une issue. Si Jira est aussi connecté, choisissez Linear en haut de la fenêtre. Le titre et la description reprennent au départ le titre et le résumé du ticket.
2. Cliquez sur Rédiger un rapport de bug avec Copilot pour que Copilot écrive un rapport pour les développeurs à partir du résumé, du contexte et des commentaires du ticket. Copilot a pour consigne de laisser de côté le nom et les coordonnées du client, alors vérifiez le brouillon avant de créer l'issue. Le brouillon compte comme une utilisation de Copilot, comme les autres brouillons de Copilot.
3. Vérifiez l'Équipe, puis cliquez sur Créer une issue.

Linear affiche l'issue comme écrite par vous via Deskwoot, avec un lien vers le ticket. Le texte que vous envoyez quitte Deskwoot, et les demandes concernant les données personnelles faites dans Deskwoot ne s'appliquent pas à ce texte dans Linear. Retirez les données personnelles dont les développeurs n'ont pas besoin.

Suivre le statut dans Deskwoot

Linear informe Deskwoot de chaque changement de statut, et une vérification toutes les heures rattrape ce qui aurait été manqué. Chaque nouveau statut écrit une ligne dans tous les tickets liés à l'issue, et la liste des tickets affiche la clé et le statut de l'issue sur le ticket. Cherchez une clé d'issue dans la liste des tickets pour trouver tous les tickets qui y sont liés. Quand une issue passe à une autre équipe dans Linear, sa clé change et Deskwoot affiche la nouvelle. Une issue supprimée dans Linear affiche Supprimée dans Linear ou Introuvable dans Linear.

Trouver les bugs connus avec Copilot

Quand un client signale un problème, ou que vous demandez à Copilot s'il existe un bug connu dans l'onglet Copilot de la conversation, Copilot cherche aussi dans Linear. Il lit les issues ouvertes de l'équipe choisie sous Équipe pour les nouvelles issues et des équipes auxquelles vos tickets sont liés, jamais tout votre espace de travail Linear, ainsi que les issues déjà liées aux tickets de cette conversation, quel que soit leur statut.

• Copilot lit jusqu'à 3 issues Linear : d'abord celles liées au cas, puis les issues ouvertes dont le titre partage assez de mots avec le problème.
• Sa réponse cite les issues qui correspondent, avec leur clé, leur titre et leur statut, et chacune renvoie vers Linear. La ligne Vérifié au-dessus de la réponse cite Linear quand Linear a été consulté.
• Copilot donne une date de correction prévue seulement quand l'issue en contient une qui n'est pas encore passée : la date cible d'une release Linear, la date d'échéance de l'issue ou un commentaire de votre équipe. Il lit jusqu'à 3 commentaires écrits par une personne de votre équipe, jamais les commentaires de bots, d'invités ou de personnes extérieures à l'équipe.
• Dans une réponse destinée au client, Copilot a pour consigne de parler d'un problème connu seulement quand une issue le décrit, et de laisser de côté les clés d'issue et le nom Linear.

Quand Copilot n'a pas pu chercher dans Linear, par exemple parce que la connexion demande de vous reconnecter, une ligne sous la réponse l'indique. Copilot a alors pour consigne de ne jamais dire qu'il n'y a pas de bug connu.

Laisser les règles faire avancer les tickets

Dans Paramètres > Automatisation, une règle avec l'événement Issue liée modifiée s'exécute quand une issue est créée depuis un ticket, liée à celui-ci, dissociée de celui-ci ou change de statut dans Linear. Ses conditions Changement de l'issue, Catégorie de statut de l'issue (À faire, En cours, Terminé) et Statut de l'issue (le nom du statut dans Linear) choisissent les changements auxquels elle réagit. Une issue annulée ou en double compte comme Terminé, alors utilisez Statut de l'issue quand une règle doit la distinguer d'une issue vraiment terminée. Ces règles ne s'exécutent jamais sur les tickets résolus.

La carte Règles de la page des paramètres Linear ouvre 2 règles prêtes à l'emploi, que vous vérifiez et enregistrez :

• Issue créée ou liée : définir un statut du ticket, par exemple un statut de ticket à vous qui met le SLA en pause pendant que l'équipe de développement s'en occupe.
• Issue terminée : rendre le ticket avec une note : définit un statut du ticket, attribue le ticket à la personne qui a lié l'issue et ajoute une note qui la prévient, pour qu'elle puisse informer le client.

Si Jira est aussi connecté, les mêmes règles s'exécutent pour les issues des deux.

Déconnecter ou reconnecter

Quand Linear n'accepte plus la connexion, par exemple parce que l'app Deskwoot a été retirée dans Linear, la page Linear affiche Linear demande une nouvelle connexion. Cliquez sur Reconnecter pour garder les issues synchronisées. Déconnecter arrête la création et la liaison d'issues, et Deskwoot demande à Linear de mettre fin à l'accès de l'app. Deskwoot garde les liens. Tant qu'aucun outil de suivi des issues n'est connecté, les tickets ne les affichent pas. Une fois Linear reconnecté, ils s'affichent de nouveau avec leur dernier statut connu, et entre-temps un jeton d'API ou un agent MCP peut toujours les lire.

Questions fréquentes

Mes agents ont-ils besoin d'un compte Linear ?

Non. Deskwoot rejoint votre espace de travail Linear en tant qu'app : les agents lient et créent donc des issues sans compte Linear, et Linear affiche le nom de l'agent qui a créé une issue.

Pourquoi ne vois-je pas Issues liées sur un ticket ?

La section ne s'affiche que sur les tickets, tant que les tickets sont activés et que Linear ou Jira est connecté. Les conversations avec les clients n'ont pas d'issues liées.

Le client voit-il l'issue Linear ?

Non. Les tickets sont le travail interne de votre équipe, donc l'issue et ses lignes de statut restent au sein de votre équipe.

Puis-je utiliser Linear et Jira ensemble ?

Oui. Connectez les deux, et Lier une issue et Créer une issue vous laissent choisir Jira ou Linear en haut de la fenêtre. Un ticket peut avoir des issues des deux.

L'API ou un agent IA peuvent-ils travailler avec les issues Linear ?

Un jeton d'API ou un jeton MCP peut lire les issues d'un ticket, lier des issues existantes et les dissocier. Les coéquipiers IA les lisent seulement. Une nouvelle issue porte le nom de la personne qui la crée, donc seul un membre crée des issues, depuis le ticket.

Pourquoi Copilot ne trouve-t-il pas une issue Linear que je connais ?

Copilot cherche seulement les issues ouvertes de l'équipe pour les nouvelles issues et des équipes auxquelles vos tickets sont liés, et ne trouve que les issues dont le titre partage assez de mots avec le problème du client. Liez l'issue au ticket, et Copilot la lit quel que soit son statut.