Shopify con un'app personalizzata

Il modo abituale per collegare Shopify è l’app FlowHunt dallo Shopify App Store (vedi store ecommerce). Se non vuoi un’app pubblica sul tuo store, o se le policy del tuo store bloccano le installazioni dall’App Store, puoi collegarti con un’app personalizzata che crei tu stesso nello Shopify Dev Dashboard.

Una volta collegata, un’app personalizzata funziona esattamente come un’installazione dall’App Store: preventivo di importazione, importazione storica di ordini e prodotti, report Eshop, link building e CMS.

Le integrazioni ecommerce sono disponibili dal piano Pro e solo gli amministratori del workspace possono collegarle.

Prima di iniziare#

• Usa l’organizzazione Shopify dello store stesso. L’app deve appartenere alla stessa organizzazione Shopify dello store. Un’agenzia non può usare la propria app sullo store di un cliente, quindi è il cliente a dover creare l’app.
• Fatturazione con carta. I workspace fatturati tramite Shopify non possono usare un’app personalizzata. Passa prima il piano alla fatturazione con carta.
• Permessi Shopify. Devi poter creare app nel Dev Dashboard dello store (il proprietario dello store, oppure un account dello staff autorizzato a sviluppare app).

Crea l’app in Shopify#

1. Apri lo sviluppo app nell’admin Shopify

   Nell’admin Shopify, fai clic su Settings, poi su Apps, poi su Develop apps, e fai clic su Build apps in Dev Dashboard. Puoi anche andare direttamente allo Shopify Dev Dashboard e accedere con l’account proprietario dello store.

   

   

   

   

2. Crea l’app

   Nel Dev Dashboard, apri Apps e fai clic su Create app. Se la tua organizzazione ha già delle app, fai clic su Create app in alto a destra e scegli Create app manually.

   

   

3. Compila l’app e i suoi scope

   • App name (1): un nome che riconoscerai, ad esempio “AmICited”.
   • App URL (2): https://app.flowhunt.io/. Deseleziona Embed app in Shopify admin; l’app non ha una schermata propria all’interno di Shopify.
   • Allowed redirection URL(s): lascia vuoto. AmICited accede con il Client ID e il Client secret dell’app, quindi Shopify non reindirizza mai verso AmICited. Lascia Use legacy install flow deselezionato.
   • Scopes (3, sotto API access): incolla questo elenco. Sono gli scope richiesti dall’app dell’App Store, quindi l’app personalizzata ottiene tutte le funzionalità di AmICited tranne lo storico ordini più vecchio di 60 giorni (vedi sotto):

   textCopia

   read_orders,write_orders,read_products,write_products,read_customers,write_customers,read_inventory,write_inventory,read_locations,write_price_rules,read_content,write_content,read_themes,write_themes,read_locales

   Lascia Webhooks API version così com’è.

   

   Preferisci selezionare le caselle invece di incollare? Fai clic su Select from list sopra il campo Scopes, cerca ogni scope dell’elenco qui sopra (1), selezionalo e fai clic su Done (2).

   

   

4. Crea l’app

   Dopo aver compilato nome, URL e scope, fai clic su Create app in alto a destra nel modulo (4 nello screenshot del modulo qui sopra). Shopify crea l’app e rilascia la sua prima versione.

   

5. Verifica che la versione sia attiva

   Apri Versions nel menu dell’app: la prima versione è contrassegnata come Active. Se in seguito modifichi gli scope, fai clic su Create version perché la modifica abbia effetto.

   

6. Imposta la distribuzione come personalizzata

   Un’app personalizzata deve essere limitata al tuo store prima di poter essere installata.

   1. Nella pagina Overview dell’app, fai clic sulla scheda Distribution (Manage custom install link). Shopify apre il Partners Dashboard; se richiesto, scegli l’account che usi per lo store.
   2. Seleziona Custom distribution (1) e fai clic su Select (2). In seguito Shopify non consente di cambiare il metodo di distribuzione.
   3. In Store domain, inserisci l’indirizzo your-store.myshopify.com del tuo store (1; vedi Trova l’indirizzo del tuo store più sotto) e fai clic su Generate link (2). Allow multi-store install for one Plus organization conta solo se il tuo store appartiene a un’organizzazione Shopify Plus con più store.

   

   

   

   

7. Installa l’app sul tuo store

   L’app non può leggere nulla finché non è installata sullo store.

   1. Apri la pagina Overview dell’app nel Dev Dashboard e fai clic su Install app in cima alla scheda Installs. In alcune dashboard questo pulsante si chiama Test app, come nello screenshot qui sotto. Puoi anche aprire il menu ⋯ sulla riga dell’app nell’elenco Apps e scegliere Install app.
   2. Scegli lo store che vuoi collegare.
   3. Controlla gli accessi richiesti dall’app e fai clic su Install.

   

   

   

   La schermata avvisa che “This app hasn’t been reviewed”. È normale: si tratta della tua app, non di un’app dell’App Store.

8. Copia il Client ID e il Client secret

   Apri Settings dell’app nel Dev Dashboard. In Credentials, copia il Client ID e il Client secret (usa i pulsanti di copia accanto a ciascun campo). Tratta il secret come una password.

   

   

   

Collegala in AmICited#

1. Trova l’indirizzo del tuo store

   Nell’admin Shopify, apri Settings. L’indirizzo dello store (your-store.myshopify.com) è mostrato sotto il nome dello store, in cima al menu.

   

2. Apri la finestra di Shopify

   Vai su Origini dati, sotto Eshops fai clic su Connect Shopify Store, poi su Use a custom app instead (1 nello screenshot qui sotto).

3. Inserisci lo store e le credenziali

   Inserisci lo Store address, il Client ID e il Client secret (2), poi fai clic su Connect store (3).

   

4. Scegli il dominio e conferma l’importazione

   Associa lo store a un dominio e scegli quanto storico ordini importare, come per un’installazione dall’App Store. Ogni opzione mostra le righe previste e il costo una tantum prima della conferma.

Dopodiché, configura i dati dei clienti e le impostazioni dello shop come per qualsiasi store.

In cosa si differenzia un’app personalizzata#

Correlati#