Figma è una piattaforma di design per creare banner email, grafiche per social media e altri elementi visivi di marketing. Con l'integrazione di Figma, puoi sincronizzare automaticamente i tuoi design nella Libreria Immagini di Omnisend come file PNG.

Questo articolo spiega come connettere Figma, configurare la sincronizzazione automatica, utilizzare i tuoi design nelle Campagne Email e nell'Automazione, e risolvere problemi comuni di connessione.

Prima di iniziare

Assicurati che:

Hai un account Figma attivo.
L'account Figma che autorizzi può aprire il file che desideri sincronizzare.
Se duplici un file della Community di Figma, duplicalo mentre sei connesso all'account che utilizzerai per autorizzare la connessione. Un file duplicato da un altro account potrebbe non essere accessibile tramite l'API di Figma.
Hai creato una pagina, chiamata anche canvas, all'interno del tuo file Figma. Puoi chiamarla Omnisend Sync o usare un altro nome.
I design che desideri sincronizzare sono posizionati direttamente su questa pagina come frame di primo livello.
Il tuo piano Figma e il tipo di posto sono disponibili durante la configurazione perché influenzano la frequenza di sincronizzazione disponibile.
I design verranno sincronizzati solo come file PNG.
Un file e una pagina possono essere sincronizzati per connessione.
Ogni frame deve essere inferiore a 5 MB.I frame che superano questa dimensione non verranno sincronizzati.

Vantaggi

Con l'integrazione di Figma, puoi:

Sincronizza automaticamente i nuovi design e quelli aggiornati di Figma.
Usa i design sincronizzati nella Libreria Immagini di Omnisend.
Aggiungi i design sincronizzati alle Campagne Email e ai messaggi del Flusso automatizzato.
Scegli una frequenza di sincronizzazione da ogni 15 minuti a una volta al mese, a seconda del tuo Piano Figma e del tipo di posto.

Imposta l'integrazione di Figma

Passo 1: Prepara una pagina di sincronizzazione in Figma

Apri il file Figma che desideri sincronizzare.
Aggiungi una nuova pagina al livello superiore del file.
Inserisci il nome della pagina che desideri utilizzare durante la configurazione di Omnisend. Il nome predefinito è Omnisend Sync.
Sposta i design che desideri sincronizzare su questa pagina.
Assicurati che ogni design sia un frame di livello superiore posizionato direttamente sulla pagina.

Qualsiasi frame aggiunto o aggiornato su questa pagina può essere importato nella tua Libreria Immagini Omnisend.

Importante: I frame annidati all'interno di un gruppo, componente o un altro frame non si sincronizzeranno.

Tieni a mente i seguenti punti:

La pagina deve esistere prima di collegare Figma a Omnisend.
Il confronto dei nomi delle pagine non è sensibile al maiuscolo. Ad esempio, Omnisend Sync e OMNISEND SYNC sono trattati come lo stesso nome.
Se rinomini la pagina dopo aver collegato Figma, aggiorna il Nome pagina di sincronizzazione nella tua connessione Omnisend.
Aggiornare il nome della pagina attualmente richiede di reinstallare l'app Figma in Omnisend.

Passo 2: Collega il tuo Account Figma

In Omnisend, vai su Apps.
Cerca Figma.
Clicca su Collegati ora.
Completa il modulo di connessione.

Inserisci le seguenti informazioni:

URL di base dell'API: Lascia https://api.figma.com unchanged. Usa https://api.figma-gov.com only if you use a Figma for Government tenant.
URL del file Figma: Inserisci l'URL completo del file Figma che desideri sincronizzare. Ad esempio: https://www.figma.com/design//. È supportata anche una chiave file nuda.
Nome pagina di sincronizzazione: Inserisci il nome della pagina che hai preparato nel Passo 1. La pagina deve già esistere nel file selezionato.
Frequenza di sincronizzazione: Scegli con quale frequenza Omnisend dovrebbe controllare nuovi design o design aggiornati.

Importante: Usa un URL di file Figma, non un URL di cartella o progetto. L'Account Figma che autorizzi deve essere in grado di aprire il file selezionato.

5. Clicca su Collega.

6. Quando reindirizzato a Figma, accedi con l'Account che può accedere al file.

7. Fai clic su Consenti per autorizzare la connessione.

8. Dopo l'autorizzazione, tornerai a Omnisend.

Passo 3: Configura le impostazioni di sincronizzazione

Dopo aver collegato Figma:

Vai su Apps App collegate.
Seleziona Figma.
Apri Impostazioni.

Puoi configurare le seguenti opzioni:

Auto-sincronizzazione: Attiva la sincronizzazione automatica per nuovi frame e frame aggiornati.
Sincronizza ora: Controlla immediatamente nuovi frame o frame aggiornati.

Nota: I limiti di velocità di Figma potrebbero impedire l'importazione di nuovi design se esegui Sincronizza ora prima che sia trascorso l'intervallo di sincronizzazione selezionato. Omnisend può controllare la connessione, ma non importerà nuovi design fino a quando non sarà trascorso il tempo richiesto.

Passo 4: Usa i tuoi design nelle Email

Apri una Campagna Email o un Flusso automatizzato.
Apri l'Editor email.
Trascina un elemento Immagine nella tua email.
Clicca su Seleziona file.
Seleziona uno dei tuoi design sincronizzati di Figma.

