Jira

Crie automaticamente issues no Jira quando incidentes são abertos, sincronize transições de status e espelhe comentários da timeline entre o Batida e o Jira.

Configuração

1. Vá em Configurações > Integrações > Jira no painel do Batida.
2. Insira a URL do site Jira (ex.: https://sua-equipe.atlassian.net).
3. Gere um API token em configurações da conta Atlassian.
4. Insira o API token junto com seu email do Jira.
5. Selecione o projeto padrão e o tipo de issue (Bug, Task ou Incident).
6. Clique em Salvar e Verificar.

URL do site: https://sua-equipe.atlassian.net
Email:       voce@empresa.com
API Token:   ATATT3xFfGF0...

API token vs senha

A Atlassian não aceita mais senhas para autenticação via API. Você deve usar um API token gerado na sua conta Atlassian.

Criação automática de issues

Quando um incidente é aberto no Batida, um issue do Jira é criado automaticamente com o seguinte mapeamento:

Campo do Batida	Campo do Jira
Título do incidente	Summary do issue
Descrição	Descrição do issue
Severidade	Prioridade (critical = Highest, high = High, ...)
Respondente atribuído	Assignee (correspondido por email)
Equipe	Componente ou label do projeto

A chave do issue no Jira (ex.: OPS-142) é armazenada no registro do incidente e exibida na interface do Batida.

Sincronização de status

As transições de status são sincronizadas bidirecionalmente:

• Batida para Jira: Quando o status de um incidente muda no Batida (investigando, identificado, monitorando, resolvido), o issue do Jira transita por um workflow configurado. Mapeamento padrão:

  Status no Batida	Transição no Jira
  Aberto	To Do -> In Progress
  Identificado	In Progress -> In Review
  Resolvido	In Review -> Done

• Jira para Batida: Quando um issue do Jira é transitado para Done, o incidente vinculado no Batida é automaticamente marcado como resolvido.

Mapeamento de workflow personalizado

Você pode personalizar o mapeamento de status em Configurações > Integrações > Jira > Mapeamento de Workflow para corresponder aos estados do workflow do seu projeto Jira.

Comentários da timeline

Cada comentário adicionado à timeline do incidente no Batida é postado como comentário no issue vinculado do Jira. O comentário inclui o nome do autor, timestamp e o conteúdo.

Troubleshooting

• "Autenticação inválida": Verifique seu API token e email. Regenere o token se necessário.
• Issues não criados: Verifique se a chave do projeto selecionado é válida e se o tipo de issue existe naquele projeto.
• Sincronização de status não funciona: Confirme se os nomes das transições de workflow correspondem à configuração do projeto Jira. Use a tela de mapeamento de workflow para ajustar.