Domande frequenti su Brilliant (FAQ)

Creato 5 dicembre 2025 09:23

Aggiornato 9 ottobre 2026 16:41

Questo articolo raccoglie risposte rapide alle domande più frequenti sull'installazione, la configurazione, il funzionamento e la risoluzione dei problemi di Brilliant.

Installazione e accesso

Come installo Brilliant nel mio negozio?

Puoi installare Brilliant tramite il Shopify App Store.

Dove posso installare Brilliant?

Puoi installare Brilliant in qualsiasi negozio che utilizzi la piattaforma Shopify.

Quali autorizzazioni richiede l'app durante l'installazione?

Brilliant richiede esclusivamente le autorizzazioni necessarie per analizzare il tuo catalogo e offrire consigli accurati:
- read_inventory: per leggere l'inventario dei tuoi prodotti.
- read_locales: per conoscere le lingue disponibili nel tuo negozio.
- read_publications: per vedere dove sono pubblicati i prodotti (canali).
- read_translations: per visualizzare le traduzioni dei prodotti.
- read_themes: per leggere lo stato di attivazione di Brilliant nel tema attuale.
- read_content: per leggere i blog e le pagine del tuo negozio e utilizzarli come base di conoscenza dell'assistente.
- read_online_store_navigation: per capire come sono organizzati e categorizzati i tuoi prodotti nella navigazione del negozio.
- read_orders: per consentire all'assistente di rispondere ai tuoi clienti sullo stato e sul tracciamento dei loro ordini.
- write_markets: per aggiungere metadati ai mercati.
- write_products: per aggiungere metadati ai prodotti.
- write_metaobject_definitions: per creare definizioni di metaoggetti.
- write_metaobjects: per creare o modificare i metaoggetti necessari a Brilliant.

Perché Brilliant mi chiede di approvare nuove autorizzazioni se avevo già installato l'app?

Alcune nuove funzionalità, come la sincronizzazione di blog e pagine o la consultazione degli ordini, richiedono autorizzazioni aggiuntive.

Se hai installato Brilliant prima che queste funzionalità fossero disponibili, vedrai una notifica nel pannello con le nuove autorizzazioni richieste e il relativo scopo.

Fai clic su Continua su Shopify per accedere a Shopify, esaminare le autorizzazioni e accettarle. Finché non le approvi, le funzionalità che le richiedono non saranno disponibili.

Come faccio a sapere se l'installazione è stata completata correttamente?

Al termine della procedura in Shopify, accederai al pannello di controllo di Brilliant, dove una procedura guidata di benvenuto ti accompagnerà nei primi passaggi.

Per prima cosa, dovrai attivare Brilliant Control Center nel tema del tuo negozio.

Come attivo Brilliant nel mio tema Shopify?

Nella procedura guidata di benvenuto, fai clic su Attiva su Shopify. Accederai all'editor dei temi con Brilliant Control Center attivato.

Fai clic su Salva e torna a Brilliant per continuare l'installazione.

Questa configurazione è necessaria una sola volta e consente all'assistente di essere visualizzato nel tuo negozio. I tuoi clienti non vedranno Brilliant finché non lo attiverai dal relativo pannello.

Come faccio a sapere che il mio negozio è pronto?

Dopo aver attivato Brilliant Control Center nel tema, Brilliant inizierà a importare ed elaborare automaticamente il tuo catalogo

In Home, vedrai il messaggio "Stiamo preparando il tuo negozio" e una barra con l'avanzamento dei prodotti elaborati.

Al termine dell'elaborazione, apparirà il messaggio "Brilliant è pronto per essere attivato nel tuo negozio!" e potrai fare clic su Attiva Brilliant.

Posso provare Brilliant prima che lo vedano i miei clienti?

Sì. Da Home, fai clic su Anteprima per aprire il tuo negozio e provare l'assistente.

Durante l'anteprima, solo tu potrai vedere Brilliant. I tuoi clienti non lo vedranno finché non lo attiverai.

L'anteprima sarà disponibile quando l'elaborazione del catalogo sarà terminata e richiede che Brilliant sia attivo nel tema Shopify.

Come attivo o disattivo Brilliant nel mio negozio?

Da Home, utilizza Attiva Brilliant o Disattiva Brilliant.

