Intégrations : Jira, Azure DevOps, GitHub Issues, Slack, Teams et Telegram
Nexus StudioQA se connecte à six services : Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams et Telegram. Chacun reste désactivé tant que vous ne l’activez pas, et les connexions s’effectuent directement depuis votre machine, sans jamais passer par nos serveurs. Cette page explique le rôle de chaque service, les clés qu’il lit et ce qu’il ne fait jamais.
Dernière mise à jour :
Par l'équipe Nexus StudioQA, Verdict System LLC. 9 octobre 2026.
Comment fonctionne chaque intégration
- Désactivé tant que vous ne l’activez pas. Chaque service possède son propre paramètre d’activation :
JIRA_ENABLED,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLEDetTELEGRAM_ENABLED. Tous sont définis surfalsepar défaut. - Directement depuis votre machine. Le moteur appelle l'API propre à chaque service depuis la machine qui exécute les tests. Rien ne transite par nos serveurs, et nous ne voyons jamais vos tickets, alertes ou résultats.
- Les clés restent dans l'espace de travail. Les jetons et les clés sont des lignes dans le fichier
.envde l'espace de travail, sur votre disque. Les Paramètres, sous Intégrations, permettent de les modifier et affichent chaque jeton, clé et webhook masqué. - Les exécutions de sandbox restent à l'écart. Une exécution de sandbox est un test en cours de construction, pas une anomalie : elle ne crée, ne commente ni ne ferme jamais de ticket.
Un ticket par test, tant qu'il reste en échec
Jira, Azure Boards et GitHub Issues suivent le même cycle de vie, et les paramètres Tickets permettent de modifier chaque étape. Le ticket est lié au test, pas à l'exécution : un test qui échoue chaque nuit correspond donc à un seul ticket avec un historique, et non à un nouveau ticket chaque nuit.
- Le premier échec ouvre un ticket. Une exécution qui se termine par BREACHED, BREACHED_FLAKY, CHAOS_BREACHED ou TIMEOUT ouvre un ticket pour ce test, avec l'erreur et la capture d'écran de l'échec en pièce jointe.
- Un nouvel échec y ajoute un commentaire. Tant que ce ticket est ouvert, l'échec suivant y ajoute un commentaire, avec la nouvelle capture d'écran en pièce jointe. Deux navigateurs qui échouent en même temps l'ajoutent au même ticket.
- Un succès complet le clôture. Lorsque le test réussit sans encombre sur chaque navigateur d'une exécution, le ticket reçoit un commentaire l'indiquant et passe à l'état terminé. Si le workflow ne comporte pas une telle transition ou un tel état, il reçoit uniquement le commentaire.
- Un échec survenant après cela ouvre un nouveau ticket. Il en va de même pour un échec dont le ticket a été supprimé ou déplacé.
Pièces jointes : la capture d'écran uniquement, par défaut. La trace Playwright et le journal d'exécution ne sont également joints que si vous l'activez avec NEXUS_ISSUE_ATTACH_TRACE=true dans les Paramètres, car ils peuvent contenir des données de session : cookies, en-têtes d'autorisation et mots de passe saisis. Chaque fichier est joint jusqu'à 10 Mo.
FLAKY ne crée jamais rien : une exécution qui a échoué puis réussi lors d'une nouvelle tentative n'est pas un bug. Il en est de même pour BLOCKED, UNREACHABLE, CRASHED ou une erreur de configuration, qui concernent l'environnement et non votre application (comment les verdicts sont déterminés). La correspondance entre les tickets et les tests est conservée dans evidence/integrations/issue-map.json, au sein de l'espace de travail.
Guides pas à pas
Chaque guide indique les éléments nécessaires, comment obtenir les identifiants, comment vérifier le bon fonctionnement, et répertorie les erreurs courantes avec leur cause et leur solution.
- Connecter Jira Cloud
- Connecter Azure Boards
- Connecter GitHub Issues
- Connecter Slack
- Connecter Microsoft Teams
- Connecter Telegram
D’autres destinations pour signaler un échec
Cinq autres destinations suivent les mêmes règles que les services ci-dessus. Chacune est désactivée tant que vous ne l’activez pas, et les connexions s’effectuent directement depuis votre machine avec votre propre clé.
- Linear : un ticket par test en échec dans l’équipe de votre choix, avec ajout d’un commentaire si l’échec se répète et passage au premier état terminé lorsque le test réussit sans erreur. Clés :
LINEAR_ENABLED,LINEAR_API_KEYetLINEAR_TEAM_ID. - GitLab Issues : le même cycle de vie dans un projet GitLab, avec fermeture du ticket lorsque le test réussit sans erreur et réouverture si l’échec se reproduit. Clés :
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKENetGITLAB_ISSUES_PROJECT. Le jeton transite uniquement via https. - PagerDuty : un échec déclenche un incident, un échec répété alimente ce même incident et une réussite sans erreur le résout. Clés :
PAGERDUTY_ENABLEDetPAGERDUTY_ROUTING_KEY. - Opsgenie : le même cycle de vie sous forme d’alerte, fermée lorsque le test réussit sans erreur. Clés :
OPSGENIE_ENABLEDetOPSGENIE_API_KEY. - TestRail : consigne le résultat de chaque exécution pour le cas de test désigné dans le test par un commentaire
// nexus:testrail C123. Clés :TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEYetTESTRAIL_PROJECT_ID.
Regrouper par cause racine est une règle des paramètres des tickets, désactivée par défaut. Lorsqu’elle est activée, si un test échoue avec la même erreur qu’un test ayant déjà un ticket ouvert, un commentaire est ajouté à ce ticket au lieu d’en ouvrir un deuxième. La réussite sans erreur du test regroupé ne ferme jamais le ticket du premier test.
Demander à un assistant IA de vous guider
Tout assistant IA peut vous accompagner dans ces guides. Donnez-lui l’adresse d’un guide ou du fichier integrations-guide.json, qui répertorie chaque clé, son format valide, la manière de la vérifier, ainsi que chaque erreur avec sa cause et sa solution.
- Ne collez jamais de jeton, de clé, de mot de passe ni d’URL de webhook dans la conversation. Saisissez vos identifiants uniquement dans le Studio, sous Paramètres, Intégrations. Un assistant n’en a jamais besoin.
- Ne lui communiquez que ce qui n’est pas secret : l’adresse du site, le nom du projet et la ligne d’erreur exacte affichée par le Studio.
- Seule la vérification du Studio fait foi. Ce sont les commandes Vérifier la connexion, Envoyer un message de test et Créer un ticket de test qui vous indiquent si une connexion fonctionne, et non l’assistant.
- Si vous avez déjà collé un identifiant dans une conversation, révoquez-le auprès du service et créez-en un nouveau.
Jira Cloud
- Connexion : l'adresse e-mail de votre compte Atlassian et un jeton API, créé sur id.atlassian.com. Dans les Paramètres, sous Intégrations, collez n'importe quel lien issu de votre site Jira : le Studio conserve le site et la clé du projet. L'adresse du site,
JIRA_BASE_URL, doit être en https. Vérifier la connexion les teste sans rien créer. - Tickets : un Bug dans
JIRA_PROJECT_KEY, suivant le cycle de vie ci-dessus. En cas de succès complet, le ticket passe par la transition spécifiée dansJIRA_DONE_TRANSITION, Done par défaut, identifiée par son nom sans tenir compte de la casse. - Pas de doublons : si un Bug avec le même résumé a été créé au cours des dernières 24 heures, aucun second bug n'est créé.
- Plusieurs sites Jira : sous Tickets, Ajouter un autre site Jira ajoute une destination avec son propre site, sa clé de projet et son type de ticket. Chaque destination activée reçoit son propre ticket. Le site doit être une adresse Atlassian Cloud, https://<name>.atlassian.net, et une seule adresse e-mail Atlassian et un seul jeton API servent pour tous les sites de ce compte. Le jeton est envoyé uniquement aux sites que vous indiquez.
- Manuellement : le casier des preuves (Evidence Locker) peut transmettre un échec à Jira lorsque vous le décidez.
Azure DevOps : Boards, Test Plans et Pipelines
Un jeton d'accès personnel (PAT) et un projet, dans AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> ou https://<org>.visualstudio.com) et AZURE_DEVOPS_PROJECT. Le PAT est envoyé uniquement aux propres hôtes d'Azure DevOps et n'apparaît jamais dans une ligne de journal. Dans les Paramètres, sous Intégrations, Connecter Azure DevOps vérifie le projet ainsi que le type d'élément de travail, sans rien créer.
- Azure Boards : avec
AZURE_BOARDS_ENABLED=true, un échec ouvre un élément de travail de typeAZURE_BOARDS_WORK_ITEM_TYPE, Bug par défaut, en suivant le cycle de vie ci-dessus. En cas de succès total, il passe à l'état défini dansAZURE_BOARDS_DONE_STATE, Resolved par défaut ; un processus qui refuse cet état reçoit uniquement le commentaire. Le PAT nécessite Éléments de travail (Lecture & écriture). L'Evidence Locker peut également envoyer manuellement un échec à Azure Boards. - Azure Test Plans : le fichier
azure-pipelines.ymlgénéré par l'écran CI/CD publie le fichier XML JUnit de l'exécution avec la tâchePublishTestResults@2, afin que chaque exécution de pipeline apparaisse sous Test Plans, Runs. - Azure Pipelines :
nexus ci-remote --provider=azuremet en file d'attente une exécution du pipeline dansAZURE_PIPELINE_ID, l'attend et rapatrie son XML JUnit sur cette machine. Le PAT nécessite Build (Lecture & exécution) pour cela.
GitHub Issues
- Connexion : un jeton d’accès personnel à permissions fines avec l’autorisation Issues (lecture et écriture) sur un dépôt, dans
GITHUB_ISSUES_TOKEN, et le dépôt au format propriétaire/dépôt dansGITHUB_ISSUES_REPO. Dans les paramètres, sous Intégrations, Connecter GitHub Issues affiche le propriétaire du jeton et propose uniquement les dépôts auxquels il donne accès et dont les tickets sont activés (guide pas à pas). - Tickets : avec
GITHUB_ISSUES_ENABLED=true, un échec ouvre un ticket GitHub avec les étiquettes du ticket, selon le cycle de vie décrit ci-dessus. Lorsque le test réussit sans incident, un commentaire est ajouté au ticket GitHub, qui est ensuite fermé comme terminé. - Autre dépôt : sous Tickets, une destination GitHub peut indiquer un propriétaire/dépôt différent de celui défini dans
.env.
Slack
- Connexion : une URL de Webhook entrant, dans
SLACK_WEBHOOK_URL. Les Paramètres disposent d'un bouton Envoyer un message de test. - Ce qu'il reçoit : des messages Block Kit : le résumé de l'exécution et, avec
NEXUS_SLACK_NOTIFY=true, un message par test échoué, instable, de chaos ou de régression visuelle. Un message concernant un échec renvoie vers son ticket Jira lorsqu'il en existe un. - Manuellement : l'Evidence Locker peut publier un résumé textuel de l'échec sur Slack. Slack ne reçoit aucun fichier.
Microsoft Teams
- Connexion : une URL de webhook Workflows pour un canal, dans
TEAMS_WEBHOOK_URL. Teams Workflows nécessite un compte Microsoft 365 professionnel ou scolaire. Les paramètres proposent Enregistrer & envoyer un test (guide pas à pas). - Ce qui est reçu : les mêmes messages que Slack, sous forme de cartes adaptatives : le résumé de l’exécution et, avec
NEXUS_TEAMS_NOTIFY=true, un message par test en échec, instable, de chaos ou de régression visuelle. - Destination de l’URL : uniquement une adresse https sur les hôtes de webhooks de Microsoft (logic.azure.com, webhook.office.com, api.powerplatform.com). Toute autre URL est refusée et rien n’est envoyé.
Telegram
- Connexion : votre propre bot, créé une fois avec @BotFather, dans
TELEGRAM_TOKEN. Dans les Paramètres, Connecter par QR associe votre discussion et renseigneTELEGRAM_CHAT_ID. Il n'y a pas de bot partagé. - Ce qu'il reçoit : des alertes en cas d'échec, une par test avec
NEXUS_TELEGRAM_NOTIFY=true, ainsi que les rapports et fichiers que vous choisissez de partager depuis le Studio. - Avant de l'activer : Telegram peut recevoir des fichiers, tels que des rapports et des PDF, et ils sont transmis aux serveurs de Telegram. Dans un environnement réglementé, consultez d'abord votre équipe de conformité.
Tickets : quand ils sont ouverts, ce qu’ils contiennent, où ils sont envoyés
Dans les paramètres, sous Intégrations, l’écran Tickets définit ce qui est envoyé à Jira, Azure Boards ou GitHub Issues lorsqu’un test échoue. La fonction de partage d’Evidence Locker utilise le même modèle. La configuration est enregistrée dans nexus-tickets.config.json dans l’espace de travail, un fichier sans secrets que vous pouvez conserver dans votre dépôt. En l’absence de ce fichier, les tickets se comportent comme décrit ci-dessus. Si le fichier est invalide, les valeurs par défaut s’appliquent et le journal en indique la raison.
- Quand : les verdicts qui déclenchent l’ouverture d’un ticket (BREACHED et TIMEOUT par défaut), le nombre d’échecs consécutifs requis avant l’ouverture, une limite par exécution, les exécutions locales, en CI ou les deux, les identifiants de test à inclure ou à exclure, l’action à effectuer lorsqu’un test réussit sans erreur (fermer, ajouter un commentaire uniquement ou ne rien faire), et la réouverture éventuelle du ticket fermé si l’échec se reproduit, plutôt que la création d’un nouveau ticket.
- Quoi : le modèle de titre, avec
{type},{testId},{browser}et{error.firstLine}.{testId}est obligatoire, car le titre sert de clé de détection des doublons sur 24 heures. Également les sections de description à envoyer et leur ordre, la quantité de détails de l’erreur à inclure, les étiquettes, la priorité par verdict, la personne responsable, le composant, les champs personnalisés et une note pour l’équipe. - Pièces jointes : la capture d’écran par défaut. La trace, la vidéo et le rapport uniquement si vous les cochez, chacun dans la limite de taille autorisée.
- Où : une destination par outil de suivi, chacune avec son propre interrupteur. Une destination peut remplacer le site, le projet et le type de ticket Jira, le dépôt GitHub ou le type d’élément de travail Azure.
- Aperçu et test : avant l’enregistrement, l’écran affiche, pour chaque destination, le ticket que produirait votre dernier échec. Créer un ticket de test crée un véritable ticket à partir de cet aperçu, avec l’étiquette
nexus-test.
Ce qu'un ticket ne contient jamais
- Uniquement ce que vous cochez. Toute section ou pièce jointe non sélectionnée reste sur votre machine.
- Les secrets sont d’abord masqués. Chaque ligne de texte passe par une étape de masquage avant son envoi : en-têtes d’autorisation et de cookies, jetons Bearer et Basic, JWT, formats connus de clés de fournisseurs, mots de passe dans les URL et valeurs des champs dont le nom évoque un secret. Ce masquage détecte les formes habituelles des secrets dans les journaux et les erreurs, mais pas tous les secrets que peut contenir un texte libre. Laissez donc la trace désactivée, sauf si vous en avez besoin.
- Aucun jeton dans le fichier.
nexus-tickets.config.jsonrefuse tout champ dont le nom évoque un secret et toute URL contenant un nom d’utilisateur et un mot de passe. Les jetons restent dans.env.
Les clés
Chaque clé correspond à une ligne dans le fichier .env de l'espace de travail. Les Paramètres permettent de toutes les modifier.
| Service | Clés | Valeurs par défaut |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | Désactivé ; projet QA ; transition Done |
| Azure DevOps | AZURE_BOARDS_ENABLED, AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PAT, AZURE_BOARDS_WORK_ITEM_TYPE, AZURE_BOARDS_DONE_STATE, AZURE_PIPELINE_ID | Désactivé ; type Bug ; état Résolu |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | Désactivé |
| Pièces jointes du ticket | NEXUS_ISSUE_ATTACH_TRACE | Désactivé : la capture d'écran uniquement |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | Désactivé |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | Désactivé |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | Désactivé |
Dans un pipeline, les mêmes clés, toutes sauf AZURE_PIPELINE_ID, sont les variables secrètes du pipeline, et une clé que vous laissez non définie maintient son service désactivé (secrets dans CI/CD).
Questions
Nexus StudioQA a-t-il accès à mes données Jira ou Azure DevOps ?
Non. Le moteur communique avec Jira, Azure DevOps, GitHub Issues, Slack, Teams et Telegram depuis votre machine, avec vos clés. Aucun de ces échanges ne passe par nos serveurs.
Un test instable (flaky) ouvrira-t-il un ticket ?
Non. FLAKY ne consigne rien. BREACHED_FLAKY le fait : l'échec lui-même était incohérent, et une nouvelle tentative ne le masque pas.
Un test a échoué 30 fois cette semaine. Combien de tickets cela représente-t-il ?
Un seul, avec un commentaire et une nouvelle capture d'écran pour chaque échec après le premier, jusqu'à ce que le test réussisse sans erreur sur chaque navigateur.
Puis-je utiliser Jira, Azure Boards et GitHub Issues en même temps ?
Oui. Chacun conserve son propre ticket par test, tout comme chaque site Jira supplémentaire.