Créer des tickets Linear depuis les workflows
Ouvrez un ticket Linear depuis un workflow — dans l’équipe de votre choix, avec une priorité — et laissez l’action Polzy se fermer d’elle-même quand le ticket est terminé. Connectez Linear une fois avec une clé API personnelle.
Sur cette page
Quand un retour concerne votre équipe produit ou technique, un workflow peut ouvrir un ticket Linear à ce sujet — dans l’équipe de votre choix, avec un titre, une description et une priorité construits à partir de ce que Polzy sait. Si le workflow a aussi créé une action Polzy, l’action suit le ticket et se ferme d’elle-même une fois le ticket terminé ou annulé. À la fin de ce guide, Linear sera connecté et un workflow ouvrira des tickets.
Linear est inclus dans l’offre Business et s’utilise depuis les workflows. Seul un Administrateur peut le connecter et créer des workflows.
Avant de commencer
Il vous faut :
- Un espace de travail sur l’offre Business, avec le rôle Administrateur.
- Intégrations et Flux de travail activés pour l’espace de travail, dans Paramètres → Général → Ce que fait cet espace de travail.
- Un compte Linear qui peut créer des tickets dans les équipes que vous utiliserez. Les tickets sont créés au nom de ce compte : un compte dédié évite qu’ils soient liés à une seule personne.
- Une clé API personnelle pour ce compte (ci-dessous).
Créer une clé API personnelle
- Dans Linear, ouvrez Settings → Account → Security & access.
- Sous Personal API keys, choisissez New key et nommez-la Polzy.
- Donnez-lui un accès complet, ou au moins le droit de lire et de créer des tickets, ainsi que l’accès aux équipes que Polzy doit atteindre.
- Copiez la clé. Elle commence par
lin_api_.
Si Linear ne vous laisse pas créer de clé, un administrateur Linear a peut-être désactivé les clés des membres dans Settings → Administration → API. Linear explique les clés dans Linear: API and webhooks.
Connecter Linear à Polzy
- Dans la barre latérale, sous Automatiser, ouvrez Intégrations et choisissez l’onglet Disponibles.
- Trouvez Linear et choisissez Connecter.
- Collez la clé dans Clé API personnelle.
- Choisissez Tester la connexion. Polzy répond Connected as suivi du nom du compte.
- Choisissez Connecter.
La clé est stockée chiffrée. Une fois connecté, la ligne de Linear dans Intégrations propose Configurer la portée pour remplacer la clé, et Gérer pour sa page.
Ouvrir un ticket depuis un workflow
- Ouvrez Workflows et le workflow, ou créez-en un.
- Sous Connecteurs dans Étapes installées, faites glisser Créer un ticket Linear · Linear sur le canevas, après l’étape qu’il doit suivre. Une ligne avec un cadenas signifie que Linear n’est pas encore connecté, ou nécessite une action.
- Sous Équipe, choisissez l’équipe. La liste affiche toutes les équipes que la clé peut voir, avec leur nom et leur clé.
- Rédigez le Titre, jusqu’à 255 caractères. Tapez
{{pour insérer une valeur de l’exécution, comme le titre de l’action. - Si vous le souhaitez, rédigez une Description.
- Choisissez une Priorité : Aucune priorité, Urgente, Haute, Moyenne ou Basse.
L’étape transmet l’identifiant du ticket, par exemple CS-142, sous la forme {{connector.issueKey}} et son adresse sous la forme {{connector.url}}. Une Exécution d'essai parcourt le workflow sans ouvrir le ticket ; seule une vraie exécution en crée un. Workflows explique les déclencheurs et les étapes.
Fermer l’action quand le ticket est terminé
Quand Créer un ticket Linear s’exécute après Créer une action dans la même exécution du workflow, le ticket est lié à cette action :
- Suivi dans. Le panneau de l’action affiche l’identifiant du ticket, avec un lien vers Linear, et le dernier état signalé par Linear.
- Fermée par Linear. Polzy interroge Linear sur le ticket au plus toutes les 10 minutes. Quand il est terminé — ou annulé, puisque le travail ne s’y fera pas — l’action passe à Terminé.
- Le statut seulement. Les commentaires et autres changements restent dans Linear. Une action fermée d’abord dans Polzy n’est plus interrogée.
Ce que Polzy envoie à Linear
Seulement ce que dit l’étape : l’équipe, le titre, la description et la priorité, avec les valeurs que vous insérez. Rien d’autre sur la réponse ou la personne ne quitte Polzy. Une réponse anonyme n’a pas de personne : les valeurs comme l’e-mail du répondant sont vides ; ce que quelqu’un a écrit n’est envoyé qu’après sa lecture de sécurité. Les réponses individuelles ne sont pas retenues par la taille minimale des groupes : pensez à qui peut lire les tickets de l’équipe avant d’y mettre les mots des gens.
Dépannage
- Linear refused the credentials (401). La clé est erronée, ou a été révoquée. Créez-en une nouvelle, choisissez Configurer la portée sur la ligne de Linear dans Intégrations, collez-la et Enregistrer. Une exécution qui rencontre cette erreur fait passer Linear à Nécessite une action.
- Linear: suivi des mots de Linear (dans une exécution). Linear a refusé la requête — souvent parce que la clé n’a pas accès à cette équipe, ou ne peut pas créer de tickets. Vérifiez les permissions de la clé.
- Linear did not create the issue. Linear a répondu sans ticket. Relancez le workflow ; si cela se répète, vérifiez que l’équipe existe toujours.
- This step names no team ou The issue has no title. Renseignez l’Équipe et le Titre de l’étape.
- La liste Équipe est un simple champ. La clé ne voit aucune équipe, ou Linear n’a pas pu être joint.
- L’action ne se ferme pas. L’étape Linear ne s’est pas exécutée après Créer une action dans la même exécution, le ticket n’est ni terminé ni annulé, ou la connexion nécessite une action — les vérifications sont suspendues jusqu’à ce que ce soit réglé.
Bon à savoir
- Une connexion, toutes les équipes. Chaque étape choisit son équipe parmi celles que voit la clé.
- Qui est le créateur ? Le compte auquel appartient la clé.
- Une étape peut-elle ouvrir deux fois le même ticket ? Non. Une étape relancée après un plantage réutilise ce qu’elle a créé la première fois.
Liens utiles
Articles liés
Les membres connectés peuvent demander à Polzy ou écrire à l’équipe depuis Support. Notre délai de réponse dépend de votre forfait.