Integraties: Jira, Azure DevOps, GitHub Issues, Slack, Teams en Telegram
Nexus StudioQA maakt verbinding met zes diensten: Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams en Telegram. Elke dienst staat uit totdat je die inschakelt, en wordt rechtstreeks vanaf je computer benaderd, nooit via onze servers. Deze pagina legt uit wat elke dienst doet, welke sleutels die uitleest en wat die nooit doet.
Laatst bijgewerkt:
Door het Nexus StudioQA-team, Verdict System LLC. 9 oktober 2026.
Hoe elke integratie werkt
- Uit totdat je het inschakelt. Elke dienst heeft een eigen schakelaar:
JIRA_ENABLED,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLEDenTELEGRAM_ENABLED. Ze staan allemaal standaard opfalse. - Rechtstreeks vanaf je computer. De engine roept de eigen API van elke dienst aan vanaf de computer waarop de tests worden uitgevoerd. Niets loopt via onze servers en we krijgen je issues, meldingen of resultaten nooit te zien.
- Sleutels blijven in de werkruimte. Tokens en sleutels staan als regels in het
.env-bestand van de werkruimte, op je schijf. Via Instellingen, onder Integraties, kun je ze bewerken en worden alle tokens, sleutels en webhooks afgeschermd weergegeven. - Sandboxuitvoeringen blijven buiten beschouwing. Een sandboxuitvoering is een test in ontwikkeling, geen bevinding: die maakt nooit een issue aan, plaatst er nooit een reactie bij en sluit er nooit een.
Eén issue per test, zolang die blijft mislukken
Jira, Azure Boards en GitHub Issues volgen dezelfde levenscyclus, en via de instellingen voor Tickets kun je elke stap aanpassen. Het issue hoort bij de test, niet bij de uitvoering, dus een test die elke nacht mislukt, levert één issue met een geschiedenis op, niet elke nacht een nieuw issue.
- De eerste mislukking opent één issue. Een uitvoering die eindigt met BREACHED, BREACHED_FLAKY, CHAOS_BREACHED of TIMEOUT opent één issue voor die test, met de fout en de schermafbeelding van de mislukking als bijlage.
- Een herhaalde mislukking voegt een reactie toe. Zolang dat issue openstaat, voegt de volgende mislukking er een reactie aan toe, met de nieuwe schermafbeelding als bijlage. Twee browsers waarin de test tegelijk mislukt, voegen informatie toe aan hetzelfde issue.
- Een volledig geslaagde test sluit het issue. Wanneer de test in elke browser van een uitvoering zonder problemen slaagt, krijgt het issue een reactie die dat vermeldt en gaat het naar de status voor afgeronde issues. Als de workflow zo'n overgang of status niet heeft, wordt alleen de reactie toegevoegd.
- Een mislukking daarna opent een nieuw issue. Dat geldt ook voor een mislukking waarvan het issue is verwijderd of verplaatst.
Bijlagen: standaard alleen de schermafbeelding. Het Playwright-tracebestand en het uitvoeringslogboek worden alleen ook toegevoegd als je daarvoor kiest met NEXUS_ISSUE_ATTACH_TRACE=true in Instellingen, omdat ze sessiegegevens kunnen bevatten: cookies, autorisatieheaders en ingevoerde wachtwoorden. Elk bestand wordt alleen bijgevoegd als het maximaal 10 MB groot is.
FLAKY maakt nooit iets aan: een uitvoering die eerst mislukte en bij een nieuwe poging slaagde, is geen bug. Dat geldt ook voor BLOCKED, UNREACHABLE, CRASHED of een configuratiefout: die gaan over de omgeving, niet over je applicatie (hoe oordelen worden bepaald). Welk issue bij welke test hoort, wordt bijgehouden in evidence/integrations/issue-map.json, in de werkruimte.
Stapsgewijze handleidingen
Elke handleiding beschrijft wat je nodig hebt, hoe je de toegangsgegevens verkrijgt, hoe je controleert of het werkt en welke veelvoorkomende fouten er zijn, met hun oorzaak en oplossing.
- Jira Cloud koppelen
- Azure Boards koppelen
- GitHub Issues koppelen
- Slack koppelen
- Microsoft Teams koppelen
- Telegram koppelen
Meer bestemmingen voor foutmeldingen
Voor nog vijf bestemmingen gelden dezelfde regels als voor de bovenstaande diensten. Ze staan allemaal uit totdat je ze inschakelt en worden rechtstreeks vanaf je computer benaderd met je eigen sleutel.
- Linear: één issue per mislukte test in het team dat je kiest. Bij een herhaalde mislukking wordt een reactie toegevoegd en bij een geslaagde test wordt het issue naar de eerste afgeronde status verplaatst. Sleutels:
LINEAR_ENABLED,LINEAR_API_KEYenLINEAR_TEAM_ID. - GitLab Issues: dezelfde levenscyclus binnen een GitLab-project, waarbij het issue bij een geslaagde test wordt gesloten en bij een nieuwe mislukking wordt heropend. Sleutels:
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKENenGITLAB_ISSUES_PROJECT. Het token wordt alleen via https verzonden. - PagerDuty: een mislukte test maakt een incident aan, een herhaalde mislukking wordt aan hetzelfde incident toegevoegd en een geslaagde test lost het op. Sleutels:
PAGERDUTY_ENABLEDenPAGERDUTY_ROUTING_KEY. - Opsgenie: dezelfde levenscyclus in de vorm van een waarschuwing, die bij een geslaagde test wordt gesloten. Sleutels:
OPSGENIE_ENABLEDenOPSGENIE_API_KEY. - TestRail: rapporteert het resultaat van elke uitvoering bij het testgeval dat een test aangeeft met de opmerking
// nexus:testrail C123. Sleutels:TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEYenTESTRAIL_PROJECT_ID.
Groeperen op hoofdoorzaak is een regel in de ticketinstellingen en staat standaard uit. Als deze aanstaat en een test mislukt met dezelfde fout als een test waarvoor al een issue openstaat, wordt daar een reactie toegevoegd in plaats van een tweede issue te openen. Een geslaagde uitvoering van de gegroepeerde test sluit het issue van de eerste test nooit.
Vraag een AI-assistent om je te begeleiden
Elke AI-assistent kan je door deze handleidingen leiden. Geef de assistent het adres van een handleiding of van integrations-guide.json, waarin elke sleutel staat, met het geldige formaat, hoe je deze controleert en elke fout met de oorzaak en oplossing.
- Plak nooit een token, sleutel, wachtwoord of webhook-URL in de chat. Voer toegangsgegevens alleen in Studio in, onder Instellingen, Integraties. Een assistent heeft ze nooit nodig.
- Deel alleen wat niet geheim is: het siteadres, de projectnaam en de exacte foutregel die Studio toont.
- De controle van Studio zelf levert het bewijs. Verbinding controleren, Testbericht verzenden en Testticket aanmaken laten zien of een verbinding werkt, niet de assistent.
- Als je al toegangsgegevens in een chat hebt geplakt, trek ze dan bij de dienst in en maak nieuwe aan.
Jira Cloud
- Verbinden: het e-mailadres van je Atlassian-account en een API-token, aangemaakt op id.atlassian.com. Plak in Instellingen, onder Integraties, een willekeurige link van je Jira-site: Studio bewaart de site en de projectsleutel. Het siteadres,
JIRA_BASE_URL, moet https gebruiken. Verbinding controleren test deze gegevens en maakt niets aan. - Issues: een Bug in
JIRA_PROJECT_KEY, volgens de bovenstaande levenscyclus. Als de test zonder problemen slaagt, doorloopt het issue de overgang met de naam inJIRA_DONE_TRANSITION, standaard Done, waarbij hoofdletters en kleine letters geen verschil maken. - Geen duplicaten: als er in de afgelopen 24 uur een Bug met dezelfde samenvatting is aangemaakt, wordt er geen tweede aangemaakt.
- Meer dan één Jira-site: onder Tickets voegt Nog een Jira-site toevoegen een bestemming toe met een eigen site, projectsleutel en issuetype. Elke ingeschakelde bestemming krijgt een eigen ticket. De site moet een Atlassian Cloud-adres zijn, https://<name>.atlassian.net, en één Atlassian-e-mailadres en API-token worden gebruikt voor alle sites van dat account. Het token wordt alleen verzonden naar de sites die je opgeeft.
- Handmatig: de Evidence Locker kan een mislukking naar Jira sturen wanneer je daarvoor kiest.
Azure DevOps: Boards, Test Plans en Pipelines
Eén persoonlijk toegangstoken (PAT) en één project, in AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> of https://<org>.visualstudio.com) en AZURE_DEVOPS_PROJECT. Het PAT wordt alleen naar de eigen hosts van Azure DevOps verstuurd en verschijnt nooit in een logregel. In Instellingen controleert Integraties, Verbinding maken met Azure DevOps het project en het type werkitem, zonder iets aan te maken.
- Azure Boards: met
AZURE_BOARDS_ENABLED=truewordt bij een fout een werkitem van het typeAZURE_BOARDS_WORK_ITEM_TYPEgeopend, standaard Bug, volgens de bovenstaande levenscyclus. Bij een volledig geslaagde uitvoering gaat het naar de status inAZURE_BOARDS_DONE_STATE, standaard Resolved; als een proces die status weigert, wordt alleen de opmerking toegevoegd. Het PAT heeft de machtiging Work Items (lezen & schrijven) nodig. De Evidence Locker kan een fout ook handmatig naar Azure Boards sturen. - Azure Test Plans: het bestand
azure-pipelines.ymldat het CI/CD-scherm genereert, publiceert de JUnit-XML van de uitvoering met de taakPublishTestResults@2, zodat elke pijplijnuitvoering verschijnt onder Test Plans, Uitvoeringen. - Azure Pipelines:
nexus ci-remote --provider=azurezet een uitvoering van de pijplijn inAZURE_PIPELINE_IDin de wachtrij, wacht tot deze is voltooid en haalt de JUnit-XML terug naar deze machine. Het PAT heeft hiervoor de machtiging Build (lezen & uitvoeren) nodig.
GitHub Issues
- Verbinden: een fijnmazig persoonlijk toegangstoken met Issues (lezen en schrijven) voor één repository, in
GITHUB_ISSUES_TOKEN, en de repository als owner/repo inGITHUB_ISSUES_REPO. In Instellingen, onder Integraties, toont GitHub Issues verbinden van wie het token is en biedt alleen de toegankelijke repository's aan waarvoor Issues is ingeschakeld (stapsgewijze handleiding). - Issues: met
GITHUB_ISSUES_ENABLED=truewordt bij een fout een issue geopend met de labels van het ticket, volgens de bovenstaande levenscyclus. Als de test zonder fouten slaagt, krijgt het issue een opmerking en wordt het als voltooid gesloten. - Een andere repository: onder Tickets kan een GitHub-bestemming een andere owner/repo opgeven dan die in
.env.
Slack
- Verbinding maken: één URL voor een inkomende webhook, in
SLACK_WEBHOOK_URL. Instellingen bevat een knop Testbericht versturen. - Wat het ontvangt: Block Kit-berichten: de samenvatting van de uitvoering en, met
NEXUS_SLACK_NOTIFY=true, één bericht per mislukte test, instabiele test, chaostest of visuele regressietest. Een bericht over een fout bevat een koppeling naar het bijbehorende Jira-issue als dat er is. - Handmatig: de Evidence Locker kan een tekstsamenvatting van een fout op Slack plaatsen. Slack ontvangt geen bestanden.
Microsoft Teams
- Verbinden: één Workflows-webhook-URL voor een kanaal, in
TEAMS_WEBHOOK_URL. Teams Workflows vereist een Microsoft 365-werk- of schoolaccount. Instellingen bevat Opslaan & test verzenden (stapsgewijze handleiding). - Wat het ontvangt: dezelfde berichten als Slack, als Adaptive Cards: de samenvatting van de uitvoering en, met
NEXUS_TEAMS_NOTIFY=true, één bericht per mislukte test, onbetrouwbare test, chaostest of visuele regressietest. - Waar de URL naartoe leidt: alleen naar een https-adres op de eigen webhookhosts van Microsoft (logic.azure.com, webhook.office.com, api.powerplatform.com). Elke andere URL wordt geweigerd en er wordt niets verzonden.
Telegram
- Verbinding maken: een eigen bot, eenmalig aangemaakt met @BotFather, in
TELEGRAM_TOKEN. In Instellingen koppelt Verbinden via QR je chat en vult hetTELEGRAM_CHAT_IDin. Er is geen gedeelde bot. - Wat het ontvangt: meldingen bij fouten, één per test met
NEXUS_TELEGRAM_NOTIFY=true, en de rapporten en bestanden die je vanuit de Studio wilt delen. - Voordat je het inschakelt: Telegram kan bestanden ontvangen, zoals rapporten en pdf's, en deze komen op de servers van Telegram terecht. Vraag in een gereguleerde omgeving eerst toestemming aan je nalevingsteam.
Tickets: wanneer ze worden geopend, wat ze bevatten, waar ze naartoe gaan
In Instellingen, onder Integraties, bepaalt het scherm Tickets wat er in Jira, Azure Boards of GitHub Issues wordt ingediend wanneer een test mislukt. Delen in de Evidence Locker gebruikt dezelfde sjabloon. De instellingen worden opgeslagen in nexus-tickets.config.json in de werkruimte, een bestand zonder geheime gegevens dat je in je repository kunt bewaren. Zonder dit bestand werken tickets zoals hierboven beschreven. Als het bestand ongeldig is, gelden de standaardinstellingen en vermeldt het logboek waarom.
- Wanneer: welke uitkomsten een ticket openen (standaard BREACHED en TIMEOUT), hoeveel opeenvolgende mislukkingen nodig zijn voordat een ticket wordt geopend, een maximum per uitvoering, lokale uitvoeringen, CI-uitvoeringen of beide, test-ID's om op te nemen of uit te sluiten, wat er gebeurt als een test weer slaagt (sluiten, alleen een opmerking plaatsen of niets), en of een terugkerende fout het gesloten ticket heropent in plaats van een nieuw ticket te openen.
- Wat: de titelsjabloon, met
{type},{testId},{browser}en{error.firstLine}.{testId}is verplicht, omdat de titel gedurende 24 uur als sleutel dient om duplicaten te herkennen. Verder welke beschrijvingsonderdelen worden verstuurd en in welke volgorde, hoeveel van de foutmelding wordt opgenomen, labels, prioriteit per uitkomst, toegewezen persoon, component, aangepaste velden en een teamnotitie. - Bijlagen: standaard de schermafbeelding. De trace, de video en het rapport alleen als je ze aanvinkt, elk tot de maximale bestandsgrootte.
- Waar: één bestemming per ticketsysteem, elk met een eigen schakelaar. Een bestemming kan de Jira-site, het project en het issuetype, de GitHub-repository of het Azure-werkitemtype overschrijven.
- Voorbeeld en test: het scherm toont vóór het opslaan per bestemming het ticket dat je meest recente mislukte test zou opleveren. Testticket aanmaken dient op basis daarvan één echt ticket in, met het label
nexus-test.
Wat een ticket nooit bevat
- Alleen wat je aanvinkt. Een onderdeel of bijlage die je niet hebt geselecteerd, blijft op je computer.
- Geheime gegevens worden eerst gemaskeerd. Elke tekstregel wordt vóór het indienen gefilterd op gevoelige gegevens: autorisatie- en cookieheaders, bearer- en basictokens, JWT's, bekende sleutelindelingen van providers, wachtwoorden in URL's en waarden van velden waarvan de naam op geheime gegevens duidt. Dit herkent de vormen waarin geheime gegevens doorgaans in logboeken en foutmeldingen voorkomen, maar niet alle geheime gegevens die vrije tekst kan bevatten, dus laat de trace uitgeschakeld tenzij je die nodig hebt.
- Geen tokens in het bestand.
nexus-tickets.config.jsonweigert elk veld waarvan de naam op geheime gegevens duidt en elke URL met een gebruikersnaam en wachtwoord. Tokens blijven in.env.
De sleutels
Elke sleutel staat op een regel in het .env-bestand van de werkruimte. Via Instellingen kun je ze allemaal bewerken.
| Dienst | Sleutels | Standaardwaarden |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | Uit; project QA; overgang 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 | Uit; type Bug; status Opgelost |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | Uit |
| Bijlagen bij issues | NEXUS_ISSUE_ATTACH_TRACE | Uit: alleen de schermafbeelding |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | Uit |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | Uit |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | Uit |
In een pijplijn zijn dezelfde sleutels, behalve AZURE_PIPELINE_ID, de geheime variabelen van de pijplijn. Als je een sleutel niet instelt, blijft de bijbehorende dienst uitgeschakeld (geheimen in CI/CD).
Vragen
Kan Nexus StudioQA mijn gegevens in Jira of Azure DevOps zien?
Nee. De engine communiceert vanaf je computer met Jira, Azure DevOps, GitHub Issues, Slack, Teams en Telegram, met je eigen sleutels. Niets daarvan loopt via onze servers.
Wordt er een ticket aangemaakt voor een instabiele test?
Nee. FLAKY maakt niets aan. BREACHED_FLAKY wel: de fout zelf trad niet consequent op, en een nieuwe poging verbergt die niet.
Een test is deze week 30 keer mislukt. Hoeveel issues levert dat op?
Eén, met een opmerking en een nieuwe schermafbeelding voor elke mislukking na de eerste, totdat de test in elke browser foutloos slaagt.
Kan ik Jira, Azure Boards en GitHub Issues tegelijk gebruiken?
Ja. Elk systeem houdt per test een eigen issue bij, en dat geldt ook voor elke extra Jira-site.