Guida all'integrazione di Figma
Cosa fa l'integrazione di Figma
Con Figma connesso, Nakama mostra i progetti e i file del tuo team (con anteprime dal vivo) in un pannello dedicato. Cliccando un file lo apre a dimensione intera in Figma nel tuo browser; il feed dei commenti di ogni file vive proprio nel pannello: leggi i thread, rispondi, filtra i commenti che ti menzionano e trasforma qualsiasi commento in un todo.
Aggiungere l'app (connettere)
1. Apri il pannello laterale di Nakama in Chrome.
2. Premi il pulsante + (Add) in fondo alla barra di destra per aprire il Marketplace.
3. Scegli Figma e premi Connect.
4. Si apre una pagina di accesso a Figma in una scheda del browser. Accedi e premi Allow per autorizzare Nakama.
5. Configurazione una tantum: incolla l'URL del tuo team Figma (apri il tuo team su figma.com e copia la barra degli indirizzi). L'API di Figma non ha un "elenca i miei team", quindi Nakama lo chiede una volta sola.
6. Un'icona di Figma appare nella barra di Nakama e il pannello si apre con i tuoi progetti.
Usare l'app
Sfoglia i progetti. Il titolo del pannello è un selettore di progetti: cambia progetto dal menu a tendina.
Apri i file. Ogni file mostra la sua anteprima, il nome e l'ora dell'ultima modifica. Cliccalo e il file si apre in Figma in una scheda del browser. Nakama non prova mai a eseguire Figma all'interno del pannello.
Segui i commenti. Premi il pulsante dei commenti su un file per il suo feed: thread raggruppati, prima quelli non risolti, con un filtro @me per i commenti che ti menzionano. I nuovi commenti arrivano in tempo reale mentre il feed è aperto.
Rispondi e agisci. Scrivi le risposte direttamente nel pannello; passa il mouse su un commento per aggiungerlo alla tua lista Todo. Trascina la scheda di un file su Slack o Telegram per condividerne il link.
Autorizzazioni e gestione dei dati
Nakama richiede gli scope di Figma files:read (progetti, file, commenti) e file_comments:write (pubblicazione di risposte). Il tuo token Figma è memorizzato solo nella memoria locale dell'estensione del tuo browser e mai sui server di Nakama; il secret dell'app resta lato server solo per lo scambio OAuth.
Rimuovere l'app (disconnettere)
In Nakama: premi + (Add) nella barra per aprire il Marketplace, trova Figma (mostrato come Connected) e premilo per disconnetterlo. L'icona lascia la barra e il token memorizzato viene eliminato dal tuo browser.
In Figma: puoi anche revocare l'accesso in Figma Settings → Connected apps, revocandolo dal lato di Figma.
Risoluzione dei problemi
"Questo non sembra un URL di un team": l'URL del team deve contenere /team/<numero>/. Apri il tuo team nel browser di file di figma.com e copia l'indirizzo completo.
Per qualsiasi altra cosa: consulta il Centro assistenza oppure scrivi a help@rexplore.xyz.