Integració amb Linear
Sincronitza posts de Feedjolt amb issues de Linear, amb estat i comentaris bidireccionals. Connecta per OAuth, mapeja estats, envia posts i desconnecta.
Connecta Feedjolt amb Linear per empènyer posts de feedback al teu flux de Linear. Quan l'issue de Linear s'envia, l'estat de Feedjolt s'actualitza automàticament - i el teu client rep una notificació.
Què fa
- "Enviar a Linear" amb un clic a qualsevol post de Feedjolt. Crea un issue de Linear amb el títol, cos i un enllaç de tornada.
- Sincronització bidireccional d'estat - quan l'issue de Linear passa a "Done", el post de Feedjolt passa a "Enviat". (Mapeig configurable.)
- Sincronització de comentaris - bidireccional i opcional: els comentaris de l'equip es sincronitzen a l'issue de Linear, i els comentaris de Linear tornen com a notes internes.
- Atribució d'autor - l'issue de Linear el crea l'admin de Feedjolt que va fer clic a "Enviar a Linear", amb l'autor original del feedback indicat al cos.
Instal·lar
- Panell -> Integracions -> Linear.
- Fes clic a Connectar a Linear.
- Aprova el scope OAuth a Linear. Necessitaràs ser admin del workspace de Linear o tenir permís per instal·lar apps de tercers.
- Després de la redirecció, tria l'equip de Linear on vols que es sincronitzi el feedback.
- Mapeja estats de Feedjolt a estats de flux de Linear (per exemple,
Planificat->Backlog,En curs->In Progress,Enviat->Done).
Permisos que demana Linear
| Scope | Per a què |
|---|---|
read | Llegir la teva llista d'equips i estats de flux (per a la UI de mapeig). |
write | Crear issues i comentaris. |
issues:create | Crear issues des de posts de Feedjolt. |
No llegim els teus issues existents a Linear. Només veiem el que creem nosaltres.
Enviar un post a Linear
A qualsevol post de Feedjolt:
- Fes clic a Enviar a Linear a la barra d'accions.
- Tria l'equip (per defecte el que vas mapejar en instal·lar).
- (Opcional) edita el títol o el cos.
- Fes clic a Crear issue.
Es crea l'issue de Linear i apareix un enllaç al post de Feedjolt. Qui vegi el post veu l'enllaç (admins) o una insígnia "Rastrejat al nostre gestor de projectes" (usuaris finals).
Sincronització d'estat
Quan l'issue de Linear es mou entre estats de flux, Feedjolt rep un webhook de Linear i aplica el mapeig configurat.
La sincronització d'estat es regeix per l'interruptor a nivell d'espai Sincronitzar els canvis d'estat de manera bidireccional - no hi ha cap ajust de sincronització d'estat per post. Quan està activat, s'aplica a tots els posts vinculats: moure l'estat de flux d'un issue de Linear vinculat actualitza l'estat de Feedjolt mapejat, i canviar l'estat d'un post de Feedjolt mou l'issue de Linear vinculat (i viceversa).
Si canvies el mapeig més tard, només els canvis d'estat futurs fan servir el nou mapeig. Els posts existents mantenen el seu últim estat aplicat.
Sincronització de comentaris
Activa-la amb la casella Sync comments a Configuració -> Integracions -> Linear. És bidireccional i es controla amb aquest únic interruptor.
- Sortints - els comentaris dels membres de l'espai (personal intern) en un post vinculat, tant respostes públiques com notes internes, es publiquen a l'issue de Linear vinculat, amb el nom de l'autor com a prefix.
- Entrants - els comentaris a l'issue de Linear apareixen a Feedjolt com a notes internes (visibles només per al personal, mai mostrades al portal públic), amb el nom de l'autor de Linear com a prefix (per exemple, "Jane via Linear").
- Els comentaris dels usuaris finals es queden on són - els comentaris dels teus clients no se sincronitzen amb Linear.
- A prova de bucles - un comentari reflectit en un sentit mai es torna en eco.
Requisit previ: els webhooks de comentaris de Linear han d'estar activats a l'app de Feedjolt a Linear. A Linear, un admin de l'espai ha d'activar el recurs Comments al webhook de l'app (Settings -> API -> la teva app/webhook), a més d'Issues. Fins que no s'activi, la sincronització entrant de comentaris Linear -> Feedjolt no es dispararà.
Enviament en bloc
Al panell, selecciona diversos posts i fes clic a En bloc -> Enviar a Linear. Cada post es converteix en un issue de Linear separat.
Per a productes amb molts elements petits de feedback, considera agrupar per etiqueta i enviar un issue de Linear per etiqueta - el teu equip d'enginyeria t'ho agrairà.
Desconnectar
Panell -> Integracions -> Linear -> Desconnectar.
Els issues de Linear existents es queden a Linear; l'enllaç des del post de Feedjolt es queda com una URL plana (ja no es sincronitza automàticament). Reconnectar reprèn on ho vas deixar.
Limitacions
- Un equip de Linear per espai de Feedjolt al mapeig bàsic. El mapeig per tauler està al full de ruta.
- Sense creació d'issues Linear -> Feedjolt - el flux és d'un sol sentit (Feedjolt a Linear).
- Sense sincronització d'adjunts - l'API d'adjunts de Linear té límits; no enviem adjunts per ara.
- Les ràfegues extremes es limiten (una protecció contra descontrols, molt per sobre del trànsit normal). Linear reintenta les entregues limitades, però el seu marge de reintents és finit: una edició massiva molt gran pot deixar alguns estats sense sincronitzar. Si acabes de fer una actualització massiva a Linear, revisa les publicacions afectades.
Si algun d'aquests t'importa, digues-nos-ho.
Recepció per correu
Reenvia correus de clients a una adreca de l'espai i deixa que Feedjolt redacti publicacions amb IA. Configura l'entrada, els fils, dominis permesos i adjunts.
Webhooks
Feedjolt envia esdeveniments signats per POST al teu endpoint quan canvien publicacions, estats, comentaris o vots. Crea endpoints, tria esdeveniments i reenvia'ls.
