HIKO Wish Keeper

Servono due cose: attivare l'app embed nel tema e attivare la lista dei desideri nelle impostazioni dell'app.

Passo 1 — attivare l'app embed

1. Apri HIKO Wish Keeper nel pannello di amministrazione Shopify
2. Premi «Attiva nel tema» in alto nella pagina: l'editor dei temi si apre con l'app embed già selezionato
3. Verifica che l'interruttore sia attivo e salva nell'editor dei temi

Passo 2 — attivare la lista dei desideri nelle impostazioni

1. Torna alla pagina Impostazioni di HIKO Wish Keeper
2. In Pagine prodotto attiva «Attiva la lista dei desideri nelle pagine prodotto»
3. In Pagine collezione attiva «Attiva la lista dei desideri nella griglia prodotti»
4. Premi Salva

I pulsanti compariranno automaticamente nel negozio. Non serve modificare il codice del tema.

L'app embed è la causa più frequente del «non compare niente». Tutto ciò che questa app disegna nel negozio — i pulsanti, la pagina account, le pagine delle liste condivise — viene caricato da quell'unico app embed.

Sì. Nelle Impostazioni di HIKO Wish Keeper attiva «Accesso obbligatorio». Finché resta attiva, per i visitatori non autenticati la lista dei desideri non viene caricata affatto e non compare alcun pulsante.

Lasciala disattivata se vuoi che anche gli ospiti possano salvare prodotti. Le loro liste vivono nel loro browser e vengono unite all'account al primo accesso, quindi non si perde nulla.

La pagina Analisi raccoglie quello che serve per capire il comportamento dei tuoi clienti.

• Tutti i clienti con una lista dei desideri e i prodotti che hanno salvato
• I prodotti più salvati del tuo negozio
• Tassi di consegna, apertura e clic delle notifiche
• Attività di condivisione per piattaforma (Facebook, Twitter, Pinterest, WhatsApp, LINE)
• Andamento delle visualizzazioni dei prodotti e tendenze di popolarità
• Conversione e stato di fatturazione degli ordini in bozza
• Confronto dell'attività per giorno e per settimana
• Esportazione delle e-mail dei clienti e dei dati delle liste in CSV

La pagina account è una pagina del tuo negozio che raccoglie tutto ciò che questa app gestisce per un cliente. Si trova all'indirizzo /apps/hwl/account ed è organizzata in schede: la lista dei desideri e, dopo l'accesso, ordini, indirizzi, profilo, preferenze di notifica e ordini in bozza.

È attiva per impostazione predefinita. Puoi disattivarla da Pagina account > Pagina account; quell'indirizzo smette allora di funzionare e i collegamenti che vi rimandano scompaiono dal negozio.

La pagina account è disegnata dall'app embed, esattamente come i pulsanti. Se l'embed è disattivato il cliente raggiunge la pagina, ma al posto del proprio account vede un breve messaggio di caricamento.

Con entrambi, e non c'è nulla da attivare. L'app non chiede quale versione usa il tuo negozio.

Il motivo sta in dove si trova la pagina account. È una pagina del tuo stesso negozio, all'indirizzo /apps/hwl/account, disegnata dal tuo tema — non una pagina all'interno dell'area account ospitata da Shopify. Legge il cliente che ha effettuato l'accesso, i suoi ordini e i suoi indirizzi tramite il tema, esattamente come qualsiasi altro template, e tutto questo funziona allo stesso modo in entrambe le versioni.

Anche l'accesso funziona in entrambi i casi. Il link di accesso fornito dall'app punta a /customer_authentication/login: Shopify porta il cliente alla schermata di accesso corretta per la versione del tuo negozio e poi lo riporta al punto di partenza.