Se lo disattivi, l'assistente non verrà più visualizzato nel tuo negozio, ma manterrai tutte le sue impostazioni e potrai riattivarlo quando vuoi.

Posso utilizzare Brilliant in più negozi?

Sì, puoi installare Brilliant in tutti i negozi Shopify che gestisci separatamente.

Lingue, mercati e valute

Devo creare un agente per ogni lingua e valuta?

No. Brilliant funziona in modo unificato per tutto il tuo negozio, quindi non è necessario creare agenti separati per ogni combinazione di lingua e valuta.

La configurazione del design, delle competenze, della formazione e della gestione dei prodotti viene eseguita una sola volta e si applica all'intero negozio.

In quali mercati viene visualizzato Brilliant?

Brilliant rileva automaticamente i mercati configurati in Shopify e viene visualizzato in tutti quelli attivi.

Se crei, modifichi o elimini un mercato in Shopify, Brilliant si aggiornerà automaticamente.

In quale lingua risponde Brilliant ai miei clienti?

Brilliant adatta le proprie risposte alla lingua di ogni cliente e utilizza le traduzioni dei prodotti configurate in Shopify.

Se aggiungi o elimini lingue nel tuo negozio, Brilliant le rileverà automaticamente.

Brilliant mostra i prezzi nella valuta di ciascun mercato?

Sì. Brilliant mostra i prodotti e i relativi prezzi nella valuta corrispondente al mercato da cui naviga ogni cliente.

Devo configurare Brilliant in ogni lingua?

No. Puoi completare la formazione di Brilliant nella tua lingua.

L'assistente adatterà le proprie risposte alla lingua di ogni conversazione, quindi non è necessario aggiungere gli stessi contenuti in più lingue.

Catalogo e gestione dei prodotti

Quanto tempo impiega Brilliant a elaborare il catalogo?

L'elaborazione iniziale tramite Brilliant può richiedere da alcuni minuti a diverse ore, a seconda delle dimensioni del catalogo.

Puoi controllarne l'avanzamento da Home.

Cosa fa Brilliant con il mio catalogo durante l'elaborazione?

Brilliant importa i tuoi prodotti da Shopify e li arricchisce tramite l'intelligenza artificiale.

Durante questo processo, categorizza i prodotti, genera descrizioni e punti salienti, prepara le domande frequenti, identifica i prodotti nelle immagini e calcola set e combinazioni. Genera inoltre suggerimenti di ricerca basati sul tuo catalogo.

Cosa succede se aggiungo, modifico o elimino prodotti in Shopify?

Brilliant si sincronizza automaticamente con il catalogo Shopify.

I nuovi prodotti, le modifiche e le eliminazioni verranno riportati in Brilliant senza dover importare nuovamente il catalogo.

Quali prodotti mostra Brilliant?

Brilliant mostra esclusivamente i prodotti attivi e pubblicati nel tuo e-commerce.

Puoi anche escludere determinati prodotti tramite la lista nera.

Posso modificare la tassonomia (struttura del catalogo) creata automaticamente dall'IA?

Sì. Da "Impostazioni > Struttura del catalogo" puoi modificare i nomi delle categorie e le etichette degli attributi, come il colore o la taglia.

Posso indicare le novità del mio catalogo?

Sì. Da "Impostazioni > Struttura del catalogo" puoi aggiungere i tag Shopify che identificano i tuoi nuovi prodotti.

I prodotti che contengono uno di questi tag verranno mostrati nella schermata Home di Brilliant.

Posso mettere in evidenza i prodotti del mio catalogo?

Sì. Da "Impostazioni > Struttura del catalogo" puoi aggiungere i tag dei prodotti che vuoi mettere in evidenza.

I prodotti che contengono uno di questi tag appariranno nelle prime posizioni dei risultati di ricerca.

Posso escludere prodotti dal mio catalogo?

Sì. Da "Impostazioni > Struttura del catalogo" puoi aggiungere alla lista nera i tag dei prodotti che vuoi escludere da Brilliant.

I prodotti con questi tag non appariranno nelle ricerche né nei suggerimenti e Brilliant non potrà interagire con loro nel tuo negozio.

Posso utilizzare i miei metacampi (metafield) di Shopify?

