Get Started

Collegamento del tuo Store #

Il primo passo per installare Clerk.io è collegare il tuo store al tuo account Clerk.io.

Dopo aver seguito questi semplici passaggi potrai visualizzare il tuo Demo Store, che ti offre una panoramica personale di come Clerk.io funzionerà sul tuo webshop, prima di configurare il resto del sistema.

1. Aggiungi Store #

Dopo aver effettuato l’accesso a my.clerk.io, la prima cosa che devi fare è aggiungere il tuo store:

1. Scrivi il Nome e il Dominio del tuo webshop

2. Scegli VTEX come Platform e scegli la tua Valuta.

3. Clicca su Add Store.

2. Installa e configura il modulo #

1. Nel vtex cli esegui vtex install clerkiopartnerdk.integration-vtex. Puoi confermare che l’app è stata installata eseguendo nuovamente vtex ls.

2. Accedi alla sezione Apps nella pagina di amministrazione del tuo account e cerca il ClerkIO Integration box. Una volta trovato, cliccaci sopra. Compila i campi come richiesto. Per i siti MultiBinding, clicca su abilita configurazione tramite binding per associare uno Store Clerk a ciascun Binding.

3. Genera i feed per prodotti, categorie e ordini effettuando una richiesta POST ai seguenti endpoint (sostituendo accountName, workspace e bindingID):

Esegui una richiesta GET a questo endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

È necessario che VtexIdclientAutCookie sia inviato come header.

La prima chiamata per la generazione del feed risponderà con un array vuoto. A seconda della dimensione del Catalogo del tuo store, il feed potrebbe richiedere del tempo per essere generato

3. Sincronizza il tuo store #

Dopo aver configurato il modulo, devi semplicemente sincronizzare il tuo store.

1. Vai su my.clerk.io Dati -> Configurazione -> Quando ti viene richiesto di inserire l’url, inserisci il seguente formato URL: https://{{accountName}}.myvtex.com/_v/integration-vtex/clerk-feed/{{bindingId}} e clicca su salva in basso a sinistra della pagina.

2. Clicca su “Start new data sync”. Questo URL del feed è esclusivo per l’utilizzo di ClerkIO.

Se desideri validare il feed del tuo store utilizza invece questo endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}} questo endpoint richiede l’autenticazione VTEX.

Clerk.io importerà ora i tuoi prodotti, categorie e vendite. Quando sarà completato, il tuo store sarà connesso. Ottimo lavoro!