Linear

Connecte Linear pour que les agents puissent créer des tickets à partir des investigations, mettre à jour les états et garder ton gestionnaire de tickets synchronisé avec ce qu'ils trouvent.

Configuration

1. Dans Linear, ouvre Settings et va dans Security & access.
2. Sous Personal API keys, crée une clé. Elle a besoin de l'accès en écriture pour que les agents puissent créer et mettre à jour des tickets.
3. Colle la clé dans Polylane. Polylane la valide auprès de ton espace de travail Linear et se connecte.

Ta clé est chiffrée avant d'être stockée, et l'agent ne la voit jamais.

Ce que les agents peuvent faire

• Lister les équipes, les états de workflow, les membres et les projets
• Lister, chercher et lire les tickets avec leurs commentaires récents
• Créer des tickets à partir des constats d'investigation, avec la piste de preuves dans la description
• Mettre à jour l'état, la priorité, l'assigné, le projet, les étiquettes et la date d'échéance d'un ticket
• Commenter les tickets avec des constats et un état
• Exécuter du GraphQL arbitraire sur l'API Linear pour tout ce qui n'est pas couvert ci-dessus ; les mutations passent la même barrière de confirmation

Les écritures de tickets demandent toujours une confirmation avant de s'exécuter.

Webhooks et triage

La connexion enregistre un webhook Polylane dans ton espace de travail Linear, couvrant les tickets de toutes les équipes publiques. Avec le webhook en place :

• Les tickets qui deviennent urgents arrivent comme alertes et sont triés au moment où ils se déclenchent ; désescalader ou terminer le ticket résout l'alerte.

Créer le webhook nécessite que l'utilisateur de la clé API soit administrateur de l'espace de travail dans Linear. Une clé de non-administrateur se connecte quand même et chaque outil d'agent fonctionne ; seul le triage piloté par webhook est sauté.

Dépannage

Erreur "Invalid API key"

• Utilise une clé API personnelle de Security & access ; les tokens OAuth ne sont pas pris en charge. Polylane envoie la clé telle quelle dans l'en-tête Authorization, sans préfixe Bearer, exactement comme Linear l'attend pour les clés personnelles.
• Vérifie que la clé n'a pas été révoquée dans Linear.

Aucune alerte ni déclencheur depuis Linear

• La création du webhook nécessite la clé d'un administrateur de l'espace de travail. Reconnecte avec la clé d'un administrateur pour activer le triage et les déclencheurs pilotés par webhook.

Déconnexion

Déconnecte Linear dans Polylane, ce qui retire aussi le webhook qu'il avait enregistré, puis révoque la clé API dans Linear.