Sì. Brilliant utilizza automaticamente le informazioni di base dei tuoi prodotti, come il titolo o la descrizione.

Inoltre, da "Forma la tua IA > Metadati" puoi selezionare i metacampi aggiuntivi che Brilliant considererà per migliorare le proprie risposte e i suggerimenti.

Verranno mostrati solo i tipi di metacampi compatibili.

Forma la tua IA

Come posso insegnare a Brilliant le informazioni sul mio negozio?

Da "Forma la tua IA > Base di conoscenza" puoi aggiungere informazioni che Brilliant utilizzerà per rispondere ai tuoi clienti, come le politiche di spedizione e reso, le guide alle taglie o le domande frequenti.

Puoi aggiungere:
- Testi: informazioni scritte direttamente nel pannello.
- URL: pagine web di cui Brilliant analizzerà i contenuti. Puoi configurare una nuova scansione giornaliera o settimanale oppure disattivarla.
- File: documenti TXT, DOCX, MD o PDF fino a 5 MB.
Puoi aggiungere fino a cinque contenuti per ogni tipo. Le modifiche potrebbero richiedere alcuni minuti per essere visibili nell'assistente.

Brilliant può utilizzare i blog e le pagine del mio negozio Shopify?

Sì. Dalle schede Blog e Pagine della base di conoscenza puoi selezionare fino a 50 articoli del blog e 50 pagine del tuo negozio

Brilliant sincronizzerà automaticamente questi contenuti per utilizzarli nelle proprie risposte.

Cosa significa che un contenuto della base di conoscenza ha lo stato “Errore”?

Significa che Brilliant non ha potuto elaborarlo. Può accadere, ad esempio, se un URL non esiste più, richiede l'accesso o rimanda a un file che Brilliant non può leggere, come un'immagine o un video.

Passa il cursore sullo stato per visualizzare il motivo dell'errore. In seguito, puoi correggere la voce o utilizzare Riprova elaborazione.

Posso definire il comportamento e le risposte di Brilliant?

Sì. Da "Forma la tua IA > Comportamento" puoi configurare:
- Linee guida: aggiungi fino a 10 istruzioni per definire il tono e lo stile di Brilliant, nonché ciò che deve o non deve fare.
- Stile delle risposte: seleziona la lunghezza delle risposte “concisa”, “equilibrata” o “dettagliata” e il relativo formato “semplice”, “strutturato” o “arricchito”.

A cosa serve il profilo dell'attività?

Da "Forma la tua IA > Profilo dell'attività" puoi indicare cosa vende il tuo negozio, a quale pubblico si rivolge e qual è il tuo settore.

Queste informazioni forniscono a Brilliant un maggiore contesto sulla tua attività e sui tuoi clienti, per adattare i propri suggerimenti e le proprie risposte.

Competenze e design

Quali competenze offre Brilliant?

Da Competenze puoi consultare e gestire le capacità dell'assistente:
- Ricerca intelligente: interpreta il linguaggio naturale del cliente e mostra i prodotti più pertinenti.
- Analisi dei prodotti: risponde alle domande sulle caratteristiche, sui materiali e sugli utilizzi dei prodotti.
- Prodotti simili: mostra alternative simili per stile o caratteristiche.
- Prodotti abbinabili: consiglia prodotti complementari.
- Set di prodotti: propone combinazioni di prodotti in set.
- Confronto: confronta diversi prodotti per aiutare il cliente durante la scelta.
- Cerca per immagine: consente di caricare un'immagine e trovare prodotti simili o combinazioni.
- Prodotti nelle immagini del catalogo: consente di selezionare gli elementi visibili nelle immagini dei tuoi prodotti.
- Chiedi informazioni sul mio ordine: consente al cliente di consultare lo stato, il tracciamento e i dettagli dei propri ordini.
Le competenze Ricerca intelligente e Analisi dei prodotti sono necessarie per il funzionamento dell'assistente e non possono essere disattivate.

Posso mostrare caroselli o domande suggerite nelle pagine dei prodotti?

Sì. Dall'editor dei temi di Shopify puoi aggiungere i seguenti blocchi di Brilliant alle pagine dei prodotti:
- Carosello di prodotti simili.
- Carosello di prodotti abbinabili.
- Domande sul prodotto.
Da Competenze puoi anche fare clic su Aggiungi su Shopify o Modifica su Shopify per gestirli.

