Qué vas a configurar
- Una clave de API personal de Linear conectada a Elido: sin OAuth y sin registrar una app.
- Incidencias de Linear creadas automáticamente cuando el monitor de enlaces rotos de Elido encuentra un destino que ya no funciona.
- Un equipo de Linear de destino por workspace de Elido.
La integración con Linear abre una incidencia automáticamente cuando Elido detecta un enlace roto: un enlace corto cuyo destino devuelve un error o deja de responder. El monitor de enlaces rotos revisa los enlaces una vez al día.
Qué necesitas
- Una cuenta de Linear con permiso para crear incidencias en el equipo de destino.
- Una clave de API personal de Linear (se genera en 30 segundos).
- Un rol de Elido que pueda gestionar integraciones en el workspace.
Generar una clave de API de Linear
- Ve a Linear → Settings → API → Personal API keys.
- Pulsa Create key. Ponle una etiqueta como "Elido integration".
- Copia la clave. Linear solo la muestra una vez.
Configurar en Elido
- Ve a Dashboard → Integrations → Linear.
- Pega la clave de API y valídala. Elido lista todos los equipos a los que tu clave tiene acceso.
- Selecciona el equipo de destino. Las incidencias se crearán ahí.
- Guarda. La clave se almacena cifrada.
Qué se escribe en Linear
Cuando un enlace se detecta por primera vez como roto (y de nuevo si sigue roto 24 horas después), Elido abre una incidencia titulada "Broken link: [short URL]". Contiene:
- La URL corta y la URL de destino.
- El código de estado HTTP y el mensaje de error, cuando estén disponibles.
- La hora en que Elido detectó el problema.
Elido crea una sola incidencia por detección y no lee nada de vuelta desde Linear: no cierra incidencias ni sigue su estado. Eso depende del flujo de trabajo de tu equipo.
Solución de problemas
"Not authorized" al validar la clave: La clave de API es incorrecta o se ha revocado. Genérala de nuevo en Linear Settings → API.
Las incidencias aparecen en el equipo equivocado: Verifica la selección de equipo en Dashboard → Integrations → Linear. Si una clave tiene acceso a varios equipos, el selector puede haber elegido el primero por defecto.
No se crea ninguna incidencia: Solo los enlaces rotos crean incidencias. Comprueba que la conexión de Linear aparece como conectada y que no se ha revocado.
Incidencias duplicadas: Elido abre como máximo una incidencia por detección. Si ves duplicados, comprueba que el mismo equipo de Linear no esté conectado en dos workspaces de Elido.