Jira (Atlassian)

Descripción

Los nodos Jira conectan tus workflows con Jira Cloud a través de su API REST v3. Con ellos podés automatizar la gestión de incidencias: crear un ticket cuando llega un formulario, comentar cuando cambia un estado, buscar incidencias por JQL, o mover una incidencia de columna.

Hay seis nodos, uno por operación:

Nodo	Operación	Método HTTP
Jira: Crear incidencia (jiraCreateIssue)	Crea una incidencia	POST /issue
Jira: Leer incidencia (jiraGetIssue)	Lee una incidencia por su clave	GET /issue/{key}
Jira: Actualizar incidencia (jiraUpdateIssue)	Actualiza campos	PUT /issue/{key}
Jira: Buscar (JQL) (jiraSearchIssues)	Busca por JQL	POST /search/jql
Jira: Comentar incidencia (jiraAddComment)	Agrega un comentario	POST /issue/{key}/comment
Jira: Cambiar estado (jiraTransitionIssue)	Ejecuta una transición	POST /issue/{key}/transitions

Credencial

Los nodos usan una credencial de tipo Jira (Atlassian). Creala en Credenciales → Agregar → Jira (Atlassian) con estos campos:

Campo	Descripción
URL de tu Jira	La URL de tu sitio Atlassian, sin barra final (ej. https://tu-dominio.atlassian.net). El nodo agrega /rest/api/3 automáticamente.
Email de la cuenta	El email de la cuenta Atlassian dueña del API token.
API token	Se genera en id.atlassian.com → Seguridad → Tokens de API. Nunca se muestra en logs.

La autenticación es Basic (email:api_token). Podés probar la credencial con el botón Test, que llama a GET /myself y confirma el usuario.

Nota importante: formato ADF

La API v3 de Jira exige que los campos de texto enriquecido (descripción y comentarios) vayan en Atlassian Document Format (ADF, un JSON), no como texto plano. Los nodos convierten tu texto a ADF automáticamente — vos escribís texto normal (con saltos de línea si querés) y el nodo se encarga del resto.

Nodos

Jira: Crear incidencia (jiraCreateIssue)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Jira
project_key	texto	Sí	Clave del proyecto (ej. OPS)
issue_type	texto	No	Tipo (Task, Bug, Story…). Por defecto Task
summary	texto	Sí	Título de la incidencia
description	texto	No	Descripción (se convierte a ADF)
extra_fields	JSON	No	Campos extra, ej. {"priority":{"name":"High"}}

Salida: el objeto que devuelve Jira, incluyendo key (ej. OPS-123) e id.

Jira: Leer incidencia (jiraGetIssue)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Jira
issue_key	texto	Sí	Clave de la incidencia (ej. OPS-123)
fields	texto	No	Campos a devolver, separados por coma

Jira: Actualizar incidencia (jiraUpdateIssue)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Jira
issue_key	texto	Sí	Clave de la incidencia
fields	JSON	Sí	Campos a actualizar, ej. {"summary":"Nuevo título"}

Si incluís description como texto plano dentro de fields, se convierte a ADF automáticamente.

Jira: Buscar (JQL) (jiraSearchIssues)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Jira
jql	texto	Sí	Consulta JQL (ej. project = OPS AND status = "To Do")
max_results	número	No	Máximo de resultados (por defecto 50)
fields	texto	No	Campos a devolver, separados por coma

Salida: el array de incidencias que coinciden con la consulta.

Jira: Comentar incidencia (jiraAddComment)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Jira
issue_key	texto	Sí	Clave de la incidencia
comment	texto	Sí	Texto del comentario (se convierte a ADF)

Jira: Cambiar estado (jiraTransitionIssue)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Jira
issue_key	texto	Sí	Clave de la incidencia
transition	texto	Sí	Id de transición (ej. 31) o nombre (ej. In Progress)

Transición por nombre

Los ids de transición dependen del flujo de cada proyecto. Si escribís un nombre en vez de un id, el nodo consulta las transiciones disponibles de la incidencia y lo resuelve solo. Si el nombre no existe, el error te lista las transiciones válidas.

Ejemplo

Crear un bug en el proyecto OPS con el título que llegó de un formulario:

• Nodo: Jira: Crear incidencia
• project_key: OPS
• issue_type: Bug
• summary: {{data.asunto}}
• description: {{data.detalle}}

Salida:

{
  "id": "10042",
  "key": "OPS-123",
  "self": "https://tu-dominio.atlassian.net/rest/api/3/issue/10042"
}

Manejo de errores

Cada nodo clasifica los errores para que el motor sepa si tiene sentido reintentar:

Situación	Reintentable	Qué hacer
Validación (400/422)	No	Jira devuelve el motivo (ej. campo obligatorio o tipo de incidencia inexistente). Corregí los datos.
No encontrado (404)	No	La incidencia o el proyecto no existen. Revisá la clave.
Autenticación (401/403)	No	Email o API token inválidos, o sin permiso sobre el proyecto. Revisá la credencial.
Servidor (500)	Sí	Error temporal de Jira; se reintenta automáticamente.
Límite de tasa (429)	Sí	Se respeta el Retry-After de Jira y se reintenta.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Los errores de validación no se reintentan

Un dato mal cargado no se reintenta: reintentar con lo mismo solo repetiría el fallo. Corregí la entrada y volvé a ejecutar. Podés ver los reintentos automáticos en el panel de Reintentos (DLQ).

Ver también

• Asana — el equivalente para gestión de tareas y proyectos.
• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para endpoints de Jira no cubiertos por estos nodos.