Posso modificare la posizione della bolla dell'assistente?

Sì. Dall'editor dei temi di Shopify, in Brilliant Control Center, puoi configurare la posizione della bolla principale, i margini e lo z-index.

Puoi anche utilizzare una configurazione diversa per i dispositivi mobili, attivare un messaggio di benvenuto accanto alla bolla e configurare la bolla che appare sulle schede dei prodotti.

Posso personalizzare l'aspetto di Brilliant?

Sì. Da Design puoi adattare Brilliant all'identità visiva del tuo marchio configurando:
- Colori: definisci il colore primario per generare la tavolozza.
- Pulsanti: raggio del bordo e trasformazione del testo
- Logo: carica il logo del tuo negozio (PNG, JPG, JPEG, WebP o SVG, fino a 5 MB).
- Icone: scegli o carica l'icona della bolla principale e della bolla del prodotto (SVG o PNG, fino a 500 KB).
- Scheda del prodotto: proporzione dell'immagine, modalità di visualizzazione, raggio del bordo e contorno.
Puoi consultare nell'anteprima come verranno visualizzate le modifiche nelle diverse schermate dell'assistente. Quando attiverai Brilliant, il carattere si adatterà automaticamente a quello del tuo negozio.

Analisi e conversazioni

Come posso misurare l'impatto di Brilliant sulle mie vendite?

Da Analisi puoi consultare metriche sulle prestazioni di Brilliant, come gli acquisti assistiti rispetto al totale del negozio, il tasso di conversione, il valore medio dell'ordine, il ROI, il funnel degli acquisti o le conversazioni per dispositivo.

Puoi anche consultare quali elementi di Brilliant, come bolle, caroselli o domande suggerite, generano maggiore interazione.

Posso collegare Brilliant a Google Analytics?

Sì. Da “Impostazioni > Google Analytics” puoi abilitare l'integrazione e inserire il tuo ID di Google Analytics per misurare le prestazioni di Brilliant nel tuo negozio.

In quale lingua risponde Brilliant ai miei clienti?

Sì. Da Home, nella scheda “Conversazioni chat”, puoi consultare il numero totale di conversazioni, quelle dell'ultima settimana e quelle dell'ultimo giorno.

Fai clic su Scarica chat per scaricare le conversazioni.

Brilliant mostra i prezzi nella valuta di ciascun mercato?

Sì. Brilliant mostra i prodotti e i relativi prezzi nella valuta corrispondente al mercato da cui naviga ogni cliente.

Piano e limiti

Cosa include il mio piano?

Puoi consultare l'utilizzo del tuo piano da Home, nella scheda “Utilizzo del piano”.

Ogni piano include un numero massimo di prodotti nel catalogo e di conversazioni al mese.

Cosa succede se raggiungo il limite di conversazioni?

Brilliant non verrà più visualizzato nel tuo negozio finché il limite non sarà ripristinato.

Il contatore delle conversazioni si reimposta automaticamente all'inizio di ogni mese. Nella scheda “Utilizzo del piano” di Home puoi consultare i giorni rimanenti prima del ripristino successivo.

Cosa succede se il mio catalogo supera il limite di prodotti del mio piano?

Brilliant mostrerà una notifica nel pannello indicando che il tuo negozio ha bisogno di un piano più avanzato.

Dalla stessa notifica potrai richiedere l'accesso prioritario ai piani disponibili per cataloghi più grandi.

Assistenza e risorse aggiuntive

Brilliant non viene visualizzato nel mio negozio: cosa posso controllare?

Verifica che:
1. Brilliant Control Center sia attivato e che le modifiche siano state salvate nel tema pubblicato di Shopify.
2. Brilliant sia attivato da Home.
3. L'elaborazione del catalogo sia terminata.
4. Non abbia raggiunto il limite di conversazioni del tuo piano.
5. Il cliente stia navigando da un mercato attivo del tuo negozio.
Se hai verificato questi punti e Brilliant continua a non essere visualizzato, contatta l'assistenza.

Dove posso contattare l'assistenza?

Puoi scriverci direttamente a support@getbrilliant.ai per qualsiasi domanda tecnica o sulla configurazione.

Vuoi saperne di più?