Integración con Linear
Sincroniza posts de Feedjolt con issues de Linear, con estado y comentarios bidireccionales. Conecta por OAuth, mapea estados, envía posts y desconecta.
Conecta Feedjolt con Linear para empujar posts de feedback a tu flujo de Linear. Cuando el issue de Linear se envía, el estado de Feedjolt se actualiza automáticamente - y tu cliente recibe una notificación.
Qué hace
- "Enviar a Linear" con un clic en cualquier post de Feedjolt. Crea un issue de Linear con el título, cuerpo y un enlace de vuelta.
- Sincronización bidireccional de estado - cuando el issue de Linear pasa a "Done", el post de Feedjolt pasa a "Enviado". (Mapeo configurable.)
- Sincronización de comentarios - bidireccional y opcional: los comentarios del equipo se sincronizan al issue de Linear, y los comentarios de Linear vuelven como notas internas.
- Atribución de autor - el issue de Linear lo crea el admin de Feedjolt que pulsó "Enviar a Linear", con el autor original del feedback indicado en el cuerpo.
Instalar
- Panel -> Integraciones -> Linear.
- Haz clic en Conectar a Linear.
- Aprueba el scope OAuth en Linear. Necesitarás ser admin del workspace de Linear o tener permiso para instalar apps de terceros.
- Tras la redirección, elige el equipo de Linear donde quieres que se sincronice el feedback.
- Mapea estados de Feedjolt a estados de flujo de Linear (por ejemplo,
Planeado->Backlog,En curso->In Progress,Enviado->Done).
Permisos que pide Linear
| Scope | Para qué |
|---|---|
read | Leer tu lista de equipos y estados de flujo (para la UI de mapeo). |
write | Crear issues y comentarios. |
issues:create | Crear issues desde posts de Feedjolt. |
No leemos tus issues existentes en Linear. Solo vemos lo que creamos nosotros.
Enviar un post a Linear
En cualquier post de Feedjolt:
- Haz clic en Enviar a Linear en la barra de acciones.
- Elige el equipo (por defecto el que mapeaste al instalar).
- (Opcional) edita el título o el cuerpo.
- Haz clic en Crear issue.
Se crea el issue de Linear y aparece un enlace en el post de Feedjolt. Quien vea el post ve el enlace (admins) o una insignia "Rastreado en nuestro gestor de proyectos" (usuarios finales).
Sincronización de estado
Cuando el issue de Linear se mueve entre estados de flujo, Feedjolt recibe un webhook de Linear y aplica el mapeo configurado.
La sincronización de estado se rige por el interruptor a nivel de espacio Sincronizar cambios de estado de forma bidireccional - no hay ajuste de sincronización de estado por post. Cuando está activado, se aplica a todos los posts vinculados: mover el estado de flujo de un issue de Linear vinculado actualiza el estado de Feedjolt mapeado, y cambiar el estado de un post de Feedjolt mueve el issue de Linear vinculado (y viceversa).
Si cambias el mapeo más tarde, solo los cambios de estado futuros usan el nuevo mapeo. Los posts existentes mantienen su último estado aplicado.
Sincronización de comentarios
Actívala con la casilla Sync comments en Ajustes -> Integraciones -> Linear. Es bidireccional y se controla con ese único interruptor.
- Salientes - los comentarios de los miembros del espacio (personal interno) en un post vinculado, tanto respuestas públicas como notas internas, se publican en el issue de Linear vinculado, con el nombre del autor como prefijo.
- Entrantes - los comentarios en el issue de Linear aparecen en Feedjolt como notas internas (visibles solo para el personal, nunca mostradas en el portal público), con el nombre del autor de Linear como prefijo (por ejemplo, "Jane via Linear").
- Los comentarios de usuarios finales se quedan donde están - los comentarios de tus clientes no se sincronizan con Linear.
- A prueba de bucles - un comentario reflejado en un sentido nunca se devuelve en eco.
Requisito previo: los webhooks de comentarios de Linear deben estar activados en la app de Feedjolt en Linear. En Linear, un admin del espacio debe activar el recurso Comments en el webhook de la app (Settings -> API -> tu app/webhook), además de Issues. Hasta que se active, la sincronización entrante de comentarios Linear -> Feedjolt no se disparará.
Envío en bloque
En el panel, selecciona varios posts y haz clic en En bloque -> Enviar a Linear. Cada post se convierte en un issue de Linear separado.
Para productos con muchos elementos pequeños de feedback, considera agrupar por etiqueta y enviar un issue de Linear por etiqueta - tu equipo de ingeniería te lo agradecerá.
Desconectar
Panel -> Integraciones -> Linear -> Desconectar.
Los issues de Linear existentes se quedan en Linear; el enlace desde el post de Feedjolt se queda como una URL plana (ya no se sincroniza automáticamente). Reconectar retoma donde lo dejaste.
Limitaciones
- Un equipo de Linear por espacio de Feedjolt en el mapeo básico. El mapeo por tablero está en la hoja de ruta.
- Sin creación de issues Linear -> Feedjolt - el flujo es de un solo sentido (Feedjolt a Linear).
- Sin sincronización de adjuntos - la API de adjuntos de Linear tiene límites; no enviamos adjuntos por ahora.
- Las ráfagas extremas se limitan (una protección contra descontroles, muy por encima del tráfico normal). Linear reintenta las entregas limitadas, pero su margen de reintentos es finito: una edición masiva muy grande puede dejar algunos estados sin sincronizar. Si acabas de hacer una actualización masiva en Linear, revisa las publicaciones afectadas.
Si alguno de estos te importa, dínoslo.
Recepción por correo
Reenvia correos de clientes a una direccion del espacio y deja que Feedjolt redacte publicaciones con IA. Configura la entrada, los hilos, dominios permitidos y adjuntos.
Webhooks
Feedjolt envía eventos firmados por POST a tu endpoint cuando cambian publicaciones, estados, comentarios o votos. Crea endpoints, elige eventos y reenvíalos.
