Integrazioni: Jira, Azure DevOps, GitHub Issues, Slack, Teams e Telegram
Nexus StudioQA si collega a sei servizi: Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams e Telegram. Ciascuno è disattivato finché non lo attivi e viene contattato direttamente dal tuo computer, mai tramite i nostri server. Questa pagina spiega cosa fa ciascun servizio, quali chiavi legge e cosa non fa mai.
Ultimo aggiornamento:
A cura del team di Nexus StudioQA, Verdict System LLC. 9 ottobre 2026.
Come funziona ogni integrazione
- Disattivato finché non lo attivi. Ogni servizio ha la propria opzione di attivazione:
JIRA_ENABLED,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLEDeTELEGRAM_ENABLED. Sono tutte impostate sufalseper impostazione predefinita. - Direttamente dal tuo computer. Il motore chiama l'API di ciascun servizio dal computer che esegue i test. Nulla passa attraverso i nostri server e non vediamo mai le tue segnalazioni, i tuoi avvisi o i tuoi risultati.
- Le chiavi restano nell'area di lavoro. I token e le chiavi sono righe nel file
.envdell'area di lavoro, sul tuo disco. Nelle Impostazioni, la sezione Integrazioni consente di modificarli e mostra tutti i token, le chiavi e i webhook oscurati. - Le esecuzioni nella sandbox sono escluse. Un'esecuzione nella sandbox è un test in costruzione, non un problema rilevato: non apre, commenta o chiude mai una segnalazione.
Una segnalazione per test, finché continua a fallire
Jira, Azure Boards e GitHub Issues seguono lo stesso ciclo di vita e le impostazioni dei Ticket consentono di modificare ogni passaggio. La segnalazione appartiene al test, non all'esecuzione, quindi un test che fallisce ogni notte corrisponde a un'unica segnalazione con una cronologia, non a una nuova segnalazione ogni notte.
- Il primo fallimento apre una segnalazione. Un'esecuzione che termina con BREACHED, BREACHED_FLAKY, CHAOS_BREACHED o TIMEOUT apre una segnalazione per quel test, con l'errore e la schermata del fallimento allegata.
- Un fallimento successivo aggiunge un commento. Finché la segnalazione è aperta, il fallimento successivo vi aggiunge un commento, con la nuova schermata allegata. Due browser che falliscono contemporaneamente aggiornano la stessa segnalazione.
- Un superamento senza errori la chiude. Quando il test viene superato senza errori su tutti i browser di un'esecuzione, la segnalazione riceve un commento che lo conferma e passa allo stato completato. Se il flusso di lavoro non prevede tale transizione o stato, riceve solo il commento.
- Un fallimento successivo apre una nuova segnalazione. Lo stesso vale per un fallimento la cui segnalazione è stata eliminata o spostata.
Allegati: solo la schermata, per impostazione predefinita. La traccia di Playwright e il registro dell'esecuzione vengono allegati solo se lo autorizzi impostando NEXUS_ISSUE_ATTACH_TRACE=true nelle Impostazioni, perché possono contenere dati di sessione: cookie, intestazioni di autorizzazione e password digitate. Ogni file viene allegato fino a un massimo di 10 MB.
FLAKY non apre mai segnalazioni: un'esecuzione che fallisce e poi viene superata a un nuovo tentativo non è un bug. Lo stesso vale per BLOCKED, UNREACHABLE, CRASHED o un errore di configurazione, che riguardano l'ambiente, non la tua applicazione (come vengono determinati gli esiti). L'associazione tra segnalazioni e test è conservata in evidence/integrations/issue-map.json, nell'area di lavoro.
Guide passo passo
Ogni guida indica cosa serve, come ottenere le credenziali, come verificare che tutto funzioni ed elenca gli errori comuni con le relative cause e soluzioni.
- Collega Jira Cloud
- Collega Azure Boards
- Collega GitHub Issues
- Collega Slack
- Collega Microsoft Teams
- Collega Telegram
Altre destinazioni per le segnalazioni di errore
Altre cinque destinazioni seguono le stesse regole dei servizi sopra. Ognuna è disattivata finché non la attivi e viene contattata direttamente dal tuo computer con la tua chiave.
- Linear: una segnalazione per ogni test non riuscito nel team che scegli, con un commento se l'errore si ripete e il passaggio al primo stato di completamento quando il test viene superato senza errori. Chiavi:
LINEAR_ENABLED,LINEAR_API_KEYeLINEAR_TEAM_ID. - GitLab Issues: lo stesso ciclo di vita in un progetto GitLab, con chiusura della segnalazione quando il test viene superato senza errori e riapertura se l'errore si ripresenta. Chiavi:
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKENeGITLAB_ISSUES_PROJECT. Il token viene trasmesso solo tramite https. - PagerDuty: un errore genera un incidente, un errore ripetuto aggiunge informazioni allo stesso incidente e il superamento del test senza errori lo risolve. Chiavi:
PAGERDUTY_ENABLEDePAGERDUTY_ROUTING_KEY. - Opsgenie: lo stesso ciclo di vita sotto forma di avviso, che viene chiuso quando il test viene superato senza errori. Chiavi:
OPSGENIE_ENABLEDeOPSGENIE_API_KEY. - TestRail: registra il risultato di ogni esecuzione per il caso indicato dal test con un commento
// nexus:testrail C123. Chiavi:TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEYeTESTRAIL_PROJECT_ID.
Raggruppa per causa principale è una regola nelle impostazioni dei ticket ed è disattivata per impostazione predefinita. Quando è attiva, se un test fallisce con lo stesso errore di un altro test che ha già una segnalazione aperta, viene aggiunto un commento a quella segnalazione anziché aprirne una seconda. Il superamento senza errori del test raggruppato non chiude mai la segnalazione del primo test.
Chiedi a un assistente IA di guidarti
Qualsiasi assistente IA può aiutarti a seguire queste guide. Forniscigli l'indirizzo di una guida o di integrations-guide.json, che elenca tutte le chiavi, il loro formato valido, come verificarle e ogni errore con la relativa causa e soluzione.
- Non incollare mai token, chiavi, password o URL di webhook nella chat. Inserisci le credenziali solo in Studio, in Impostazioni, Integrazioni. Un assistente non ne ha mai bisogno.
- Comunica solo ciò che non è segreto: l'indirizzo del sito, il nome del progetto e l'esatta riga di errore mostrata da Studio.
- La conferma viene dalla verifica di Studio. Sono Verifica connessione, Invia messaggio di prova e Crea ticket di prova a dirti se una connessione funziona, non l'assistente.
- Se hai già incollato una credenziale in una chat, revocala sul servizio e creane una nuova.
Jira Cloud
- Connessione: l'indirizzo email del tuo account Atlassian e un token API, creato su id.atlassian.com. Nelle Impostazioni, sotto Integrazioni, incolla un qualsiasi collegamento del tuo sito Jira: Studio conserva il sito e la chiave del progetto. L'indirizzo del sito,
JIRA_BASE_URL, deve essere https. Verifica connessione controlla i dati e non crea nulla. - Segnalazioni: un Bug in
JIRA_PROJECT_KEY, secondo il ciclo di vita descritto sopra. Quando il test viene superato senza errori, la segnalazione segue la transizione indicata inJIRA_DONE_TRANSITION, Done per impostazione predefinita, individuata per nome senza distinzione tra maiuscole e minuscole. - Nessun duplicato: se nelle ultime 24 ore è stato creato un Bug con lo stesso riepilogo, non ne viene aperto un secondo.
- Più siti Jira: in Ticket, Aggiungi un altro sito Jira aggiunge una destinazione con sito, chiave di progetto e tipo di segnalazione propri. Ogni destinazione abilitata riceve un ticket dedicato. Il sito deve essere un indirizzo Atlassian Cloud, https://<name>.atlassian.net, e un unico indirizzo email Atlassian e un unico token API vengono usati per tutti i siti di quell'account. Il token viene inviato solo ai siti elencati.
- Manualmente: Evidence Locker può inviare un fallimento a Jira quando lo scegli tu.
Azure DevOps: Boards, Test Plans e Pipelines
Un token di accesso personale (PAT) e un progetto, in AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> o https://<org>.visualstudio.com) e AZURE_DEVOPS_PROJECT. Il PAT viene inviato solo agli host di Azure DevOps e non compare mai nei registri. In Impostazioni, sotto Integrazioni, Connetti Azure DevOps verifica il progetto e il tipo di elemento di lavoro, senza creare nulla.
- Azure Boards: con
AZURE_BOARDS_ENABLED=true, un errore apre un elemento di lavoro di tipoAZURE_BOARDS_WORK_ITEM_TYPE, Bug per impostazione predefinita, seguendo il ciclo di vita descritto sopra. Quando il test viene superato senza errori, l'elemento passa allo stato indicato inAZURE_BOARDS_DONE_STATE, Resolved per impostazione predefinita; se il processo rifiuta quello stato, viene aggiunto solo il commento. Il PAT richiede Work Items (Read & write). Anche Evidence Locker può inviare manualmente un errore ad Azure Boards. - Azure Test Plans: il file
azure-pipelines.ymlgenerato dalla schermata CI/CD pubblica l'XML JUnit dell'esecuzione tramite l'attivitàPublishTestResults@2, così ogni esecuzione della pipeline compare in Test Plans, Esecuzioni. - Azure Pipelines:
nexus ci-remote --provider=azuremette in coda un'esecuzione della pipeline indicata inAZURE_PIPELINE_ID, ne attende il completamento e riporta il relativo XML JUnit su questa macchina. Per questa operazione il PAT richiede Build (Read & execute).
GitHub Issues
- Connessione: un token di accesso personale con autorizzazioni granulari e permesso Issues (lettura e scrittura) su un repository, in
GITHUB_ISSUES_TOKEN, e il repository nel formato proprietario/repository inGITHUB_ISSUES_REPO. Nelle impostazioni, in Integrazioni, Collega GitHub Issues mostra a chi appartiene il token e propone solo i repository a cui può accedere e in cui Issues è attivo (guida passo passo). - Segnalazioni: con
GITHUB_ISSUES_ENABLED=true, un errore apre una segnalazione con le etichette del ticket, seguendo il ciclo di vita descritto sopra. Se l'esecuzione termina senza errori, alla segnalazione viene aggiunto un commento e la segnalazione viene chiusa come completata. - Un altro repository: in Ticket, una destinazione GitHub può indicare una coppia proprietario/repository diversa da quella in
.env.
Slack
- Connessione: un URL webhook in ingresso, in
SLACK_WEBHOOK_URL. In Impostazioni è disponibile il pulsante Invia messaggio di prova. - Cosa riceve: messaggi Block Kit: il riepilogo dell'esecuzione e, con
NEXUS_SLACK_NOTIFY=true, un messaggio per ogni test fallito, instabile, di caos o di regressione visiva. Un messaggio relativo a un errore contiene il collegamento alla relativa segnalazione Jira, se presente. - Manualmente: Evidence Locker può pubblicare su Slack il riepilogo testuale di un errore. Slack non riceve file.
Microsoft Teams
- Connessione: un URL webhook di Workflows per un canale, in
TEAMS_WEBHOOK_URL. Teams Workflows richiede un account Microsoft 365 aziendale o dell'istituto di istruzione. Nelle impostazioni è disponibile Salva & invia test (guida passo passo). - Cosa riceve: gli stessi messaggi di Slack, sotto forma di schede adattive: il riepilogo dell'esecuzione e, con
NEXUS_TEAMS_NOTIFY=true, un messaggio per ogni test non superato, instabile, di caos o di regressione visiva. - Dove viene inviato l'URL: solo a un indirizzo https sugli host webhook di Microsoft (logic.azure.com, webhook.office.com, api.powerplatform.com). Qualsiasi altro URL viene rifiutato e non viene inviato nulla.
Telegram
- Connessione: un bot personale, creato una sola volta con @BotFather, in
TELEGRAM_TOKEN. In Impostazioni, Connetti tramite QR associa la tua chat e compilaTELEGRAM_CHAT_ID. Non esiste un bot condiviso. - Cosa riceve: avvisi in caso di errore, uno per test con
NEXUS_TELEGRAM_NOTIFY=true, e i rapporti e i file che scegli di condividere da Studio. - Prima di attivarlo: Telegram può ricevere file, come rapporti e PDF, che vengono inviati ai server di Telegram. In un ambiente soggetto a normative, consulta prima il team responsabile della conformità.
Ticket: quando si aprono, cosa contengono, dove vengono inviati
Nelle Impostazioni, sotto Integrazioni, la schermata Ticket definisce cosa viene registrato in Jira, Azure Boards o GitHub Issues quando un test fallisce. La funzione Condividi di Evidence Locker usa lo stesso modello. Le impostazioni vengono salvate in nexus-tickets.config.json nell'area di lavoro, un file privo di segreti che puoi conservare nel repository. In assenza del file, i ticket si comportano come descritto sopra. Se il file non è valido, vengono applicati i valori predefiniti e il registro ne indica il motivo.
- Quando: quali esiti aprono un ticket (BREACHED e TIMEOUT per impostazione predefinita), quanti fallimenti consecutivi sono necessari prima dell'apertura, un limite per esecuzione, esecuzioni locali, esecuzioni CI o entrambe, ID dei test da includere o escludere, cosa fare quando un test viene superato senza problemi (chiudere, aggiungere solo un commento o non fare nulla) e se un fallimento che si ripresenta riapre il ticket chiuso anziché aprirne uno nuovo.
- Cosa: il modello del titolo, con
{type},{testId},{browser}e{error.firstLine}.{testId}è obbligatorio, perché il titolo è la chiave usata per individuare i duplicati nell'arco di 24 ore. Inoltre, quali sezioni della descrizione inviare e in quale ordine, quanta parte dell'errore includere, etichette, priorità per esito, assegnatario, componente, campi personalizzati e una nota per il gruppo. - Allegati: la schermata acquisita per impostazione predefinita. La traccia, il video e il resoconto solo se li selezioni, ciascuno entro il limite di dimensione.
- Dove: una destinazione per ciascun sistema di gestione delle segnalazioni, ognuna con il proprio interruttore. Una destinazione può sostituire il sito, il progetto e il tipo di segnalazione Jira, il repository GitHub o il tipo di elemento di lavoro Azure.
- Anteprima e prova: prima del salvataggio, la schermata mostra il ticket che verrebbe generato dal fallimento più recente, per ciascuna destinazione. Crea ticket di prova crea da questa anteprima un ticket reale, con l'etichetta
nexus-test.
Cosa non contiene mai un ticket
- Solo ciò che selezioni. Le sezioni o gli allegati che non hai selezionato restano sul tuo computer.
- I segreti vengono prima mascherati. Ogni riga di testo viene sottoposta a un passaggio di oscuramento prima di essere registrata: intestazioni di autorizzazione e cookie, token bearer e basic, JWT, formati noti delle chiavi dei fornitori, password negli URL e valori dei campi con nomi riconducibili a segreti. Il sistema rileva le forme in cui i segreti compaiono solitamente nei registri e negli errori, non tutti i segreti che un testo libero può contenere, quindi lascia disattivata la traccia se non ti serve.
- Nessun token nel file.
nexus-tickets.config.jsonrifiuta qualsiasi campo con un nome riconducibile a un segreto e qualsiasi URL contenente nome utente e password. I token restano in.env.
Le chiavi
Ogni chiave occupa una riga nel file .env dell'area di lavoro. Puoi modificarle tutte in Impostazioni.
| Servizio | Chiavi | Valori predefiniti |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | Disattivato; progetto QA; transizione 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 | Disattivato; tipo Bug; stato Risolto |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | Disattivato |
| Allegati della segnalazione | NEXUS_ISSUE_ATTACH_TRACE | Disattivato: solo lo screenshot |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | Disattivato |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | Disattivato |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | Disattivato |
In una pipeline, le stesse chiavi, tutte tranne AZURE_PIPELINE_ID, sono le variabili segrete della pipeline, e una chiave non impostata mantiene disattivato il relativo servizio (segreti in CI/CD).
Domande
Nexus StudioQA vede i miei dati di Jira o Azure DevOps?
No. Il motore comunica con Jira, Azure DevOps, GitHub Issues, Slack, Teams e Telegram dal tuo computer, usando le tue chiavi. Nulla passa attraverso i nostri server.
Un test instabile aprirà una segnalazione?
No. FLAKY non apre alcuna segnalazione. BREACHED_FLAKY invece sì: l'errore stesso era intermittente, e un nuovo tentativo non lo nasconde.
Un test è fallito 30 volte questa settimana. Quante segnalazioni vengono create?
Una, con un commento e un nuovo screenshot per ogni errore dopo il primo, finché il test non viene superato senza problemi su tutti i browser.
Posso usare Jira, Azure Boards e GitHub Issues contemporaneamente?
Sì. Ciascuno mantiene una propria segnalazione per ogni test, e lo stesso vale per ogni sito Jira aggiuntivo.