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 negozio Shopify con Clerk, è necessario creare un’app nel Developer Dashboard di Shopify e configurarla in Clerk. L’utente che imposta la sincronizzazione deve avere accesso al Developer Dashboard e i permessi per sviluppare app sul negozio Shopify.

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

Crea l’app #

1. In Shopify, clicca su Settings.

2. Clicca su Apps and sales channels.

3. Clicca su Develop apps.

4. Clicca su Build apps in Dev Dashboard.

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

5. Nel Developer Dashboard, clicca 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 la spunta. L’app deve essere installata una sola volta e non deve apparire nel menu laterale di Shopify.

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

Configura gli scope #

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

• Customers

• Inventory

• Locales

• Markets

• Metaobjects

• Online Store Pages

• Orders

• Products

• Store Content

• Translations

11. In fondo alla schermata, clicca su Release.

Installa l’app #

12. Clicca su Home, poi clicca su Install app in alto a destra.

13. Shopify ti reindirizza a una pagina dove selezioni il negozio Shopify su cui installare l’app. Scegli il tuo negozio dall’elenco.

14. Nella pagina seguente, verifica il riepilogo dei dettagli dell’app e clicca su Install in basso a destra.

Connetti a Clerk #

15. Torna al Developer Dashboard e clicca 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. Poi clicca su Start Sync.

Problema noto: Shopify potrebbe non generare un token al primo tentativo di sincronizzazione, causando un errore di autenticazione. Questo è un problema intermittente noto di Shopify. Attendi semplicemente 1-2 minuti, quindi prova a sincronizzare di nuovo.

Personalizzazione dei dati prodotto #

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 inserisci gli attributi dei prodotti da includere.

Per aggiungere più attributi, separali con una virgola.

Gli attributi devono essere sempre scritti usando il loro key.

Di solito sarà tutto minuscolo. Ad esempio, l’attributo “Sizes” deve essere “sizes”.

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

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

Sincronizza iscritti #

Shopify consente di gestire gli iscritti direttamente all’interno della piattaforma.

Questi possono essere facilmente sincronizzati con Clerk.

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

Ciò può quindi essere usato per l’Auto-Email.

Vai semplicemente nel tuo negozio my.clerk.io, poi Data -> Configuration e imposta Include Subscriber State su Yes. Poi clicca su Save e avvia una nuova sincronizzazione.

Se vuoi usare un link di disiscrizione per i clienti, ogni cliente importato da un backend Shopify avrà un attributo unsub_url che può essere usato per i design delle auto email nel campo di disiscrizione: {{customer.unsub_url}}

La versione delle API Webhooks deve essere impostata almeno su 2022-04, dove questo supporto è stato aggiunto. Puoi verificarlo nell’app creata per Clerk nel Developer Dashboard sotto Settings.

Legacy Custom App #

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

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

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

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

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

3. Clicca su Configuration → Admin API integration → Configure.

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

   • Customers

   • Inventory

   • Locales

   • Markets

   • Metaobjects

   • Online Store Pages

   • Orders

   • Products

   • Store Content

   • Translations

5. Clicca su Save, poi Install App → Install.

6. Apri API Credentials e copia il tuo dominio Shopify e l’API Key dell’app, l’Access Token e la Secret Key.

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

8. Incolla questi valori nel modulo. Scegli la dimensione immagine predefinita se richiesto, poi clicca su Start Sync.