Get Started

Collegare il tuo Negozio #

Il primo passo per installare Clerk.io è collegare il tuo negozio con il tuo account Clerk.io.

Dopo aver seguito questi semplici passaggi, sarai in grado di vedere 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 Negozio #

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

1. Scrivi il Nome e il Dominio del tuo webshop

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

3. Clicca su Aggiungi Negozio.

2. Installa e configura il modulo #

1. Sulla CLI di vtex esegui vtex install clerkiopartnerdk.integration-vtex. Puoi confermare che l’app è stata installata eseguendo di nuovo vtex ls.

2. Accedi alla sezione App nella pagina di amministrazione del tuo account e cerca la casella di integrazione ClerkIO. Una volta trovata, clicca sulla casella. Compila i campi come richiesto. Per i siti MultiBinding, clicca per abilitare la configurazione associando un Negozio 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):

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

È necessario inviare VtexIdclientAutCookie come intestazione.

La prima chiamata alla generazione del feed risponderà con un array vuoto. A seconda delle dimensioni del Catalogo del tuo negozio, il feed potrebbe richiedere del tempo per generarsi

3. Sincronizza il tuo negozio #

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

1. Vai su my.clerk.io Stato del Sistema -> Impostazioni di Sincronizzazione Dati -> Una volta invitato a inserire l’url, inserisci il seguente formato di URL: https://{{accountName}}.myvtex.com/_v/integration-vtex/clerk-feed/{{bindingId}} e clicca su salva in basso a sinistra della pagina.

2. Clicca su “Inizia una nuova sincronizzazione dati”. Questo URL di feed è esclusivo per l’uso di ClerkIO.

Se desideri convalidare il feed del tuo negozio, 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à fatto, il tuo negozio sarà collegato. Ottimo lavoro!