C'è una differenza, ed è di Shopify, non nostra. Con i nuovi account cliente, le pagine account ospitate da Shopify non possono mostrare contenuti di un'app del tema, quindi lì non esiste un accesso alla lista dei desideri. Per questo l'app indirizza l'icona account nell'header del tema alla pagina account. Con gli account cliente classici quell'icona continua a portare alle pagine account di Shopify, che funzionano normalmente: i clienti raggiungono la pagina account dall'icona a forma di cuore o da qualsiasi link tu aggiunga.

Vai in Pagina account > Schede. Ogni scheda ha un interruttore e un'icona, e con le frecce ne cambi l'ordine. L'ordine che imposti è esattamente quello che vedranno i tuoi clienti.

Le schede sono Profilo, Indirizzi, Lista dei desideri, Ordini, Ordini in bozza e Preferenze di notifica. Le ultime due richiedono un piano a pagamento; tutte le altre sono attive dall'inizio.

Due regole da conoscere:

• A parte la lista dei desideri, tutte le schede richiedono che il cliente abbia effettuato l'accesso. Un visitatore non autenticato vedrà solo la lista dei desideri, qualunque cosa tu abbia attivato.
• Disattivare una scheda la nasconde soltanto, non cancella nulla. Se la riattivi i dati sono intatti.

Tutto si trova in Pagina account, e l'anteprima dal vivo segue ogni modifica.

