Sync Data

Sincronizza i tuoi prodotti Shopify, meta-campi e iscritti con Clerk. Questa guida copre la creazione di un’app nel Developer Dashboard di Shopify, la personalizzazione dei dati dei prodotti e la sincronizzazione delle informazioni sugli iscritti.

Configura la sincronizzazione dei dati #

Per sincronizzare i dati del tuo store Shopify con Clerk, devi creare un’app nel Developer Dashboard di Shopify e configurarla in Clerk. L’utente che configura la sincronizzazione deve avere accesso al Developer Dashboard e i permessi per sviluppare app nello store Shopify.

Requisiti di accesso: Solo i proprietari dello store o il personale con permessi per il Developer Dashboard possono creare l’app (non tramite accesso collaborativo). Se stai configurando per un cliente, hai bisogno dell’accesso come staff o delle credenziali dell’app da loro.

Crea l’app #

1. In Shopify, fai clic su Settings.

2. Fai clic su Apps and sales channels.

3. Fai clic su Develop apps.

4. Fai clic su Build apps in Dev Dashboard.

   • Se non vedi questa opzione, invece fai clic su Learn more.
   • Nella nuova finestra che si apre, fai clic su Go to Dev Dashboard.
   • In alternativa, puoi aprire direttamente il Dev Dashboard dopo aver effettuato il login.

5. Nel Developer Dashboard, fai clic su Create App.

6. Inserisci Clerk.io come nome dell’app.

7. In App URL, aggiungi il placeholder standard di Shopify per le app: https://shopify.dev/docs/apps/default-app-home

8. Sotto Embed App in Shopify Admin, rimuovi il segno di spunta. L’app necessita di essere installata una sola volta e non deve comparire nel menu laterale di Shopify.

9. In Webhooks API Version, seleziona la versione più recente (almeno 2025-07).

Configura gli scopes #

10. Sotto Access scopes, concedi l’accesso in sola lettura (scopes che iniziano con read_) ai seguenti:

• Customers

• Inventory

• Locales

• Markets

• Online Store Pages

• Orders

• Products

• Store Content

• Translations

11. In fondo alla schermata, fai clic su Release.

Installa l’app #

12. Fai clic su Home, poi su Install app nell’angolo in alto a destra.

13. Shopify ti reindirizza a una pagina dove selezioni lo Store Shopify su cui installare l’app. Scegli il tuo store dalla lista.

14. Nella pagina successiva, controlla il riepilogo dei dettagli dell’app e fai clic su Install nell’angolo in basso a destra.

Collega a Clerk #

15. Torna nel Developer Dashboard e fai clic su Settings all’interno dell’app Clerk.io. Qui troverai il Client ID e il Client Secret.

16. Vai su my.clerk.io > Data > Configuration. Sotto Sync Method, seleziona Shopify.

17. Incolla il Client ID e il Client Secret nel modulo. Quindi fai clic su Start Sync.

Problema noto: Shopify potrebbe non generare un token al primo tentativo di sincronizzazione, causando un errore di autenticazione. Si tratta di un problema intermittente riconosciuto in Shopify. Basta attendere 1-2 minuti e provare nuovamente la sincronizzazione.

Personalizzazione dei dati dei prodotti #

In Shopify, i meta-campi e altri attributi che crei possono essere sincronizzati tramite my.clerk.io > System status > Data sync.

Semplicemente vai al campo di input chiamato Custom Attributes e scrivi gli attributi dei prodotti da includere.

Per aggiungere più attributi, separali con una virgola.

Gli attributi devono sempre essere scritti utilizzando la loro key.

Questo solitamente è tutto minuscolo. Ad esempio, l’attributo “Sizes” dovrebbe essere “sizes”.

Non è necessario includere il namespace - Clerk lo troverà automaticamente in base alla key.

In Shopify, spesso puoi trovare queste keys individuando il tuo attributo in Settings > Custom data > Products/Variants:

Sincronizzazione degli iscritti #

Shopify supporta la gestione diretta degli iscritti nella piattaforma.

Questi possono essere facilmente sincronizzati con Clerk.

Quando attivato, importeremo quell’attributo “subscribed: true” per qualsiasi indirizzo email iscritto in Shopify.

Questo può poi essere utilizzato per Auto-Email.

Semplicemente vai al tuo store su my.clerk.io, poi Data -> Configuration e imposta Include Subscriber State su Yes. Poi clicca su Save e avvia una nuova sincronizzazione.

Se desideri usare un link di disiscrizione per i clienti, allora ogni cliente recuperato dal backend Shopify ha un attributo unsub_url che può essere utilizzato nei design auto email nel campo di disiscrizione: {{customer.unsub_url}}

La versione dell’API Webhooks deve essere impostata almeno a 2022-04, dove questo supporto è stato aggiunto. Puoi verificarlo nell’app che hai creato per Clerk nel Developer Dashboard sotto Settings.

App personalizzata legacy #

Da gennaio 2026, Shopify non consente più la creazione di app personalizzate direttamente nell’admin di Shopify per i negozi. Le app personalizzate esistenti continuano a funzionare, ma questo metodo deve essere utilizzato solo se hai già un’app personalizzata configurata. Per tutte le altre configurazioni, usare il metodo Developer Dashboard qui sopra.

Se hai già un’app personalizzata e devi utilizzarla o modificarla, seleziona Shopify (Legacy Custom App) come Sync Method in my.clerk.io > Data > Configuration.

Questi passaggi si applicano solo se il tuo store Shopify ha ancora accesso per creare app personalizzate nell’admin di Shopify.

1. In Shopify, vai su Apps > App and sales channel settings e fai clic su Develop apps.

2. Fai clic su Create app, assegna il nome “Clerk.io”, scegli lo sviluppatore dell’app, poi clicca nuovamente su Create app.

3. Fai clic su Configuration → Admin API integration → Configure.

4. Sotto Admin API access scopes, concedi l’accesso in sola lettura (scopes che iniziano con read_) ai seguenti:

   • Customers

   • Inventory

   • Locales

   • Markets

   • Online Store Pages

   • Orders

   • Products

   • Store Content

   • Translations

5. Fai clic su Save, poi su Install App → Install.

6. Apri API Credentials e copia il tuo Shopify Domain e le chiavi API Key, Access Token e Secret Key dell’app.

7. Vai su my.clerk.io > Data > Configuration. Sotto Sync Method, seleziona Shopify (Legacy Custom App).

8. Incolla questi valori nel modulo. Scegli una dimensione immagine predefinita se richiesto, poi fai clic su Start Sync.