Come creare un Chatbot AI FlowHunt per Shopify

Questa guida ti accompagna nella connessione di FlowHunt al tuo negozio Shopify, aggiungendo un flow chatbot Shopify predefinito, pubblicandolo e incorporando il chatbot sul tuo storefront.

Prerequisiti

• Un negozio Shopify con accesso amministratore
• Un account FlowHunt con accesso al workspace: https://app.flowhunt.io/
• Importante: Usa la stessa email per il tuo account FlowHunt e per l’account admin di Shopify.

1) Integra Shopify con FlowHunt (tramite Shopify App Store)

1. Apri lo Shopify App Store e cerca “FlowHunt”.
2. Clicca su Installa e, se richiesto, seleziona il negozio corretto.
3. Controlla le autorizzazioni richieste e clicca su Installa app / Autorizza.

Dopo l’installazione, verrai reindirizzato su Shopify e/o FlowHunt. La connessione viene creata tramite il flusso di installazione dal marketplace.

2) Installa l’app FlowHunt sul tuo negozio Shopify

1. Nella schermata di autorizzazione Shopify, verifica le autorizzazioni richieste.
2. Clicca su Installa app per completare l’installazione.

3) Conferma che l’integrazione Shopify sia attiva

Dopo l’installazione, torna su FlowHunt → Integrazioni. Dovresti vedere Shopify contrassegnato come Connesso/Abilitato.

Se non è abilitato, clicca di nuovo su Connetti e segui il flusso di autorizzazione.

4) Aggiungi un chatbot Shopify dalla Flow Library

1. Su FlowHunt, vai su Flow Library.
2. Cerca “Shopify Chatbot”.
3. Apri il template e clicca su Aggiungi al Workspace.

In questo modo aggiungerai un flow chatbot Shopify pronto all’uso al tuo workspace.

5) Personalizza il chatbot per il tuo brand

Apri il flow appena aggiunto e modifica:

• Prompt di sistema e tono: Definisci la voce del tuo brand e le regole di comportamento.
• Fonti di conoscenza: Collega il catalogo prodotti, le FAQ, le policy o altri documenti.
• Strumenti e azioni: Abilita opzionalmente la ricerca ordini, il controllo stato o aggiornamenti CRM se il tuo piano e la configurazione lo consentono.
• UI/branding: Configura nome del widget, saluti e qualsiasi etichetta visibile successivamente nella sezione Chatbot.

Al termine, salva le modifiche.

6) Pubblica il flow

Clicca su Pubblica sul flow così sarà disponibile per essere utilizzato da un chatbot sul tuo sito/negozio.

7) Crea un nuovo Codice di Integrazione (Chatbot)

1. Vai su Chatbot in FlowHunt.
2. Clicca su Nuovo Codice di Integrazione.
3. Seleziona il flow pubblicato che hai creato prima.
4. Configura le opzioni del widget (tema, posizione, comportamento di apertura, lingua, allowlist domini, ecc.).
5. Salva. FlowHunt genererà uno snippet di script (il tuo Codice di Integrazione).

Tieni a portata di mano questo snippet—lo incollerai nel tema Shopify nel prossimo passaggio.

8) Incorpora il chatbot sul tuo storefront Shopify

Puoi aggiungere il Codice di Integrazione in due modi. Scegli l’opzione che meglio si adatta alle tue esigenze.

Opzione A — Aggiungi a theme.liquid (tutto il sito)

Questo metodo aggiunge il chatbot a ogni pagina del negozio. Segui questi passaggi dettagliati:

Passo 1: Vai nell’area admin di Shopify e vai su Negozio Online > Temi

Passo 2: Clicca sul pulsante Personalizza accanto al tema attivo Passo 3: Clicca sui 3 puntini (⋯) in alto a sinistra e seleziona Modifica codice

Passo 4: Trova il file theme.liquid nella cartella Layout (/layout/theme.liquid)

Passo 5: Aggiungi il Codice di Integrazione appena prima del tag di chiusura </body> Passo 6: Salva le modifiche premendo Ctrl + S (o Cmd + S su Mac)

Dopo aver salvato, visita il tuo storefront e aggiorna la pagina. Il chatbot dovrebbe apparire su tutte le pagine.

Note importanti:

• Incollare prima di </body> garantisce che il widget si carichi su ogni pagina
• Mantieni intatto e non modificare lo snippet FlowHunt
• Il chatbot apparirà su tutte le pagine del negozio

Opzione B — Aggiungi tramite una sezione Custom Liquid (pagine specifiche)

Questo metodo ti consente di mostrare il chatbot solo su specifiche pagine o template. Perfetto se vuoi il chatbot solo sulle pagine prodotto o su determinate landing page.

Passo 1: Vai su Negozio Online > Temi e clicca su Personalizza accanto al tema attivo

Passo 2: Vai sul template specifico dove vuoi aggiungere il chatbot (es. pagine prodotto, pagine collezione o una pagina specifica)

Passo 3: Clicca su Aggiungi sezione o Aggiungi blocco (a seconda del tema) Passo 4: Cerca e seleziona Custom Liquid tra le opzioni disponibili Passo 5: Incolla il tuo Codice di Integrazione FlowHunt nell’area contenuto Custom Liquid

Passo 6: Clicca su Salva e poi Anteprima per testare il chatbot su quel template specifico

Note importanti:

• Questo metodo ti dà controllo preciso su dove appare il chatbot
• Dovrai ripetere questi passaggi per ogni template dove vuoi il chatbot
• Ottimo per testare il chatbot su pagine specifiche prima di renderlo visibile su tutto il sito
• Il chatbot apparirà solo sui template che hai configurato

Verifica e test

• Apri lo storefront in una finestra in incognito/privata per evitare asset in cache.
• Fai domande comuni (spedizioni, resi, disponibilità prodotti) per validare il flow.
• Rivedi i log delle conversazioni in FlowHunt (abilita Verbose se necessario) per vedere quali documenti o strumenti sono stati utilizzati.

Risoluzione dei problemi

• Chatbot non visibile: Assicurati che il Codice di Integrazione sia incluso nella pagina, che il tema sia pubblicato e che il dominio sia consentito nelle impostazioni Chatbot.
• Widget duplicati: Rimuovi eventuali snippet duplicati e mantieni un solo Codice di Integrazione attivo.
• Risposte mancanti: Verifica le Fonti di Conoscenza e le impostazioni del Document Retriever nel tuo flow, quindi ripubblica.
• Errore permessi Shopify: Riconnetti Shopify da FlowHunt → Integrazioni e reinstalla se richiesto.