I tuoi design Figma vengono aggiunti alla Libreria Immagini di Omnisend come file PNG.

💡 Scopri di più sulla Libreria Immagini Omnisend.

Come funziona la sincronizzazione

Azione Figma	Risultato di Omnisend
Aggiungi un nuovo frame alla pagina di sincronizzazione	Il frame viene sincronizzato durante il prossimo controllo idoneo.
Aggiorna un frame esistente	Il frame aggiornato viene sincronizzato come una nuova immagine.
Rimuovi un frame dalla pagina di sincronizzazione	L'immagine esistente rimane nella Libreria Immagini Omnisend.
Lascia un frame invariato	Il frame viene saltato e non viene caricato di nuovo.
Il frame supera i 5 MB	Il frame viene saltato e non viene sincronizzato nella Libreria Immagini.

Risoluzione dei problemi

La connessione fallisce o mi riporta al modulo di configurazione

Controlla quanto segue:

L'account Figma che autorizza può aprire il file selezionato.
L'URL del file punta a un file Figma, non a una cartella o progetto.
La pagina di sincronizzazione esiste nel file selezionato.
Il nome della pagina di sincronizzazione corrisponde al nome inserito in Omnisend.
L'URL di base dell'API è corretto per il tuo tenant Figma.

Se il file non può essere accessibile, Figma potrebbe restituire un errore 403 Permission denied. Questo errore può significare che l'account autorizzato non ha accesso al file o che l'URL del file è errato.

Se il nome della pagina non è valido o l'URL non punta a un file supportato, Omnisend ti riporta al modulo di configurazione. Le tue precedenti voci rimangono disponibili e Omnisend mostra le pagine disponibili quando applicabile. Puoi correggere i dettagli e riprovare senza ri-autorizzare Figma.

I miei design non appaiono nella Libreria Immagini

Controlla che:

I design sono frame di livello superiore.
I frame sono posizionati direttamente sulla pagina selezionata.
Il nome della pagina corrisponde al nome nella tua connessione Figma.
L'URL del file punta al file corretto.
Ogni frame è inferiore a 5 MB.I frame più grandi di 5 MB non si sincronizzeranno.
Stai controllando all'interno dell'Editor email selezionando un elemento Immagine e facendo clic su Seleziona file.
Sei andato su App 859; App collegate 859; Figma 859; Impostazioni e hai fatto clic su Sincronizza ora.

L'importazione può richiedere un minuto o più, a seconda del numero di frame da sincronizzare.

Se fai clic su Sincronizza ora prima che sia trascorso l'intervallo di sincronizzazione selezionato, Omnisend potrebbe controllare la connessione senza importare nuovi design.

Per confermare se un frame è fallito perché è troppo grande, controlla i Log di accesso API in Omnisend.

La sincronizzazione fallisce con un errore di limite di frequenza

Figma limita la frequenza con cui i file possono essere accessibili tramite la sua API. Il limite dipende dal tuo piano Figma e dal tipo di posto.

Se la sincronizzazione fallisce ripetutamente o ricevi un errore di limite di frequenza 429:

Scegli un intervallo di sincronizzazione più lungo.
Evita di fare clic su Sincronizza ora ripetutamente.
Aspetta fino alla fine del periodo di limite di frequenza prima di riprovare.

Domande frequenti

Quali formati di immagine sono supportati?

I design Figma si sincronizzano solo come file PNG.

Posso sincronizzare un intero template email Figma?

L'integrazione sincronizza i design Figma come immagini PNG. Non si sincronizza un layout o un template email modificabile.

Posso rinominare la pagina di sincronizzazione dopo la connessione?

Sì. Dopo aver rinominato la pagina in Figma, aggiorna il Nome pagina di sincronizzazione in Omnisend. Attualmente, aggiornare il nome della pagina richiede di reinstallare l'app Figma in Omnisend.

Posso collegare più marchi Omnisend allo stesso account Figma?

Sì. Puoi collegare lo stesso account Figma a diversi marchi Omnisend. Ogni connessione può puntare a un file Figma diverso e a una pagina di sincronizzazione.

Posso sincronizzare più file o pagine Figma a un solo marchio Omnisend?

No. Ogni connessione supporta un file Figma e una pagina.

Cosa succede se disconnetto Figma?

Se disconnetti Figma da Omnisend, le immagini esistenti rimangono nella tua Libreria Immagini Omnisend. I nuovi design Figma o quelli aggiornati non si sincronizzeranno finché non ti riconnetti a Figma.

Con quale frequenza dovrei sincronizzare?

Il tuo piano Figma e il tipo di posto determinano quale frequenza è appropriata:

Piano Organizzazione o Enterprise con un posto Dev o Full: Ogni 15–30 minuti può funzionare bene.
Piano Professionale con un posto Dev o Full: Ogni ora è un'impostazione predefinita sicura.
Piano Starter, o posto Viewer o Collab su qualsiasi piano: Settimanale o mensile è raccomandato perché queste configurazioni hanno limiti API più bassi.

Se non sei sicuro, inizia con un intervallo più lungo e riducilo solo se la sincronizzazione funziona in modo affidabile.

Hai bisogno di aiuto? Contatta il Team di Supporto Omnisend tramite chat in-app o email [email protected]

Integra Figma con Omnisend