Documentazione

Shopify

Aggiungi il tuo agente a qualsiasi negozio Shopify incollando il codice di embed nel tuo tema.

Aggiungi il tuo agente AI a un negozio Shopify incollando il codice di embed nel file theme.liquid del tuo tema. Funziona con ogni piano Shopify.

Per prima cosa, ottieni il tuo codice di embed da Chatbot > Pubblica nel pannello.

Metodo 1: modificare theme.liquid (consigliato)

Aggiungi il widget a tutto il sito modificando il tuo tema pubblicato:

  1. Nell'admin di Shopify, vai su Online Store → Themes.
  2. Sulla riga del tuo tema live, clicca sul menu ... (Actions) → Edit code.
  3. Nella cartella Layout a sinistra, apri theme.liquid.
  4. Scorri fino in fondo e incolla il tuo codice di embed appena prima del tag di chiusura </body>.
  5. Clicca su Save.

Formato di esempio (usa i valori reali da Chatbot > Pubblica):

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>

Il widget appare su ogni pagina dello storefront — prodotto, collezione, carrello, home.

Metodo 2: duplicare prima, poi modificare

Se vuoi un rollback sicuro:

  1. Online Store → Themes.
  2. Sul tuo tema live, clicca sul menu ... (a tre puntini) → Duplicate. Una copia appare in fondo all'elenco dei temi.
  3. Modifica il theme.liquid del duplicato come sopra.
  4. Clicca sul menu ... del duplicato → Preview per testarlo.
  5. Quando sei soddisfatto, clicca sul menu ... → Publish per renderlo live.

Metodo 3: incollare in una pagina specifica

Per aggiungere il widget solo a una pagina (ad esempio una pagina di assistenza):

  1. Nell'admin di Shopify, vai su Online Store → Pages.
  2. Apri la pagina che vuoi modificare.
  3. Clicca sull'icona <> (Show HTML) nell'editor dei contenuti.
  4. Incolla il tuo codice di embed alla fine del contenuto.
  5. Save.

Il widget si caricherà solo su quella pagina.

Requisiti

  • Il tema che modifichi deve essere un tema pubblicato o a pagamento. Il codice di un tema di prova non può essere salvato.
  • Il tuo dominio storefront dovrebbe essere nell'elenco dei domini consentiti del tuo agente se hai attivato le restrizioni di dominio.

Dopo la pubblicazione

Shopify serve le risorse dello storefront dal proprio CDN. Le modifiche si propagano entro un minuto o due. Se non vedi il widget:

  1. Forza l'aggiornamento della pagina (⌘+Shift+R su Mac, Ctrl+F5 su Windows).
  2. Apri il sito in una finestra in incognito.
  3. Controlla la console del browser per eventuali errori.

Risoluzione dei problemi

Il widget non compare.

  • Conferma di aver modificato il tema live (o pubblicato il duplicato).
  • Conferma che lo snippet sia prima di </body>, non dentro <head>.
  • Verifica che il tuo dominio storefront sia consentito in Chatbot > Pubblica > Sicurezza.

Il widget si sovrappone alla chat di Shopify o al cassetto del carrello.

  • Regola la posizione del widget nelle impostazioni Design del tuo agente.

Il widget appare nell'editor ma non nel negozio live.

  • Assicurati di aver cliccato Save dopo aver incollato il codice — l'editor di codice non salva automaticamente.

Test

  1. Apri il tuo storefront in una finestra in incognito.
  2. Cerca la chat bubble nell'angolo.
  3. Clicca per aprirla e invia un messaggio di prova.

Collega un Negozio per Ricerca Prodotti e Verifica Ordini

Incorporare il widget e collegare il tuo negozio sono due cose separate. Il codice di embed sopra inserisce il widget della chat sul tuo storefront. Una connessione Shopify separata — effettuata dalla scheda Azioni > Integrazioni del tuo agente — permette inoltre all'agente di cercare nel tuo catalogo live e verificare lo stato di un ordine all'interno della conversazione.

Puoi fare ciascuna delle due cose da sola. Usa solo l'embed se l'agente deve rispondere esclusivamente in base ai contenuti di addestramento, e aggiungi la connessione al negozio quando vuoi dati live su prodotti e ordini.

Collegare il negozio fornisce solo le credenziali, ma non attiva nulla di per sé: successivamente, aggiungi le azioni Cerca prodotti e Verifica stato ordine nella scheda Azioni del tuo agente e attiva ciascuna che vuoi che l'agente utilizzi.

Configura le azioni Shopify →

Prossimi passi