Linear
Conecta QA Hub a Linear para buscar issues desde el Dashboard y habilitar el polling automático del estado de bugs.
Requisitos previos
- Un espacio de trabajo de Linear con acceso a la API
- Una clave de API personal de Linear
Generar una clave de API de Linear
- Ve a linear.app → Settings → API → Personal API keys.
- Haz clic en Create key, dale una etiqueta (p. ej., "QA Hub").
- Copia la clave — se muestra solo una vez.
Configurar en QA Hub
- Ve a Settings → Integrations.
- Selecciona Linear como tu conector.
- Introduce tu API Key.
- Haz clic en Test connection.
- Haz clic en Save.
Buscar issues
La búsqueda del Dashboard consulta la API GraphQL de Linear. Filtros disponibles:
| Filtro | Descripción |
|---|---|
| Keyword | Coincide con el título y la descripción del issue |
| Status | Filtrar por estado del workflow (p. ej., "In Progress") |
| Label | Filtrar por etiqueta (p. ej., "bug", "feature") |
| Priority | Urgent, High, Medium, Low, No priority |
| Team | Filtrar por equipo de Linear |
Polling de estado de bugs
Cuando Linear es tu conector activo, el poller en segundo plano de QA Hub comprueba los estados de los issues de Linear vinculados a un intervalo configurable (por defecto: 30 segundos). Cuando un issue alcanza el estado de completado configurado (por defecto: "Done"), QA Hub:
- Marca el bug como resuelto en el Bug Tracker
- Encola el caso de prueba asociado en la Cola de retest
- Envía una notificación dentro de la app y dispara un webhook
bug.resolved
Configurar el polling
Ve a Settings → Analytics:
- Check interval — Con qué frecuencia hacer polling (en segundos). Valores menores significan detección más rápida pero más llamadas a la API.
- Done status — El nombre del estado de Linear que indica que un bug está resuelto. Por defecto:
"Done".
Estructura de un issue
Cada issue de Linear devuelto por QA Hub incluye:
{
"key": "LIN-123",
"title": "Guest checkout fails on mobile",
"description": "...",
"status": "In Progress",
"priority": "Urgent",
"labels": ["bug", "mobile"],
"url": "https://linear.app/acme/issue/LIN-123"
}