Integração com o Jira
Conecte a Threada ao Jira para criação e atualização governadas de issues a partir de WorkItems, com transferências de fluxo de trabalho auditáveis.
Visão geral
A integração com o Jira permite que a Threada crie e atualize issues do Jira como ações governadas. O contexto do WorkItem — evidências, decisões e resultados de políticas — flui automaticamente para o Jira.
Capacidades
- Criar issues a partir de escalonamentos de WorkItem com contexto estruturado
- Atualizar issues do Jira — adicionar comentários e conduzir transições — a partir de ações governadas
- Mapear projetos, tipos de issue e campos personalizados
- Vincular WorkItems e evidências relacionados a issues do Jira
- Trilha de auditoria para cada operação de issue
Um exemplo prático
Um fluxo de ponta a ponta que a Threada executa com o Jira:
- Uma solicitação chega por e-mail, Slack ou formulário e se torna um WorkItem governado, com um schema tipado e evidências citadas.
- A política determina que o trabalho precisa de uma tarefa de engenharia rastreada, e um aprovador autoriza por meio de uma etapa de decisão explícita.
- A Threada cria uma issue no Jira como uma ação governada — projeto, tipo de issue e campos mapeados — com o contexto do WorkItem e as evidências anexados.
- A Threada pode conduzir transições de issues do Jira como ações governadas, e cada operação é registrada na trilha de auditoria do WorkItem.
Configuração
Configure a integração no Studio, na governança do pack. Forneça credenciais da API do Jira com permissões restritas ao projeto e mapeie campos para o schema do seu fluxo de trabalho.
- No Studio, adicione a integração do Jira na governança do pack.
- Forneça credenciais da API do Jira com escopo restrito aos projetos específicos nos quais a Threada pode escrever.
- Mapeie projetos, tipos de issue e campos personalizados do Jira para o schema do seu WorkItem.
- Valide a conexão; a integração só é ativada após a escrita de teste ser bem-sucedida.
Permissões e acesso a dados
O Jira usa credenciais que você fornece — não um app OAuth hospedado pela Threada.
- A Threada se autentica com um token da API do Jira que você fornece, com escopo restrito aos projetos específicos nos quais pode escrever, armazenado no Secret Manager.
- A Threada chama a REST API do Jira para criar e atualizar issues e conduzir transições; ela não lê o status do Jira de volta para o WorkItem.
- Cada operação de issue roda como uma ação governada e é registrada na trilha de auditoria do WorkItem.
Perguntas frequentes
A Threada cria issues no Jira automaticamente?
Apenas sob política. A criação de issues roda como uma ação governada, então o fato de ela ser disparada automaticamente ou aguardar um aprovador é decidido pela sua sobreposição de políticas. Cada issue que a Threada cria carrega o contexto do WorkItem e entra na trilha de auditoria.
A Threada lê as transições do Jira de volta para o WorkItem?
Atualmente não. A Threada escreve no Jira — criando issues, adicionando comentários e conduzindo transições como ações governadas. A sincronização de entrada do status do Jira de volta ao WorkItem não é suportada hoje.
De qual acesso a integração precisa?
Credenciais da API do Jira com escopo restrito aos projetos específicos nos quais a Threada pode escrever — privilégio mínimo. A conexão é validada antes da ativação, e cada operação de issue é registrada.