Crear incidencias de Linear desde flujos de trabajo
Abre una incidencia de Linear desde un flujo de trabajo — en el equipo que elijas, con una prioridad — y deja que la acción de Polzy se cierre sola cuando la incidencia esté hecha. Conecta Linear una vez con una clave de API personal.
En esta página
Cuando un comentario necesita a tu equipo de producto o de ingeniería, un flujo de trabajo puede abrir una incidencia de Linear para ello — en el equipo que elijas, con un título, una descripción y una prioridad a partir de lo que Polzy sabe. Si el flujo también creó una acción de Polzy, la acción sigue a la incidencia y se cierra sola cuando la incidencia se completa o se cancela. Al final de esta guía tendrás Linear conectado y un flujo que abre incidencias.
Linear está incluido en el plan Business y se usa desde los flujos de trabajo. Solo un Administrador puede conectarlo y crear flujos de trabajo.
Antes de empezar
Necesitas:
- Un espacio de trabajo en el plan Business, con el rol de Administrador.
- Integraciones y Flujos de trabajo activados para el espacio de trabajo, en Configuración → General → Qué hace este espacio de trabajo.
- Una cuenta de Linear que pueda crear incidencias en los equipos que vayas a usar. Las incidencias se crean con esa cuenta, así que una cuenta dedicada evita que queden ligadas a una persona.
- Una clave de API personal para esa cuenta (abajo).
Crear una clave de API personal
- En Linear, abre Settings → Account → Security & access.
- En Personal API keys, elige New key y llámala Polzy.
- Dale acceso completo, o al menos permiso para leer y crear incidencias, y acceso a los equipos a los que debe llegar Polzy.
- Copia la clave. Empieza por
lin_api_.
Si Linear no te deja crear una clave, puede que un administrador de Linear haya desactivado las claves de los miembros en Settings → Administration → API. Linear explica las claves en Linear: API and webhooks.
Conectar Linear a Polzy
- En la barra lateral, en Automatizar, abre Integraciones y elige la pestaña Disponibles.
- Busca Linear y elige Conectar.
- Pega la clave en Clave de API personal.
- Elige Probar conexión. Polzy responde Connected as y el nombre de la cuenta.
- Elige Conectar.
La clave se guarda cifrada. Una vez conectado, la fila de Linear en Integraciones ofrece Configurar alcance para sustituir la clave, y Gestionar para su página.
Abrir una incidencia desde un flujo de trabajo
- Abre Flujos de trabajo y el flujo, o crea uno nuevo.
- En Conectores, dentro de Pasos instalados, arrastra Crear incidencia en Linear · Linear al lienzo, detrás del paso al que debe seguir. Una fila con candado significa que Linear aún no está conectado o requiere atención.
- En Equipo, elige el equipo. La lista muestra todos los equipos que la clave puede ver, con su nombre y su clave.
- Escribe el Título, hasta 255 caracteres. Escribe
{{para insertar un valor de la ejecución, como el título de la acción. - Si quieres, escribe una Descripción.
- Elige una Prioridad: Sin prioridad, Urgente, Alta, Media o Baja.
El paso deja el identificador de la incidencia, como CS-142, en {{connector.issueKey}} y su dirección en {{connector.url}}. Una Ejecución de prueba recorre el flujo sin abrir la incidencia; solo una ejecución real la crea. Flujos de trabajo explica los disparadores y los pasos.
Cerrar la acción cuando la incidencia esté hecha
Cuando Crear incidencia en Linear se ejecuta después de Crear elemento de acción en la misma ejecución del flujo, la incidencia queda vinculada a esa acción:
- Seguido en. El panel de la acción muestra el identificador de la incidencia, enlazado con Linear, y el último estado que informó Linear.
- Cerrada por Linear. Polzy consulta a Linear por la incidencia como mucho cada 10 minutos. Cuando está completada — o cancelada, porque el trabajo ya no se hará allí — la acción pasa a Hecho.
- Solo el estado. Los comentarios y demás cambios se quedan en Linear. Una acción cerrada antes en Polzy deja de consultarse.
Qué envía Polzy a Linear
Solo lo que dice el paso: el equipo, el título, la descripción y la prioridad, con los valores que insertes. Nada más sobre la respuesta o la persona sale de Polzy. Una respuesta anónima no tiene persona, así que valores como el correo de quien respondió quedan vacíos; lo que alguien escribió solo se envía después de su revisión de seguridad. El tamaño mínimo de grupo no retiene las respuestas sueltas: piensa en quién puede leer las incidencias del equipo antes de poner en ellas las palabras de las personas.
Solución de problemas
- Linear refused the credentials (401). La clave es incorrecta o se revocó. Crea una nueva, elige Configurar alcance en la fila de Linear en Integraciones, pégala y elige Guardar. Una ejecución que se encuentre con esto pone Linear en Requiere atención.
- Linear: seguido de las palabras de Linear (en una ejecución). Linear rechazó la solicitud — a menudo porque la clave no tiene acceso a ese equipo o no puede crear incidencias. Revisa los permisos de la clave.
- Linear did not create the issue. Linear respondió sin incidencia. Vuelve a ejecutar el flujo; si se repite, comprueba que el equipo sigue existiendo.
- This step names no team o The issue has no title. Rellena el Equipo y el Título del paso.
- La lista Equipo es un campo de texto. La clave no ve ningún equipo, o no se pudo llegar a Linear.
- La acción no se cierra. El paso de Linear no se ejecutó después de Crear elemento de acción en la misma ejecución, la incidencia no está completada ni cancelada, o la conexión requiere atención — las consultas se detienen hasta que se resuelva.
Conviene saber
- Una conexión, todos los equipos. Cada paso elige su equipo entre los que ve la clave.
- ¿Quién la crea? La cuenta a la que pertenece la clave.
- ¿Puede un paso abrir dos veces la misma incidencia? No. Un paso que se vuelve a ejecutar tras un fallo reutiliza lo que creó la primera vez.
Enlaces útiles
Artículos relacionados
Los miembros con sesión iniciada pueden preguntar a Polzy o escribir al equipo desde Soporte. La rapidez de nuestra respuesta depende de tu plan.