--- title: "Integração Jira — Tickets por Chat" url: "https://openclaw.ia.br/integracoes/jira/" markdown_url: "https://openclaw.ia.br/integracoes/jira.MD" description: "Gerencie tickets, sprints e projetos do Atlassian Jira diretamente pelo chat. Crie issues, atualize status e acompanhe o progresso." date: "" author: "" --- # Integração Jira — Tickets por Chat Gerencie tickets, sprints e projetos do Atlassian Jira diretamente pelo chat. Crie issues, atualize status e acompanhe o progresso. # Integração com Jira O Jira é a ferramenta de gestão de projetos mais usada por times de desenvolvimento de software no mundo. Sprints, backlogs, épicos, stories, bugs — tudo passa pelo Jira em equipes que trabalham com metodologias ágeis. Mas abrir o navegador, navegar até o projeto certo e registrar uma issue interrompe constantemente o fluxo de trabalho dos desenvolvedores e gestores. Com a integração do OpenClaw ao Jira, você gerencia tickets, acompanha sprints e recebe relatórios de progresso diretamente pelo chat. Funciona no WhatsApp, Telegram ou Discord — onde sua equipe já está comunicando. Registre um bug durante um code review, verifique o sprint antes do standup, tudo sem sair do contexto do trabalho. ## O Que É Possível Fazer - **Criar tickets** com título, descrição, tipo, prioridade e epico em linguagem natural - **Atualizar status** de issues — mova para In Progress, In Review, Done e outros status do seu workflow - **Consultar e buscar issues** por texto, assignee, label, status ou sprint - **Gerenciar o sprint** — veja o progresso, story points restantes e itens bloqueados - **Adicionar comentários** em tickets existentes sem abrir o navegador - **Receber relatórios automatizados** — standup diário, resumo de sprint e alertas de SLA - **Triagem de backlog** — consulte e priorize itens pendentes com comandos simples - **Integração com Discord** — notificações de Jira em canais específicos do seu [servidor](/integracoes/discord/) ## Como Configurar ### Passo 1: Criar API Token no Atlassian 1. Acesse [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens) 2. Clique em "Create API token" 3. Dê um nome descritivo (ex: "OpenClaw - Jira") 4. Clique em "Create" e copie o token gerado (ele aparece apenas uma vez) ### Passo 2: Configurar no OpenClaw ```bash openclaw config set jira.domain "sua-empresa.atlassian.net" openclaw config set jira.email "seu@email.com" openclaw config set jira.token "seu-api-token" openclaw config set jira.project "PROJ" # código do projeto padrão ``` Ou via arquivo de configuração: ```yaml integrations: jira: domain: "sua-empresa.atlassian.net" email: "seu@email.com" token: "SEU_API_TOKEN" defaultProject: "PROJ" notifyChannel: "discord" # canal para alertas automáticos slaHighPriorityHours: 24 # horas para alertar tickets de alta prioridade parados ``` ### Passo 3: Testar a Conexão ``` Liste os tickets abertos no Jira ``` ### Passo 4: Configurar Automações ``` Todo dia às 9h, me mande o resumo do standup com meus tickets e os do time Me avise quando um ticket de prioridade alta ficar sem atualização por 24h ``` ## Exemplos Práticos ### 1. Criar Bug Rapidamente Durante Code Review Você está fazendo review de código e encontra um problema. Sem sair do editor: ``` Você: "Cria bug no Jira: NPE ao salvar usuário sem email confirmado, prioridade alta, componente: User Service, reprodução: criar conta sem confirmar email e tentar acessar o perfil" Bot: "Issue PROJ-847 criada: Bug: NPE ao salvar usuário sem email confirmado Prioridade: Alta | Componente: User Service Status: To Do | Sprint: Sprint 23 Link: https://sua-empresa.atlassian.net/browse/PROJ-847" ``` ### 2. Standup Diário Automatizado Configure para receber às 9h todos os dias: ``` Bot: "Standup — Terça, 22/03: ✅ Concluído ontem: • PROJ-831: Implementar validação de CPF (@joao) • PROJ-835: Fix timeout no checkout (@ana) ▶ Em andamento hoje: • PROJ-839: Dark mode — UI (@carlos) — Em Review • PROJ-842: Integração gateway de pagamento (@joao, @ana) • PROJ-845: Testes de carga — módulo de pedidos (@carlos) Bloqueados (2): • PROJ-840: Aguardando credenciais do banco (responsável: @joao) • PROJ-844: Dependência de PROJ-839 não concluída" ``` ### 3. Relatório de Sprint na Sexta Configure para receber toda sexta às 17h: ``` Bot: "Relatório Sprint 23 — Encerramento: Story Points: • Planejados: 42 | Entregues: 38 | Pendentes: 4 ✅ Concluídas: 14 issues ⏭ Transbordadas para Sprint 24: 2 issues (PROJ-844, PROJ-845) Contribuidores: • @ana: 15 SP | @joao: 13 SP | @carlos: 10 SP Bloqueadores principais desta sprint: • Atraso na entrega de credenciais externas (3 dias perdidos)" ``` ### 4. Triagem de Backlog por PM ``` Você: "Quantos bugs temos no backlog classificados por prioridade?" Bot: "Bugs no backlog — PROJ: Críticos: 2 • PROJ-801: Falha na autenticação SSO • PROJ-819: Dados corrompidos em exportação Altos: 8 (listar todos?) Médios: 23 Baixos: 41 Total: 74 bugs abertos" ``` ### 5. Alerta de SLA em Produção ``` Bot: "⚠ Alerta de SLA! PROJ-801 — Falha na autenticação SSO Prioridade: Crítica Tempo sem atualização: 28 horas (SLA: 24h) Assignee: @maria Status atual: In Progress Quer notificar @maria ou o gerente do projeto?" ``` ## Dicas Avançadas **JQL via chat:** O OpenClaw aceita queries JQL diretamente. "Busque tickets: assignee = currentUser() AND sprint in openSprints() AND status = 'In Progress'" retorna exatamente o que você precisa, sem precisar lembrar a sintaxe — basta descrever em português e o OpenClaw traduz. **Templates de issues para tipos frequentes:** Peça ao OpenClaw para memorizar estruturas de issues comuns. "Bug de performance" já preenche o template com passos de reprodução, ambiente e métricas necessárias. Reduz o tempo de criação de tickets. **Integração com Confluence:** Vincule automaticamente issues a páginas de documentação relevantes no Confluence. "Ao criar uma feature, adicione link para a spec técnica no Confluence" mantém tudo conectado. **Notificações em canais de Discord:** Configure o [Discord](/integracoes/discord/) para receber notificações específicas por canal: bugs críticos vão para `#alertas-urgentes`, PRs prontos para review vão para `#code-review`, deploys vão para `#deploys`. **Integração com GitHub:** Conecte PRs do [GitHub](/integracoes/github/) a issues do Jira. Quando um PR for aberto mencionando "PROJ-XXX", o status do ticket é atualizado automaticamente para "In Review". **Consulte o [glossário](/glossario/) para entender termos como Story Points, JQL e Sprint Velocity**. ## FAQ **O OpenClaw funciona com Jira Cloud e Jira Data Center?** A integração foi desenvolvida e testada para o Jira Cloud (Atlassian Cloud). Para Jira Data Center (on-premise), a API tem diferenças e pode requerer configuração adicional. **Posso criar subtasks pelo chat?** Sim. Especifique no comando: "Cria subtask de PROJ-847: Adicionar logs de erro no módulo de usuário". O OpenClaw cria a issue filha vinculada ao ticket pai. **O bot pode vincular issues a épicos?** Sim. "Cria story vinculada ao épico EP-12: Implementar exportação de relatório em PDF". O OpenClaw faz a vinculação automaticamente ao criar a issue. **Como funciona com múltiplos projetos no mesmo Jira?** O OpenClaw acessa todos os projetos que sua conta tem permissão de ver. Especifique o código do projeto nos comandos quando necessário: "Quais issues abertas no projeto BACKEND?". **O OpenClaw pode fechar issues em lote?** Sim, com confirmação. "Feche todas as issues da milestone v1.5 com resolução Done" lista as issues que serão afetadas e pede confirmação antes de executar. ## Próximos Passos - [Integração Discord](/integracoes/discord/) — notificações do Jira em canais do servidor - [Integração GitHub](/integracoes/github/) — vincule PRs a issues do Jira automaticamente - [Guias para times de engenharia](/guias/) — workflows ágeis com Jira + OpenClaw - [Canais disponíveis](/canais/) — acesse o Jira pelo WhatsApp, Telegram ou Discord - [Como usar o OpenClaw](/como-usar/) — configuração inicial e personalização