Jira no n8n: automatize issues e comentários
Escolha a versão do Jira, crie o token, use o nó Jira Software para issues, status e comentários e saiba o que o Jira Trigger exige para receber eventos.
Por Redação Eleven Host · @robson.direitodigital · 17 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o tutorial: Jira no n8n: automatize issues e comentários Arte: Eleven Host
Usar Jira no n8n é ligar seus chamados e tarefas aos fluxos: o nó Jira Software cria issues, comenta, anexa arquivos e lista resultados por JQL, e o Jira Trigger inicia um fluxo quando algo acontece no Jira.
No Jira Software do n8n, mudar o status de uma issue é feito em Update > Status; a operação chamada Status só mostra as transições possíveis.
Atualizado em 17/11/2026. Em 17/11/2026, na versão estável n8n 2.48.4, o nó se chama Jira Software, tem a versão 1 e não leva a marca Beta. O Jira Trigger tem as versões 1 e 1.1. Os dois são do n8n, não da Atlassian.
O que o nó Jira Software faz
No campo Resource, o padrão é Issue, e as opções são Issue, Issue Attachment, Issue Comment e User. Em Issue, a operação padrão é Create, e as outras são Changelog, Delete, Get, Get Many, Notify, Status e Update. Issue Comment começa em Add. Issue Attachment e User completam a lista, com Add, Get, Get Many e Remove no primeiro, e Create, Delete e Get no segundo.
Não existe um recurso Project. O nó escolhe o projeto ao criar uma issue e filtra por projeto com JQL, mas não cria nem edita projeto. Para o que o nó não faz, dá para usar o HTTP Request com Predefined Credential Type e a mesma credencial. Nesta versão, a operação de listagem se chama Get Many no editor, e não Get All.
Para quem serve
Serve para equipes que usam o Jira e querem que formulários, chamados e rotinas virem issues sem digitação, ou querem aviso quando uma issue muda. Quando o n8n fica num servidor próprio, vale entender o básico no artigo O que é servidor VPS: guia simples para iniciantes.
Contratar uma VPS da Eleven Host é feito direto pela loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja
Passo 1: escolher a Jira Version
O primeiro campo do nó é Jira Version, com Cloud como padrão. As opções são Cloud, Cloud (OAuth2), Cloud (Service Account), Server (Self Hosted) e Server Pat (Self Hosted). Cada uma mostra uma credencial diferente, como a Jira SW Cloud API para a opção Cloud.
O Jira Trigger tem só quatro dessas opções, sem Cloud (Service Account).
Passo 2: criar o token e a credencial
No Jira Cloud, abra id.atlassian.com, vá em Security > API tokens e clique em Create API token. Dê um nome, defina a validade e clique em Create. Copie o token na hora, porque a Atlassian informa que ele não pode ser visto de novo.
No n8n, crie a credencial Jira SW Cloud API com três campos: Email, o e-mail da conta Jira; API Token, o valor copiado; e Domain, o endereço do site, como https://example.atlassian.net.
Validade e tipo do token
- A validade padrão de um token novo é de 1 ano, ajustável de 1 a 365 dias. Recomendamos anotar a data de vencimento.
- A Atlassian recomenda token com escopo, que usa o endereço
api.atlassian.com/ex/jira/{cloudId}. A credencial Jira SW Cloud API chama o Domain direto, e por isso recomendamos o token clássico. Por isso, o token com escopo pode não funcionar nela.
No Server ou Data Center, há duas credenciais: Jira SW Server API, com Email, Password e Domain, e Jira SW Server (PAT) API, com Personal Access Token e Domain. Escolha a opção que combina em Jira Version.
Passo 3: criar uma issue
Num nó Jira Software, deixe Resource em Issue e Operation em Create. Os campos obrigatórios vêm nesta ordem: Project, por lista pesquisável ou ID numérico; Issue Type; e Summary.
Em Additional Fields ficam, entre outros: Assignee, Description, Component Names or IDs, Custom Fields, Label Names or IDs no Cloud ou Labels no Server, Parent Issue Key, Priority e Reporter.
Use Priority só se o campo estiver na tela do tipo de issue do projeto. Quando não está, o nó avisa que é preciso adicionar o campo Priority aos tipos de issue do projeto, e essa mudança é feita no próprio Jira.
Passo 4: mudar o status e outras operações da issue
Para mudar o status, use Issue > Update, informe o Issue Key e, em Update Fields, escolha Status, que é uma transição, por lista ou ID. A operação Issue > Status só devolve as transições disponíveis para a issue. Ela serve para descobrir as transições, e não para alterar nada.
No Delete, a opção Delete Subtasks vem desligada.
Passo 5: comentar e anexar arquivos
Em Issue Comment > Add, informe o Issue Key e o texto no campo Comment. Com JSON Parameters ligado, o campo muda para Document Format (JSON), em ADF.
Em Issue Attachment > Add, os campos obrigatórios são o Issue Key e o Input Binary Field, cujo padrão é data.
Passo 6: listar issues com Get Many e JQL
Em Issue > Get Many, o Return All vem desligado, e o Limit tem padrão 50 e máximo 100. Em Options, está a opção JQL. Para pegar as issues de um projeto, a documentação do n8n sugere ligar o Return All e usar no JQL o valor project=n8n, trocando n8n pelo projeto.
Passo 7: reagir a eventos com o Jira Trigger
O Jira Trigger inicia o fluxo quando ocorrem eventos no Jira. No campo Events, de múltipla escolha, as credenciais Cloud e Server oferecem, entre outros, Issue Created, Issue Updated, Issue Deleted e Comment Created. Em Additional Fields, o Filter recebe JQL, como Project = JRA AND resolution = Fixed.
Para quem executa, a ordem é esta:
- deixe o n8n numa URL pública com HTTPS e certificado válido, por exemplo atrás de um proxy reverso, e aponte a variável
N8N_WEBHOOK_URLpara ela; a variável antigaWEBHOOK_URLestá obsoleta desde o n8n 2.35.0; - use uma credencial de um usuário com a permissão global Administer Jira, porque criar webhook exige essa permissão; sem ela, recomendamos pedir ao administrador do Jira ou usar OAuth2;
- ao ativar o fluxo, o n8n cria o webhook no Jira, e ao desativar ele o apaga;
- depois de ajustar a autenticação do webhook, descrita logo abaixo, recomendamos testar com a URL de teste, ativar o fluxo e conferir no Jira, em Settings > System > Advanced > WebHooks, se o webhook apareceu.
Com Cloud (OAuth2), o n8n usa webhooks dinâmicos, que expiram em 30 dias e que o n8n renova. A lista de eventos é menor, sem eventos de Project, Board, User e Worklog, e o Filter com JQL passa a ser obrigatório.
Autenticação do webhook e entrega
No Jira Trigger versão 1.1, a opção Authenticate Incoming Webhook vem desligada. Recomendamos ligá-la e escolher, em Credentials to Authenticate Webhook, uma credencial do tipo Query Auth; ela funciona como um parâmetro secreto na URL.
A Atlassian aceita só URLs HTTPS com certificado de autoridade confiável e reentrega o webhook até 5 vezes, com espera de 5 a 15 minutos, em casos como erro 5xx e falha de conexão. Por isso, recomendamos usar o evento como aviso e conferir por Get Many quando o dado for crítico.
Limites de requisição e erro 429
No Jira Cloud, quando qualquer limite é excedido, a Atlassian devolve HTTP 429 Too Many Requests, com o cabeçalho Retry-After, em segundos. Há também um limite de escrita por issue: 20 escritas em 2 segundos e 100 em 30 segundos. A aplicação dos limites por pontos a apps começou em 02/03/2026. Esses números são os que a Atlassian descreve para apps, e não é certo que valham para o seu token.
O nó Jira não trata o 429, não lê o Retry-After e não tenta de novo: o erro sobe para o fluxo. A Atlassian recomenda respeitar o Retry-After e usar espera exponencial. Com muitos itens, recomendamos um nó Loop Over Items com um nó Wait entre os lotes, a opção Retry On Fail nas configurações do nó, com espera de alguns segundos, e poucos Updates seguidos na mesma issue.
Combinações para começar
Um exemplo: formulário vira issue. Um Form Trigger do n8n recebe o pedido, e Issue > Create abre a issue com o assunto em Summary e a mensagem em Description. Para issues de repositório de código, veja GitHub no n8n: automatize issues e repositórios.
Um exemplo: issue criada avisa a equipe. Um Jira Trigger com o evento Issue Created e o Filter project = OPS leva a uma mensagem para a equipe com a chave e o resumo da issue.
Um exemplo: relatório diário. Um Schedule Trigger chama Issue > Get Many com Return All ligado e o JQL project = OPS AND status != Done AND duedate < now(), e o resultado segue num resumo por e-mail. Esse caminho serve também sem URL pública. Para tarefas e listas em outra ferramenta, veja ClickUp no n8n: automatize tarefas e listas.
Problemas comuns
- O Jira Trigger falha ao ativar: confira se o usuário tem Administer Jira e se a URL é pública, com HTTPS e certificado válido;
- O status não muda: a mudança é em Update > Status;
- Erro 429: use lotes com Wait e Retry On Fail.
Onde o n8n fica instalado
O n8n que recebe os eventos precisa estar instalado em algum servidor com acesso pela internet.
Volume de fluxos e de dados ajuda a escolher o tamanho da VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver a loja
Perguntas frequentes
O nó Jira do n8n cria projetos?
Não. Os recursos são Issue, Issue Attachment, Issue Comment e User. O projeto aparece só como destino ao criar a issue e como filtro por JQL.
Um usuário comum consegue ativar o Jira Trigger com token?
Não. A Atlassian diz que criar webhook é com um usuário que tem a permissão global Administer Jira.
O token da Atlassian vence?
Sim. A validade vai de 1 a 365 dias, com padrão de 1 ano.
O webhook do Jira chega com certeza?
Não há essa promessa: a Atlassian reentrega até 5 vezes, e o evento serve como aviso.