1. Layout — quattro disposizioni: barra laterale, schede, dashboard (riquadri) o fisarmonica
2. Colori — chiaro, scuro, caldo o automatico (l'automatico segue le preferenze di sistema del visitatore)
3. Colore del marchio — usato per pulsanti, collegamenti e scheda attiva. Nel tema scuro viene schiarito automaticamente, così un colore scuro non sparisce
4. CSS personalizzato — per quello che le impostazioni non coprono; vale solo all'interno della pagina account

Sì, con un piano a pagamento. In Pagina account > Schede apri Profilo e aggiungi i campi: testo, elenco a tendina con opzioni tue, data o casella di controllo.

Le risposte vengono salvate come metacampi del cliente Shopify, quindi sono utilizzabili in Shopify Flow, nei segmenti e nel tema. Il riquadro Dove vengono salvati i campi, nella stessa pagina, indica namespace e chiave esatti di ogni campo.

Tre cose da sapere prima di cominciare:

• Il tipo di campo non si può cambiare in seguito. È un vincolo di Shopify. Sceglilo bene dall'inizio: cambiarlo richiede un campo nuovo.
• Rimuovere un campo lo toglie solo dal modulo. Le risposte già raccolte e la definizione restano in Shopify. È voluto: un clic sbagliato non deve cancellare i dati dei clienti di un intero negozio.
• Con il piano gratuito puoi comunque modificare e rimuovere i campi esistenti. Solo l'aggiunta è riservata ai piani a pagamento.

Il cuore nell'intestazione del negozio porta dove quel cliente può davvero vedere la propria lista.

• Senza accesso — alla pagina della lista dei desideri autonoma
• Con accesso e scheda lista dei desideri attiva — alla scheda lista dei desideri della pagina account
• Con accesso e scheda lista dei desideri disattivata — alla pagina della lista dei desideri autonoma

Se mostri la lista come finestra a comparsa o pannello laterale, il cuore mantiene quel comportamento e non porta a nessuna pagina.

In Pagina account > Dopo l'accesso scegli tra tre destinazioni: la pagina account (predefinita), la home page o una pagina scelta da te.

Per una destinazione tua, scrivi un percorso che inizi con una barra, per esempio /pages/soci. Gli URL completi vengono rifiutati: il reindirizzamento accetta solo percorsi interni al negozio, e un valore rifiutato ricade silenziosamente sulla pagina account.

Questa impostazione vale per qualunque via d'accesso, compresa l'icona dell'account nell'intestazione del tema.

HIKO Wish Keeper ha un solo piano a pagamento, con fatturazione mensile o annuale.

• Gratuito — la lista dei desideri completa, senza limiti al numero di liste o di articoli salvati, con le analisi della pagina Analisi e la condivisione sui social
• Professional — 6,99 $ al mese o 62 $ all'anno. In più: notifiche e-mail, accesso all'API, ordini in bozza con fatturazione e campi di profilo personalizzati nella pagina account

Il piano a pagamento comprende 7 giorni di prova gratuita. Puoi cambiare in qualsiasi momento dalla pagina di passaggio a un piano superiore.

No. Shopify applica automaticamente il calcolo proporzionale e scala la parte non utilizzata del piano attuale. Paghi solo la differenza.

Passando da mensile ad annuale, i giorni che restano del ciclo mensile vengono scalati dal prezzo annuale. Se cambi a metà mese, per esempio, viene sottratta quella mezza mensilità non usata.

Di tutto questo si occupa il sistema di fatturazione di Shopify: non devi fare nulla.

Passati i 7 giorni, Shopify ti invia un'e-mail chiedendoti di approvare l'abbonamento ricorrente. Non viene addebitato nulla automaticamente: Shopify richiede sempre un'approvazione esplicita.

Se approvi, l'abbonamento prosegue normalmente. Se non approvi entro 2 giorni, il negozio torna al piano gratuito e le funzioni a pagamento restano inaccessibili fino a un nuovo abbonamento.

Puoi riabbonarti quando vuoi dalla pagina di passaggio a un piano superiore. Il passaggio a un piano inferiore non cancella nulla: liste, campi personalizzati e impostazioni restano al loro posto.

L'aspetto del pulsante si regola nel dettaglio, tutto dalla pagina Impostazioni.

1. Cambia forma, colore e dimensione dell'icona in Impostazioni > Stile globale
2. Regola separatamente il colore attivo (salvato) e quello inattivo
3. Scegli l'effetto di animazione: pulsazione, rimbalzo o nessuno
4. Regola la dimensione dell'icona e lo spessore del tratto
5. Segui le modifiche nell'anteprima dal vivo

Sì, separatamente per le pagine collezione e le pagine prodotto.

1. Pagine collezione: posizione (in alto a destra, in alto a sinistra, in basso a destra, in basso a sinistra) e margini
2. Pagine prodotto: mostrarlo come «sovrapposizione sull'immagine» o come «pulsante standard»
3. Collocazione: accanto ad «Aggiungi al carrello», sotto il prezzo o in un punto scelto da te
4. Stile del pulsante: «icona + testo» o «solo icona»

L'app è tradotta in 15 lingue: inglese, cinese tradizionale, cinese semplificato, giapponese, coreano, tedesco, francese, spagnolo, italiano, portoghese, russo, vietnamita, thailandese, arabo ed ebraico. Ogni cliente vede la lingua del proprio browser, senza che tu debba impostare nulla.

La pagina Traduzioni non serve ad aggiungere lingue, ma a cambiare la formulazione.

1. Apri la pagina Traduzioni dalla navigazione
2. Scegli la lingua principale nel menu a tendina
3. Modifica le etichette dei pulsanti, i messaggi e i nomi delle liste che vuoi formulare diversamente
4. Salva

Puoi aggiungere qualsiasi lingua con una traduzione personalizzata.

1. Apri la pagina Traduzioni
2. Premi «Aggiungi lingua»
3. Inserisci il codice della lingua (ko per il coreano, de per il tedesco)
4. Traduci tutti i testi: etichette dei pulsanti, avvisi, nomi delle liste, testi delle finestre
5. Premi Salva

Quando la lingua del browser di un cliente corrisponde al tuo codice, viene usata la tua traduzione. Ogni testo che i clienti vedono resta nelle tue mani.

I tuoi clienti possono condividere qualsiasi lista personale con amici e parenti tramite un collegamento dedicato.

1. Aprire la pagina della lista dei desideri e scegliere una lista personale
2. Premere «Condividi» per copiare il collegamento
3. Inviarlo a chi si vuole: chi lo riceve non ha bisogno di un account
4. La pagina condivisa mostra tutti gli articoli con informazioni e prezzi

Ogni lista personale riceve automaticamente un token di condivisione univoco. Anche le liste predefinite «Preferiti» e «Da vedere poi» si possono condividere.

Sì. Chi apre un collegamento condiviso può iscriversi a quella lista.

1. Aprire il collegamento inviato da un amico
2. Premere «Iscriviti» per aggiungerla alla propria pagina della lista dei desideri
3. Le liste seguite compaiono accanto a quelle personali
4. Le modifiche di chi possiede la lista arrivano automaticamente agli iscritti

I tuoi clienti possono condividere i prodotti salvati sui social.

• Facebook — condividere il prodotto con immagine e descrizione
• Twitter / X — pubblicare un messaggio con il collegamento al prodotto
• Pinterest — salvare l'immagine del prodotto
• WhatsApp — inviare il collegamento con un messaggio
• LINE — condividere tramite LINE
• E-mail — inviare il collegamento al prodotto via e-mail
• Copia collegamento — copiare l'URL del prodotto negli appunti

Si attiva in Impostazioni > Condivisione sui social. Scegli le piattaforme da mostrare e puoi modificare il modello del messaggio.

I tuoi clienti vengono avvisati automaticamente quando il prezzo di un prodotto salvato scende.

1. Vai in Notifiche > Impostazioni
2. Attiva «Avvisi di calo di prezzo»
3. Imposta la soglia (qualsiasi calo, una percentuale o un importo)
4. Imposta la frequenza dei controlli (ogni ora, ogni giorno…)
5. I clienti che hanno dato il consenso ricevono le e-mail automaticamente

Gli avvisi di prodotto tornato disponibile vengono inviati solo quando un prodotto passa da non disponibile a disponibile. Alla prima lettura dello stato di magazzino non viene inviato nulla, per scelta: altrimenti tutti i tuoi clienti riceverebbero un'e-mail il giorno dell'installazione.

Per inviare notifiche devi configurare un fornitore e-mail.

1. Vai in Notifiche > Impostazioni
2. Scegli un fornitore: Resend, SendGrid, Brevo o SMTP personalizzato
3. Inserisci la chiave API e i dati del mittente
4. Verifica la configurazione con «Invia e-mail di prova»
5. Attiva i tipi di notifica che vuoi
6. Imposta la frequenza dei controlli automatici

La via più semplice è Resend; una chiave API gratuita si ottiene su resend.com.

Sì. Puoi comporre e-mail in linea con il tuo negozio.

1. Vai in Notifiche > Modelli
2. Scegli il tipo di notifica (calo di prezzo, prodotto tornato disponibile…)
3. Scegli la lingua del modello
4. Modifica l'oggetto dell'e-mail
5. Adatta il corpo HTML al tuo marchio
6. Aggiungi una versione in solo testo per i programmi che non gestiscono l'HTML
7. Usa variabili come {{product_title}}, {{new_price}} o {{product_url}} per i contenuti dinamici
8. Guarda l'anteprima prima di salvare

L'assistenza con l'IA ti aiuta a produrre rapidamente un modello ben rifinito.

Un ordine in bozza ti permette di preparare un ordine per un cliente a partire dai prodotti che ha salvato. È una funzione dei piani a pagamento.

• Creare un ordine in bozza direttamente dagli articoli salvati di un cliente
• Inviare una fattura perché il cliente completi l'acquisto
• Seguire lo stato: bozza, inviato, aperto, cliccato, completato
• Annullare o eliminare un ordine in bozza in qualsiasi momento
• Consultare tutti gli ordini in bozza e il loro stato nella pagina dedicata

Nella scheda Ordini in bozza della pagina account. Attivala in Pagina account > Schede; è disattivata per impostazione predefinita perché richiede un piano a pagamento.

Lì il cliente vede tutte le fatture ancora da pagare, con un collegamento al pagamento e la possibilità di annullare. Anche le e-mail di fattura che invii portano esattamente lì.

Le versioni precedenti offrivano un blocco del tema da inserire a mano nell'editor dei temi. Quei blocchi sono stati rimossi: la scheda della pagina account li sostituisce e non c'è più nulla da aggiungere al tema.

Tutto avviene nella pagina Ordini in bozza di HIKO Wish Keeper.

1. Nella pagina Ordini in bozza trova o cerca il cliente
2. Premi sul cliente per vedere i suoi prodotti salvati
3. Spunta gli articoli da includere
4. Premi «Crea ordine in bozza (N)», dove N è il numero di articoli selezionati
5. Nella finestra puoi impostare uno sconto (percentuale o importo), una durata di riserva e una nota
6. «Crea» mostra un riepilogo con il dettaglio dei prezzi
7. «Conferma» crea l'ordine in bozza; «Conferma e invia» lo crea e invia subito la fattura

Il cliente riceve un'e-mail con un collegamento al pagamento. Ogni stato — bozza, inviato, aperto, cliccato, completato — si segue dalla pagina Ordini in bozza.

Gli ordini in bozza richiedono il piano Professional (6,99 $ al mese o 62 $ all'anno).

Se non si vede nessun pulsante, controlla questi punti nell'ordine.

• La funzione è attiva in Impostazioni > Pagine prodotto o Pagine collezione?
• L'app embed di questa app è attivo nell'editor dei temi, sezione «App embeds»?
• L'opzione «Accesso obbligatorio» è attiva nelle impostazioni? In quel caso la lista non viene caricata per i visitatori non autenticati
• Svuota la cache del browser e ricarica la pagina
• Il tema supporta i blocchi app (un tema Online Store 2.0)?
• Verifica in una finestra di navigazione anonima
• Se nulla di questo aiuta, scrivi all'assistenza

La pagina account è disegnata dall'app embed. Se resta il messaggio di caricamento, significa che l'embed è disattivato.

1. Premi «Attiva nel tema» in alto nella pagina dell'app
2. Verifica che l'interruttore sia attivo e salva nell'editor dei temi

Se l'indirizzo risponde «non trovato», è la pagina account stessa a essere disattivata: riattivala in Pagina account > Pagina account.

Se le e-mail non arrivano, controlla le cause più comuni.

• La chiave API del fornitore in Notifiche > Impostazioni è corretta?
• L'indirizzo del mittente è verificato presso il fornitore?
• Il cliente ha dato il consenso a ricevere le notifiche?
• Lo storico degli invii in Analisi > Notifiche segnala errori?
• Invia un'e-mail di prova per verificare la configurazione
• Controlla i messaggi respinti e i problemi di consegna nel pannello del tuo fornitore

Siamo qui per aiutarti.

• Per questioni tecniche: [email protected]
• Invia un messaggio direttamente con il pulsante di assistenza nell'app
• Le domande più frequenti sono raccolte in queste FAQ

Invia la tua chiave API come token Bearer nell'intestazione Authorization: Authorization: Bearer your_api_key. Le chiavi si creano nella pagina Integrazione API.

Funzionano entrambi: l'ID numerico (per esempio 1234567890) e il GID Shopify completo (per esempio gid://shopify/Customer/1234567890). Tutti gli endpoint accettano le due forme.

L'API usa i consueti codici di stato HTTP.

• 200 – Riuscito: la richiesta è stata elaborata
• 400 – Richiesta non valida: parametri errati o mancanti
• 401 – Non autorizzato: chiave API assente o non valida
• 404 – Non trovato: la risorsa non esiste
• 429 – Troppe richieste: il limite è stato superato
• 500 – Errore del server: il problema è nostro

Gli endpoint di elenco accettano i parametri page e limit. La risposta contiene un oggetto pagination con la pagina corrente, il numero totale di pagine e il numero totale di elementi, così da poter percorrere anche grandi insiemi di risultati.

Sì. Configura un URL webhook nella pagina Integrazione API: l'app vi invierà una richiesta POST a ogni evento della lista dei desideri. Non serve interrogare ciclicamente.