Integrações: Jira, Azure DevOps, GitHub Issues, Slack, Teams e Telegram
O Nexus StudioQA se conecta a seis serviços: Jira Cloud, Azure DevOps, GitHub Issues, Slack, Microsoft Teams e Telegram. Cada um fica desativado até você ativá-lo, e o acesso a cada um é feito diretamente da sua máquina, nunca pelos nossos servidores. Esta página explica o que cada um faz, as chaves que lê e o que nunca faz.
Última atualização:
Pela equipe do Nexus StudioQA, Verdict System LLC. 9 de outubro de 2026.
Como funcionam todas as integrações
- Desativado até você ativar. Cada serviço tem sua própria opção de ativação:
JIRA_ENABLED,AZURE_BOARDS_ENABLED,GITHUB_ISSUES_ENABLED,SLACK_ENABLED,TEAMS_ENABLEDeTELEGRAM_ENABLED. Todas sãofalsepor padrão. - Diretamente da sua máquina. O engine chama a API de cada serviço a partir da máquina que executa os testes. Nada passa pelos nossos servidores, e nunca vemos suas issues, alertas ou resultados.
- As chaves ficam no workspace. Tokens e chaves são linhas no arquivo
.envdo workspace, no seu disco. Settings, em Integrations, as edita e mostra todo token, chave e webhook ocultado. - Execuções no sandbox ficam de fora. Uma execução no sandbox é um teste em construção, não um achado: ela nunca abre, comenta nem fecha uma issue.
Uma issue por teste, enquanto ele continuar falhando
Jira, Azure Boards e GitHub Issues seguem o mesmo ciclo de vida, e as configurações de Chamados podem alterar cada etapa. O chamado pertence ao teste, não à execução, portanto um teste que falha todas as noites gera um único chamado com histórico, não um novo chamado a cada noite.
- A primeira falha abre uma issue. Uma execução que termina em BREACHED, BREACHED_FLAKY, CHAOS_BREACHED ou TIMEOUT abre uma issue para aquele teste, com o erro e a captura de tela da falha anexados.
- Uma falha repetida comenta nela. Enquanto essa issue estiver aberta, a próxima falha adiciona um comentário a ela, com a nova captura de tela anexada. Dois navegadores que falham ao mesmo tempo contribuem para a mesma issue.
- Uma aprovação limpa a fecha. Quando o teste passa sem falhas em todos os navegadores de uma execução, a issue recebe um comentário informando isso e passa para o estado de concluída. Se o workflow não tiver essa transição ou estado, ela recebe apenas o comentário.
- Uma falha depois disso abre uma nova issue. O mesmo vale para uma falha cuja issue foi excluída ou movida.
Anexos: apenas a captura de tela, por padrão. O trace do Playwright e o log da execução só são anexados também se você ativar com NEXUS_ISSUE_ATTACH_TRACE=true em Settings, pois podem conter dados de sessão: cookies, cabeçalhos de autorização e senhas digitadas. Cada arquivo é anexado até 10 MB.
FLAKY nunca abre nada: uma execução que falhou e depois passou em uma nova tentativa não é um bug. BLOCKED, UNREACHABLE, CRASHED e erro de configuração também não, pois dizem respeito ao ambiente, não à sua aplicação (como os veredictos são decididos). A qual teste pertence cada issue fica registrado em evidence/integrations/issue-map.json, no workspace.
Guias passo a passo
Cada guia explica o que você precisa, como obter as credenciais, como verificar se funciona e lista os erros comuns com suas causas e soluções.
- Conectar Jira Cloud
- Conectar Azure Boards
- Conectar GitHub Issues
- Conectar Slack
- Conectar Microsoft Teams
- Conectar Telegram
Mais destinos para encaminhar falhas
Mais cinco destinos seguem as mesmas regras dos serviços acima. Cada um fica desativado até você ativá-lo, com acesso direto da sua máquina usando sua própria chave.
- Linear: uma issue por teste com falha na equipe que você escolher, com um comentário quando a falha se repete e movida para o primeiro estado de conclusão quando o teste passa sem falhas. Chaves:
LINEAR_ENABLED,LINEAR_API_KEYeLINEAR_TEAM_ID. - GitLab Issues: o mesmo ciclo de vida em um projeto do GitLab, com encerramento quando o teste passa sem falhas e reabertura quando a falha se repete. Chaves:
GITLAB_ISSUES_ENABLED,GITLAB_ISSUES_TOKENeGITLAB_ISSUES_PROJECT. O token é transmitido apenas por https. - PagerDuty: uma falha gera um incidente, uma falha recorrente é adicionada ao mesmo incidente e um teste que passa sem falhas o resolve. Chaves:
PAGERDUTY_ENABLEDePAGERDUTY_ROUTING_KEY. - Opsgenie: o mesmo ciclo de vida, na forma de um alerta, encerrado quando o teste passa sem falhas. Chaves:
OPSGENIE_ENABLEDeOPSGENIE_API_KEY. - TestRail: registra o resultado de cada execução no caso indicado pelo teste em um comentário
// nexus:testrail C123. Chaves:TESTRAIL_ENABLED,TESTRAIL_URL,TESTRAIL_USER,TESTRAIL_API_KEYeTESTRAIL_PROJECT_ID.
Agrupar por causa raiz é uma regra nas configurações de chamados e fica desativada por padrão. Quando ativada, uma falha com o mesmo erro de um teste que já tem uma issue aberta gera um comentário nessa issue em vez de abrir outra. Se o teste agrupado passar sem falhas, isso nunca encerrará a issue do primeiro teste.
Peça a um assistente de IA para orientar você
Qualquer assistente de IA pode orientar você ao longo destes guias. Forneça a ele o endereço de um guia ou do arquivo integrations-guide.json, que lista todas as chaves, seus formatos válidos, como verificá-las e cada erro com sua causa e solução.
- Nunca cole um token, uma chave, uma senha ou uma URL de webhook na conversa. Insira credenciais apenas no Studio, em Configurações, Integrações. Um assistente nunca precisa delas.
- Informe apenas o que não for sigiloso: o endereço do site, o nome do projeto e a linha exata do erro exibido pelo Studio.
- A comprovação vem da própria verificação do Studio. Verificar conexão, Enviar mensagem de teste e Criar chamado de teste indicam se uma conexão funciona, não o assistente.
- Se você já colou uma credencial em uma conversa, revogue-a no serviço e crie uma nova.
Jira Cloud
- Conectar: o e-mail da sua conta Atlassian e um token de API, criado em id.atlassian.com. Em Settings, em Integrations, cole qualquer link do seu site Jira: o Studio guarda o site e a chave do projeto. O endereço do site,
JIRA_BASE_URL, deve ser https. Check connection os testa e não cria nada. - Issues: um Bug em
JIRA_PROJECT_KEY, seguindo o ciclo de vida acima. Em uma aprovação limpa, a issue passa pela transição indicada emJIRA_DONE_TRANSITION, Done por padrão, comparada pelo nome, sem diferenciar maiúsculas de minúsculas. - Sem duplicatas: se um Bug com o mesmo resumo foi criado nas últimas 24 horas, nenhum segundo é aberto.
- Mais de um site Jira: em Chamados, Adicionar outro site Jira adiciona um destino com seu próprio site, chave de projeto e tipo de item. Cada destino habilitado recebe seu próprio chamado. O site deve ser um endereço do Atlassian Cloud, https://<name>.atlassian.net, e um único e-mail da Atlassian e token de API atendem a todos os sites dessa conta. O token é enviado apenas aos sites que você listar.
- Manualmente: o Evidence Locker pode enviar uma falha ao Jira quando você escolher.
Azure DevOps: Boards, Test Plans e Pipelines
Um personal access token (PAT) e um projeto, em AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> ou https://<org>.visualstudio.com) e AZURE_DEVOPS_PROJECT. O PAT é enviado apenas aos hosts do próprio Azure DevOps e nunca aparece em uma linha de log. Em Settings, em Integrations, Connect Azure DevOps verifica o projeto e o tipo de work item, e não cria nada.
- Azure Boards: com
AZURE_BOARDS_ENABLED=true, uma falha abre um work item do tipoAZURE_BOARDS_WORK_ITEM_TYPE, Bug por padrão, seguindo o ciclo de vida acima. Em uma aprovação limpa, ele passa para o estado indicado emAZURE_BOARDS_DONE_STATE, Resolved por padrão; um processo que recusa esse estado recebe apenas o comentário. O PAT precisa de Work Items (Read & write). O Evidence Locker também pode enviar uma falha ao Azure Boards manualmente. - Azure Test Plans: o
azure-pipelines.ymlque a tela CI/CD gera publica o JUnit XML da execução com a tarefaPublishTestResults@2, de modo que cada execução do pipeline aparece em Test Plans, Runs. - Azure Pipelines:
nexus ci-remote --provider=azureenfileira uma execução do pipeline emAZURE_PIPELINE_ID, aguarda sua conclusão e traz o JUnit XML de volta para esta máquina. O PAT precisa de Build (Read & execute) para isso.
GitHub Issues
- Conectar: um token de acesso pessoal com permissões granulares de Issues (leitura e gravação) em um repositório, em
GITHUB_ISSUES_TOKEN, e o repositório no formato proprietário/repositório emGITHUB_ISSUES_REPO. Nas configurações, em Integrações, Conectar GitHub Issues mostra a quem o token pertence e oferece apenas os repositórios que ele pode acessar e que têm Issues habilitado (guia passo a passo). - Issues: com
GITHUB_ISSUES_ENABLED=true, uma falha abre uma issue com as etiquetas do chamado, seguindo o ciclo de vida acima. Quando a execução passa sem falhas, a issue recebe um comentário e é fechada como concluída. - Outro repositório: em Chamados, um destino do GitHub pode especificar um proprietário/repositório diferente do definido em
.env.
Slack
- Conectar: uma URL de Incoming Webhook, em
SLACK_WEBHOOK_URL. Settings tem um botão Send test message. - O que ele recebe: mensagens Block Kit: o resumo da execução e, com
NEXUS_SLACK_NOTIFY=true, uma mensagem por teste com falha, flaky, de chaos ou com regressão visual. Uma mensagem sobre uma falha inclui o link da issue do Jira quando houver uma. - Manualmente: o Evidence Locker pode publicar no Slack o resumo em texto de uma falha. O Slack não recebe arquivos.
Microsoft Teams
- Conectar: uma URL de webhook do Workflows para um canal, em
TEAMS_WEBHOOK_URL. O Workflows do Teams exige uma conta corporativa ou de estudante do Microsoft 365. Nas configurações, há a opção Salvar & enviar teste (guia passo a passo). - O que recebe: as mesmas mensagens que o Slack recebe, como Cartões Adaptáveis: o resumo da execução e, com
NEXUS_TEAMS_NOTIFY=true, uma mensagem por teste com falha, instável, de caos ou de regressão visual. - Para onde a URL aponta: apenas para um endereço https nos próprios hosts de webhook da Microsoft (logic.azure.com, webhook.office.com, api.powerplatform.com). Qualquer outra URL é recusada e nada é enviado.
Telegram
- Conectar: um bot seu, criado uma única vez com @BotFather, em
TELEGRAM_TOKEN. Em Settings, Connect by QR pareia seu chat e preencheTELEGRAM_CHAT_ID. Não existe bot compartilhado. - O que ele recebe: alertas de falha, um por teste com
NEXUS_TELEGRAM_NOTIFY=true, e os relatórios e arquivos que você escolher compartilhar a partir do Studio. - Antes de ativar: o Telegram pode receber arquivos, como relatórios e PDFs, e eles vão para os servidores do Telegram. Em um ambiente regulado, consulte antes sua equipe de compliance.
Chamados: quando são abertos, o que contêm, para onde vão
Em Configurações, na seção Integrações, a tela Chamados define o que é registrado no Jira, no Azure Boards ou no GitHub Issues quando um teste falha. A opção Compartilhar do Evidence Locker usa o mesmo modelo. As configurações são salvas em nexus-tickets.config.json no espaço de trabalho, um arquivo sem segredos que você pode manter no seu repositório. Sem esse arquivo, os chamados funcionam conforme descrito acima. Se o arquivo for inválido, os padrões serão aplicados e o registro indicará o motivo.
- Quando: quais resultados abrem um chamado (BREACHED e TIMEOUT por padrão), quantas falhas consecutivas são necessárias para abri-lo, um limite por execução, execuções locais, em CI ou ambas, IDs de testes a incluir ou excluir, o que fazer quando o teste passa sem falhas (fechar, apenas comentar ou nada) e se uma falha recorrente reabre o chamado fechado em vez de abrir um novo.
- O quê: o modelo do título, com
{type},{testId},{browser}e{error.firstLine}.{testId}é obrigatório, pois o título é a chave de identificação de duplicatas por 24 horas. Também define quais seções da descrição enviar e em qual ordem, quanto do erro incluir, rótulos, prioridade por resultado, responsável, componente, campos personalizados e uma nota da equipe. - Anexos: a captura de tela por padrão. O rastreamento, o vídeo e o relatório só serão incluídos se você os selecionar, cada um respeitando o limite de tamanho.
- Onde: um destino por sistema de acompanhamento, cada um com seu próprio controle de ativação. Um destino pode substituir o site, o projeto e o tipo de ocorrência do Jira, o repositório do GitHub ou o tipo de item de trabalho do Azure.
- Prévia e teste: antes de você salvar, a tela mostra, para cada destino, o chamado que sua falha mais recente geraria. Criar chamado de teste registra um chamado real a partir dessa prévia, com o rótulo
nexus-test.
O que um chamado nunca contém
- Apenas o que você selecionar. Uma seção ou um anexo que você não selecionou permanece na sua máquina.
- Os segredos são mascarados primeiro. Cada linha de texto passa por uma etapa de ocultação de dados sensíveis antes de ser registrada: cabeçalhos de autorização e de cookies, tokens bearer e basic, JWTs, formatos conhecidos de chaves de provedores, senhas em URLs e valores de campos com nomes que indicam segredos. Essa etapa detecta os formatos em que os segredos costumam aparecer em registros e erros, mas não todos os segredos que um texto livre pode conter, então mantenha o rastreamento desativado, a menos que precise dele.
- Nenhum token no arquivo.
nexus-tickets.config.jsonrejeita qualquer campo cujo nome indique um segredo e qualquer URL que contenha usuário e senha. Os tokens permanecem em.env.
As chaves
Cada chave é uma linha no .env do workspace. Settings edita todas elas.
| Serviço | Chaves | Padrões |
|---|---|---|
| Jira Cloud | JIRA_ENABLED, JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY, JIRA_DONE_TRANSITION | Desativado; projeto QA; transição 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 | Desativado; tipo Bug; estado Resolved |
| GitHub Issues | GITHUB_ISSUES_ENABLED, GITHUB_ISSUES_REPO, GITHUB_ISSUES_TOKEN | Desativado |
| Anexos da issue | NEXUS_ISSUE_ATTACH_TRACE | Desativado: somente a captura de tela |
| Slack | SLACK_ENABLED, SLACK_WEBHOOK_URL, NEXUS_SLACK_NOTIFY | Desativado |
| Microsoft Teams | TEAMS_ENABLED, TEAMS_WEBHOOK_URL, NEXUS_TEAMS_NOTIFY | Desativado |
| Telegram | TELEGRAM_ENABLED, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID, NEXUS_TELEGRAM_NOTIFY | Desativado |
Em um pipeline, as mesmas chaves, exceto AZURE_PIPELINE_ID, são as variáveis secretas do pipeline, e uma chave que você deixa sem definir mantém o serviço desativado (secrets em CI/CD).
Perguntas
O Nexus StudioQA acessa meus dados do Jira ou do Azure DevOps?
Não. O mecanismo se comunica com Jira, Azure DevOps, GitHub Issues, Slack, Teams e Telegram a partir da sua máquina, com as suas chaves. Nada disso passa pelos nossos servidores.
Um teste FLAKY abre um ticket?
Não. FLAKY não registra nada. BREACHED_FLAKY registra: a falha em si foi inconsistente, e uma nova tentativa não a esconde.
Um teste falhou 30 vezes nesta semana. Quantas issues isso gera?
Uma, com um comentário e uma nova captura de tela para cada falha depois da primeira, até o teste passar limpo em todos os navegadores.
Posso usar Jira, Azure Boards e GitHub Issues ao mesmo tempo?
Sim. Cada um mantém sua própria ocorrência por teste, assim como cada site adicional do Jira.