Configurar integração JIRA por projeto

A integração JIRA sincroniza tasks do Wisework com issues do JIRA do cliente. A configuração é por projeto e exige autenticação na instância JIRA.

Configure a integração

1. Abra Governança → JIRA.
2. Clique em Nova integração.
3. Informe a URL da instância JIRA (cloud: *.atlassian.net, server: URL próprio).
4. Autentique via API token (recomendado) ou OAuth.
5. Escolha o projeto do produto no Wisework.
6. Mapeie status: todo | in_progress | review | done do Wisework → status do JIRA.
7. Configure campos customizados se necessário (ex: story points).
8. Salve e teste com sync manual.

A integração roda em background a cada 15 minutos e em push de mudança.

Nota

Use API token em vez de senha. Atlassian permite tokens com escopo definido; revogue tokens não usados periodicamente.

Erros comuns

Token expirado — Atlassian revoga tokens após algum tempo ou revogação manual. Atualize quando o sync parar de funcionar.

Mapeamento de status errado — in_progress apontando para done no JIRA inverte o sentido. Verifique com sync manual após configurar.

Webhook desabilitado — Wisework precisa de permissão para criar webhooks no JIRA. Sem isso, sync só roda no polling.

Sem projeto correspondente — projeto JIRA precisa existir antes da configuração. Crie no JIRA primeiro.

URL errada — cloud JIRA usa *.atlassian.net; on-premise usa URL próprio. Errar aqui impede autenticação.

Mapeamento de campos custom esquecer — campos custom do JIRA ficam vazios se não mapeados. Defina no config ou viva com o defeito.