Conectar Jira y vincular incidencias a tickets

Conectar tu sitio de Jira

Necesitas el permiso Gestionar integraciones, que tienen los administradores.

1. Abre Configuración > Integraciones > Jira y haz clic en Conectar Jira.
2. Inicia sesión en Atlassian, elige tu sitio en la pantalla de Atlassian y acepta.
3. Si tu cuenta de Atlassian tiene acceso a más de un sitio de Jira, Deskwoot te muestra Elige tu sitio de Jira. Haz clic en Usar este sitio junto al que usa tu equipo.
4. En Valores predeterminados para incidencias nuevas, elige un Proyecto, un Tipo de incidencia y, si quieres, un Componente, y luego haz clic en Guardar. Los agentes pueden elegir otra cosa para cada incidencia.

Conectar tu propia cuenta de Atlassian

Una incidencia creada desde Deskwoot se crea con la cuenta de Atlassian del agente que la crea, así que lleva su nombre en Jira y sigue sus permisos de Jira. Cada agente conecta su cuenta una sola vez en Configuración > Perfil > Cuentas conectadas con Conectar cuenta de Atlassian, o directamente en el cuadro de diálogo la primera vez que crea una incidencia. La persona que conectó el sitio para el espacio de trabajo no necesita una segunda conexión. Ver y vincular incidencias funciona sin ella.

Vincular una incidencia existente

1. Abre el ticket. La sección Incidencias vinculadas está en la pestaña Detalles del ticket, a la derecha.
2. Haz clic en Vincular incidencia y busca por la clave de la incidencia, como TAB-123, o por palabras del título.
3. Elige la incidencia. Deskwoot escribe una línea en el ticket, y la incidencia recibe en Jira un enlace de vuelta al ticket.

Un ticket puede tener varias incidencias, y una incidencia puede estar vinculada a muchos tickets, por ejemplo cuando muchos clientes reportan el mismo error. Para quitar un vínculo, haz clic en la X junto a la incidencia y confirma. El enlace de vuelta al ticket también se quita en Jira.

Crear una incidencia nueva

1. En Incidencias vinculadas, haz clic en Crear incidencia. El título y la descripción empiezan con el título y el resumen del ticket.
2. Haz clic en Redactar informe de error con Copilot para que Copilot escriba un informe para los desarrolladores a partir del título, el resumen, el contexto y los comentarios del ticket. Copilot no recibe el nombre del cliente y tiene la instrucción de dejar fuera los datos personales, y el borrador cuenta como uso de Copilot igual que los demás borradores de Copilot.
3. Revisa el Proyecto, el Tipo de incidencia y el Componente, y luego haz clic en Crear incidencia.

El texto se copia en Jira y sale de Deskwoot. Si eliminas o exportas los datos de un cliente en Deskwoot, la copia en Jira no se incluye, así que deja fuera los datos personales que los desarrolladores no necesitan.

Seguir el estado en Deskwoot

Jira le avisa a Deskwoot de cada cambio de estado, y una revisión cada hora recoge lo que se haya perdido. Cada estado nuevo escribe una línea en todos los tickets vinculados a la incidencia. Incidencias vinculadas muestra la clave, el estado y el título completo de cada incidencia. En la lista de tickets, la fila del ticket muestra la clave de la incidencia con un punto del color de su estado (gris para Por hacer, azul para En curso, verde para Listo), y al pasar el mouse sobre ella se ve el nombre del estado. Busca la clave de una incidencia en la lista de tickets para encontrar todos los tickets vinculados a ella. Una incidencia eliminada en Jira muestra Eliminada en Jira.

Dejar que las reglas hagan avanzar los tickets

En Configuración > Automatización, una regla con el evento Incidencia vinculada modificada se ejecuta cuando se crea una incidencia desde un ticket, se vincula a él, se desvincula de él o cambia de estado en Jira. Sus condiciones Cambio en la incidencia, Categoría de estado de la incidencia (Por hacer, En curso, Listo), Categoría de estado anterior de la incidencia y Estado de la incidencia (el nombre del estado en Jira) eligen los cambios a los que responde. Estas reglas nunca se ejecutan en tickets resueltos. Más sobre las reglas en Crear reglas de automatización.

La tarjeta Reglas de la página de Jira en la configuración abre 2 reglas listas para que las revises y las guardes:

• Incidencia creada o vinculada: definir un estado del ticket, por ejemplo un estado de ticket propio que pausa el SLA mientras el equipo de desarrollo trabaja en ella.
• Incidencia terminada: devolver el ticket con una nota: define un estado del ticket, asigna el ticket a quien vinculó la incidencia y agrega una nota para avisarle.

Desconectar o volver a conectar

Cuando Atlassian ya no acepta la conexión, por ejemplo porque se quitó el acceso o porque no se usó durante 90 días, la página de Jira muestra Jira necesita que vuelvas a iniciar sesión. Haz clic en Volver a conectar para mantener las incidencias sincronizadas. Desconectar detiene la creación y la vinculación de incidencias y quita las conexiones de Atlassian propias de los agentes. Deskwoot conserva los vínculos, pero los oculta en los tickets mientras Jira no está conectado. Cuando Jira se vuelve a conectar, aparecen otra vez con su último estado conocido, y mientras tanto un token de API o un token de MCP todavía puede leerlos.

Preguntas frecuentes

¿Por qué no veo Incidencias vinculadas en un ticket?

La sección solo aparece en los tickets, mientras los tickets estén activados y Jira esté conectado. Las conversaciones con clientes no tienen incidencias vinculadas.

¿Por qué Deskwoot me pide conectar mi cuenta de Atlassian?

Una incidencia que creas se crea con tu propia cuenta de Atlassian, así que lleva tu nombre en Jira. La conectas una sola vez. Ver y vincular incidencias funciona sin ella.

¿El cliente ve la incidencia de Jira?

No. Los tickets son trabajo interno de tu equipo, así que la incidencia y sus líneas de estado se quedan con tu equipo.

¿Deskwoot puede mover una incidencia al primer lugar del backlog de Jira?

No. El orden del backlog depende de tu tablero en Jira, así que ordena las incidencias allí o con la automatización propia de Jira.

¿La API o una conexión MCP pueden trabajar con incidencias de Jira?

Un token de API o un token de MCP puede leer las incidencias de un ticket, vincular incidencias existentes y desvincularlas. Crear una incidencia nueva requiere la cuenta de Atlassian propia de una persona, así que solo un miembro crea incidencias, desde el ticket.