Jira Issue Handler

Jira Issue Handler conecta tu flujo con tu Jira Cloud para hacer cambios: crear incidencias y subtareas, modificarlas o eliminarlas, y gestionar sus comentarios, archivos adjuntos, seguidores y vínculos con otras incidencias.

Es útil cuando el trabajo nace fuera de Jira, por ejemplo en un formulario de soporte, un correo o una conversación con un agente de IA, y quieres que quede registrado como incidencia sin copiarlo a mano.

Cuándo usarlo

Cada error que un cliente reporta por el formulario de soporte debe crear una incidencia de tipo Bug.
Un agente de IA atiende al equipo y crea o actualiza incidencias cuando se lo piden.
Un cliente responde por correo y quieres añadir su respuesta como comentario en la incidencia.
Quieres adjuntar a la incidencia los archivos que llegan con una petición.
Una incidencia depende de otra y quieres vincularlas como “Blocks”.

Configuración

Necesitas una credencial Jira API con la dirección de tu Jira Cloud, el correo de tu cuenta de Atlassian y un token de API. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Jira API con la que se accede a tu Jira.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `Create Issue`.
Mode	`Basic` muestra solo los campos imprescindibles; `Advanced` añade Description, Priority, Issue Status, Assignee Account ID, Comment y Custom Fields. Por defecto, `Basic`. En las operaciones de incidencias y subtareas.
Project Key	El proyecto de Jira. Al elegir la credencial, la lista muestra tus proyectos. Obligatorio para crear. En las operaciones de incidencias y subtareas.
Issue Summary	El título de la incidencia. Obligatorio en `Create Issue` y `Create Subtask`; en `Update Issue` y `Update Subtask`, solo si quieres cambiarlo.
Issue Type	El tipo de incidencia (Task, Bug, Epic…). La lista muestra los tipos del proyecto elegido; al crear una subtarea, solo los de subtarea. En las operaciones de incidencias y subtareas.
Issue Key	La clave de la incidencia, por ejemplo `PROJ-123`. En todas las operaciones salvo `Create Issue`, `Create Subtask`, `Delete Attachment` y `Delete Issue Link`.
Issue Parent Key	La clave de la incidencia de la que cuelga la subtarea. En `Create Subtask` y `Update Subtask`.
Comment ID	El identificador del comentario. En `Update Comment` y `Delete Comment`.
Files	Los archivos que se adjuntan, conectados desde otro componente. Solo en `Add Attachment`.
Attachment ID	El identificador del adjunto que quieres eliminar. Solo en `Delete Attachment`.
Watcher Account ID	El identificador de cuenta de la persona que empieza o deja de seguir la incidencia. En `Add Watcher` y `Remove Watcher`.
Target Issue Key	La clave de la otra incidencia del vínculo. Solo en `Create Issue Link`.
Link Type	El tipo de vínculo, por ejemplo Blocks o Duplicates. Solo en `Create Issue Link`.
Issue Link ID	El identificador del vínculo que quieres eliminar. Solo en `Delete Issue Link`.

Campos del modo Advanced

En Create Issue, Update Issue, Create Subtask y Update Subtask, con Mode en Advanced:

Campo	Qué hace
Description	La descripción detallada de la incidencia.
Priority	La prioridad (Low, Medium, High…). La lista muestra las del proyecto. No aparece en subtareas ni en épicas.
Issue Status	El estado al que pasa la incidencia (To Do, In Progress, Done…). No aparece en subtareas ni en épicas.
Assignee Account ID	El identificador de cuenta de la persona asignada. Lo obtienes con la operación `List Users` de Jira Reader.
Comment	Un comentario que se añade a la incidencia al modificarla.
Custom Fields	Valores de los campos personalizados de tu Jira, por ejemplo `{"customfield_10001": "valor"}`.

Operaciones

Operación	Qué hace
`Create Issue`	Crea una incidencia en un proyecto.
`Update Issue`	Cambia los datos de una incidencia. Solo se modifican los campos que rellenes.
`Create Subtask`	Crea una subtarea dentro de una incidencia.
`Update Subtask`	Cambia los datos de una subtarea.
`Delete Issue / Subtask`	Elimina una incidencia junto con sus subtareas.
`Add Comment`	Añade un comentario a una incidencia.
`Update Comment`	Cambia el texto de un comentario.
`Delete Comment`	Elimina un comentario.
`Add Attachment`	Adjunta uno o varios archivos a una incidencia.
`Delete Attachment`	Elimina un archivo adjunto.
`Add Watcher`	Añade una persona a los seguidores de una incidencia.
`Remove Watcher`	Quita a una persona de los seguidores.
`Create Issue Link`	Vincula dos incidencias con el tipo de vínculo elegido.
`Delete Issue Link`	Elimina un vínculo entre incidencias.

Resultado

La salida Jira Response devuelve el resultado de la operación: al crear o modificar, la clave de la incidencia, su título, descripción, tipo, prioridad, estado y persona asignada; en las demás operaciones, una confirmación con la clave de la incidencia y lo que se ha hecho. En Add Attachment sale un elemento por cada archivo adjuntado.

Puedes conectar el resultado a un componente de correo o de mensajería para avisar con la clave de la incidencia, o a un agente para que lo use en su respuesta. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.

Ejemplo

Un equipo de soporte quiere que cada error reportado por un cliente cree una incidencia en Jira.

El formulario de soporte llega al flujo con el título y la descripción del problema.
Añade Jira Issue Handler con la operación Create Issue y Mode en Advanced.
Elige el proyecto en Project Key y Bug en Issue Type; pon el título en Issue Summary y la descripción en Description.
Conecta Jira Response a un componente de correo que envíe al cliente la clave de su incidencia.

Buenas prácticas

Delete Issue / Subtask elimina también todas las subtareas y no se puede deshacer.
Los identificadores de cuenta de las personas se consultan con Jira Reader, operación List Users.

Componentes relacionados

Jira Reader: consulta incidencias, proyectos y usuarios.
Jira Webhook: pone en marcha un flujo cuando ocurre algo en Jira.