Linear: crea, vincula y sigue incidencias desde tus tickets

Conectar tu espacio de trabajo de Linear

En Deskwoot necesitas el permiso Gestionar integraciones, que tienen los administradores. En Linear tienes que ser admin del espacio de trabajo, porque Deskwoot se une a él como una app.

1. Abre Configuración > Integraciones > Linear y haz clic en Conectar Linear.
2. Inicia sesión en Linear y autoriza a Deskwoot en la pantalla de Linear.
3. De vuelta en Deskwoot, Equipos que ve Deskwoot muestra los equipos de Linear que la app puede ver. Elige el Equipo para nuevas incidencias y haz clic en Guardar. Los agentes pueden elegir otro equipo para cada incidencia.

Deskwoot solo ve los equipos de Linear a los que le das acceso a la app de Deskwoot. Puedes cambiarlo en Linear cuando quieras y luego recargar la página de Linear en Deskwoot.

Vincular una incidencia existente

1. Abre el ticket. La sección Incidencias vinculadas está en los detalles del ticket, a la derecha.
2. Haz clic en Vincular incidencia y busca por la clave de la incidencia, como ENG-123, o por palabras del título. Si también tienes Jira conectado, primero elige Linear arriba en el diálogo.
3. Elige la incidencia. Deskwoot escribe una línea en el ticket, y la incidencia recibe en Linear 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. El enlace de vuelta en Linear también se quita.

Crear una incidencia nueva

1. En Incidencias vinculadas, haz clic en Crear incidencia. Si también tienes Jira conectado, elige Linear arriba en el diálogo. 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 resumen, el contexto y los comentarios del ticket. Copilot tiene la instrucción de dejar fuera el nombre y los datos de contacto del cliente, así que revisa el borrador antes de crear la incidencia. El borrador cuenta como uso de Copilot, igual que otros borradores de Copilot.
3. Revisa el Equipo y luego haz clic en Crear incidencia.

Linear muestra la incidencia como escrita por ti a través de Deskwoot, con un enlace de vuelta al ticket. El texto que envías sale de Deskwoot, y las solicitudes sobre datos personales que recibas en Deskwoot no llegan a ese texto en Linear. Quita los datos personales que los desarrolladores no necesitan.

Seguir el estado en Deskwoot

Linear le avisa a Deskwoot de cada cambio de estado, y una revisión cada hora detecta lo que se haya perdido. Cada estado nuevo escribe una línea en todos los tickets vinculados a la incidencia, y la lista de tickets muestra la clave y el estado de la incidencia en el ticket. Busca una clave de incidencia en la lista de tickets para encontrar todos los tickets vinculados a ella. Cuando una incidencia pasa a otro equipo en Linear, su clave cambia y Deskwoot muestra la nueva. Una incidencia eliminada en Linear muestra Eliminada en Linear o Ya no se encuentra en Linear.

Encontrar errores conocidos con Copilot

Cuando un cliente reporta un problema, o le preguntas a Copilot por un error conocido en la pestaña Copilot de la conversación, Copilot también busca en Linear. Lee las incidencias abiertas del equipo elegido en Equipo para nuevas incidencias y de los equipos a los que se vinculan tus tickets, nunca todo tu espacio de trabajo de Linear, y las incidencias ya vinculadas a los tickets de esta conversación, en cualquier estado.

• Copilot lee hasta 3 incidencias de Linear: primero las vinculadas al caso y luego incidencias abiertas cuyo título comparte suficientes palabras con el problema.
• Su respuesta nombra las incidencias que coinciden, con su clave, título y estado, y cada una enlaza a Linear. La línea Revisado sobre la respuesta menciona Linear cuando se buscó en Linear.
• Copilot da una fecha prevista para la solución solo cuando la incidencia tiene una que todavía no ha llegado: la fecha objetivo de un lanzamiento en Linear, la fecha de vencimiento de la incidencia o un comentario de tu equipo. Lee hasta 3 comentarios escritos por una persona de tu equipo, nunca comentarios de bots, invitados o personas de fuera del equipo.
• En una respuesta para el cliente, Copilot tiene la instrucción de decir que el problema es conocido solo cuando una incidencia lo describe, y de dejar fuera las claves de incidencia y el nombre Linear.

Cuando Copilot no pudo buscar en Linear, por ejemplo porque la conexión necesita que vuelvas a iniciar sesión, una línea debajo de la respuesta lo dice. En ese caso, Copilot tiene la instrucción de no decir nunca que no hay un error conocido.

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 Linear. Sus condiciones Cambio en la incidencia, Categoría de estado de la incidencia (Por hacer, En curso, Hecho) y Estado de la incidencia (el nombre del estado en Linear) eligen los cambios a los que reacciona. Una incidencia cancelada o duplicada cuenta como Hecho, así que usa Estado de la incidencia cuando una regla deba distinguirla de una terminada. Estas reglas nunca se ejecutan en tickets resueltos.

La tarjeta Reglas de la página de configuración de Linear 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 él.
• 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, para que pueda informar al cliente.

Si también tienes Jira conectado, las mismas reglas se ejecutan para las incidencias de ambos.

Desconectar o volver a conectar

Cuando Linear ya no acepta la conexión, por ejemplo porque se quitó la app de Deskwoot en Linear, la página de Linear muestra Linear necesita que vuelvas a iniciar sesión. Haz clic en Volver a conectar para mantener las incidencias sincronizadas. Desconectar deja de crear y vincular, y Deskwoot le pide a Linear que termine el acceso de la app. Deskwoot conserva los vínculos. Mientras no haya ningún gestor de incidencias conectado, los tickets no los muestran. Cuando vuelvas a conectar Linear, se muestran de nuevo con su último estado conocido, y mientras tanto un token de API o un agente MCP todavía puede leerlos.

Preguntas frecuentes

¿Mis agentes necesitan una cuenta de Linear?

No. Deskwoot se une a tu espacio de trabajo de Linear como una app, así que los agentes vinculan y crean incidencias sin una cuenta de Linear, y Linear muestra el nombre del agente que creó una incidencia.

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

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

¿El cliente ve la incidencia de Linear?

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

¿Puedo usar Linear y Jira juntos?

Sí. Conecta los dos, y Vincular incidencia y Crear incidencia te dejan elegir Jira o Linear arriba en el diálogo. Un ticket puede tener incidencias de ambos.

¿La API o un agente de IA pueden trabajar con incidencias de Linear?

Un token de API o un token MCP puede leer las incidencias de un ticket, vincular incidencias existentes y desvincularlas. Los compañeros de IA solo las leen. Una incidencia nueva lleva el nombre de la persona que la crea, así que solo un miembro crea incidencias, desde el ticket.

¿Por qué Copilot no encuentra una incidencia de Linear que conozco?

Copilot solo busca incidencias abiertas del equipo para nuevas incidencias y de los equipos a los que se vinculan tus tickets, y solo encuentra incidencias cuyo título comparte suficientes palabras con el problema del cliente. Vincula la incidencia al ticket, y Copilot la lee en cualquier estado.