Connecter Jira et lier des issues aux tickets

Connecter votre site Jira

Il vous faut l'autorisation Gérer les intégrations, que les administrateurs ont.

1. Ouvrez Paramètres > Intégrations > Jira et cliquez sur Connecter Jira.
2. Connectez-vous à Atlassian, choisissez votre site sur l'écran d'Atlassian et acceptez.
3. Si votre compte Atlassian donne accès à plusieurs sites Jira, Deskwoot affiche Choisissez votre site Jira. Cliquez sur Utiliser ce site à côté de celui qu'utilise votre équipe.
4. Dans Valeurs par défaut des nouvelles issues, choisissez un Projet, un Type d'issue et, si vous le souhaitez, un Composant, puis cliquez sur Enregistrer. Les agents peuvent choisir autre chose pour chaque issue.

Connecter votre propre compte Atlassian

Une issue créée depuis Deskwoot est créée avec le compte Atlassian de l'agent qui la crée : elle porte donc son nom dans Jira et suit ses autorisations Jira. Chaque agent connecte son compte une seule fois dans Paramètres > Profil > Comptes connectés avec Connecter le compte Atlassian, ou directement dans la fenêtre la première fois qu'il crée une issue. La personne qui a connecté le site pour l'espace de travail n'a pas besoin d'une deuxième connexion. Voir et lier des issues fonctionne sans elle.

Lier une issue existante

1. Ouvrez le ticket. La section Issues liées se trouve dans l'onglet Détails du ticket, à droite.
2. Cliquez sur Lier une issue et recherchez par clé d'issue, comme TAB-123, ou par des mots du titre.
3. Choisissez l'issue. Deskwoot écrit une ligne dans le ticket, et l'issue reçoit dans Jira 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 et confirmez. Le lien vers le ticket est aussi retiré dans Jira.

Créer une nouvelle issue

1. Dans Issues liées, cliquez sur Créer une issue. 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 destiné aux développeurs à partir du titre, du résumé, du contexte et des commentaires du ticket. Copilot ne reçoit pas le nom du client et a pour consigne de laisser de côté les données personnelles, et le brouillon compte comme une utilisation de Copilot, comme les autres brouillons de Copilot.
3. Vérifiez le Projet, le Type d'issue et le Composant, puis cliquez sur Créer une issue.

Le texte est copié dans Jira et quitte Deskwoot. Si vous supprimez ou exportez les données d'un client dans Deskwoot, la copie dans Jira n'est pas incluse : laissez donc de côté les données personnelles dont les développeurs n'ont pas besoin.

Suivre le statut dans Deskwoot

Jira 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. Issues liées affiche la clé, le statut et le titre complet de chaque issue. Dans la liste des tickets, la ligne du ticket affiche la clé de l'issue avec un point de la couleur de son statut (gris pour À faire, bleu pour En cours, vert pour Terminé), et en passant la souris dessus, vous voyez le nom du statut. Recherchez une clé d'issue dans la liste des tickets pour trouver tous les tickets qui y sont liés. Une issue supprimée dans Jira affiche Supprimée dans Jira.

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 Jira. Ses conditions Changement de l'issue, Catégorie de statut de l'issue (À faire, En cours, Terminé), Catégorie de statut précédente de l'issue et Statut de l'issue (le nom du statut dans Jira) choisissent les changements auxquels elle réagit. Ces règles ne s'exécutent jamais sur des tickets résolus. Pour en savoir plus sur les règles, consultez Créer des règles d'automatisation.

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

• Issue créée ou liée : définir un statut de ticket, par exemple un de vos propres statuts de ticket qui met le SLA en pause pendant que l'équipe de développement travaille dessus.
• Issue terminée : rendre le ticket avec une note : définit un statut de ticket, attribue le ticket à la personne qui a lié l'issue et ajoute une note pour la prévenir.

Déconnecter ou reconnecter

Quand Atlassian n'accepte plus la connexion, par exemple parce que l'accès a été retiré ou qu'elle n'a pas servi pendant 90 jours, la page Jira affiche Jira 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 retire les connexions Atlassian personnelles des agents. Deskwoot conserve les liens, mais les masque sur les tickets tant que Jira n'est pas connecté. Une fois Jira reconnecté, ils réapparaissent avec leur dernier statut connu, et en attendant, un jeton d'API ou un jeton MCP peut toujours les lire.

Questions fréquentes

Pourquoi la section Issues liées n'apparaît-elle pas sur un ticket ?

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

Pourquoi Deskwoot me demande-t-il de connecter mon compte Atlassian ?

Une issue que vous créez est créée avec votre propre compte Atlassian : elle porte donc votre nom dans Jira. Vous le connectez une seule fois. Voir et lier des issues fonctionne sans lui.

Le client voit-il l'issue Jira ?

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

Deskwoot peut-il placer une issue en haut du backlog Jira ?

Non. L'ordre du backlog dépend de votre tableau dans Jira : classez donc les issues là-bas ou avec l'automatisation propre à Jira.

L'API ou une connexion MCP peuvent-elles travailler avec les issues Jira ?

Un jeton d'API ou un jeton MCP peut lire les issues d'un ticket, lier des issues existantes et les dissocier. Créer une nouvelle issue demande le compte Atlassian personnel d'une personne : seul un membre crée donc des issues, depuis le ticket.