Come installare Brilliant

Creato 5 dicembre 2025 09:08

Aggiornato 11 giugno 2026 11:44

In questo articolo imparerai come installare Brilliant nel tuo negozio, attivare la connessione iniziale e verificare che tutti gli elementi funzionino correttamente prima di iniziare a vendere con l'IA.

1. Requisiti preliminari

Prima di iniziare, assicurati di soddisfare i seguenti requisiti per evitare errori durante il processo:

Avere un negozio attivo sulla piattaforma Shopify.
Disporre dei permessi di amministratore o permessi sufficienti per installare applicazioni nel tuo pannello di controllo.

2. Installazione dal Marketplace

Per aggiungere Brilliant al tuo ecommerce, segui questi passaggi:

Localizzazione dell'app:

Accedi al tuo pannello Shopify, vai alla sezione App e seleziona Shopify App Store.

Ricerca:

Digita "Brilliant AI assistant" nella barra di ricerca dello store delle applicazioni.

Installazione:

Clicca sul pulsante Installa. Shopify ti reindirizzerà a una schermata dove sono dettagliati i permessi necessari. Premi di nuovo su Installa per accettare e completare la connessione.

3. Configurazione iniziale dopo l'installazione

Una volta confermata l'installazione, accedi a Brilliant dalla tua lista di applicazioni in Shopify per entrare nel backoffice.

Primi passi consigliati

Creazione dell'agente:

Avvia la creazione dell'agente affinché l'IA possa analizzare il tuo catalogo. Questo processo è automatico ma può richiedere diverse ore a seconda del volume di prodotti. Puoi continuare a usare normalmente il tuo negozio nel frattempo.

Attivazione dell'agente:

Una volta processato il catalogo, assicurati di impostare l'agente come Attivo nel pannello di controllo.

Abilitare il widget nel tema:

Per rendere visibile l'assistente, vai su Negozio online / Temi / Personalizza. Nella sezione Incorporamenti app, attiva l'interruttore di Brilliant e salva le modifiche.

Aggiungere domande suggerite nella pagina prodotto:

Vai su Negozio online / Temi / Modifica. Seleziona la pagina prodotto e aggiungi un nuovo blocco:

Seleziona il blocco "Domande del prodotto", nella scheda "App":

Vedrai l'anteprima delle domande e potrai salvare le modifiche:

Aggiungere caroselli di prodotti simili o abbinati nella pagina prodotto:

Vai su Negozio online / Temi / Modifica. Seleziona la pagina prodotto e aggiungi un nuovo blocco:

Seleziona il blocco "Carosello di prodotti", nella scheda "App":

Ora puoi cliccare su quel blocco e scegliere il titolo e il tipo di elenco prodotti che vuoi mostrare:

Prodotti simili: mostrerà prodotti simili a quello che l'utente sta visitando.

Prodotti che si abbinano bene: mostrerà prodotti che si abbinano bene con il prodotto in visita.

Mostrare il pulsante di azioni contestuali di Brilliant sulle schede prodotto:

Una volta che hai attivato il widget di Brilliant nel tema, oltre a comparire il pulsante principale di Brilliant nell'angolo inferiore dello schermo, dovrebbero iniziare a comparire anche i pulsanti di azioni contestuali sulle schede prodotto del tuo sito web.

Se ciò non avviene, è perché si verifica uno dei seguenti casi:
1. Utilizzi un tema pubblico di Shopify senza modifiche al codice. Se non vedi i pulsanti di azioni contestuali sulle schede prodotto del tuo sito e stai usando un tema pubblico di Shopify, è perché Brilliant non ha ancora fornito supporto per quel tema. In tal caso, ti preghiamo di contattarci all'indirizzo support@getbrilliant.ai indicandoci il dominio del tuo ecommerce e il nome del tema pubblico che stai utilizzando. I nostri sviluppatori aggiorneranno il supporto di Brilliant per il tuo tema con la massima priorità.
2. Utilizzi un tema pubblico di Shopify con modifiche al codice, oppure un tema privato personalizzato. In questo caso, dovrai aggiungere un piccolo codice html nel tuo tema affinché Brilliant possa mostrare i pulsanti di azioni contestuali sulle schede prodotto. Il codice da aggiungere in ogni card prodotto è data-bri-product-id="id del prodotto". Nel codice Liquid di Shopify, normalmente dovrai scrivere qualcosa del tipo: data-bri-product-id="{{ product.id }}". Devi inserirlo in tutte le schede prodotto dove vuoi mostrare il pulsante contestuale di Brilliant. Di solito si ha il file product-card.liquid o simile, e questo componente viene riutilizzato in diversi tipi di pagina come la home, prodotti di una collezione, risultati di ricerca, ecc., quindi dovrai aggiungere quel codice solo in quel file, e si applicherà a tutto il tema. Il codice precedente è un attributo html che devi inserire nell'elemento DOM padre che racchiude ogni scheda prodotto. Salvo casi molto eccezionali, di solito puoi inserire questo codice in un elemento HTML già esistente nel tuo tema; cioè, non dovrebbe essere necessario creare un nuovo elemento con questo attributo che racchiuda tutta la scheda prodotto.
  
  L'obiettivo è generare un codice simile al seguente:
```
<body>
...
    <div class="my-theme-product-card" data-bri-product-id="86461581684">
    ... html interno di questa scheda prodotto
    </div>
...
    <div class="my-theme-product-card" data-bri-product-id="95168765168">
    ... html interno di questa scheda prodotto
    </div>
...
    <div class="my-theme-product-card" data-bri-product-id="21564846848">
    ... html interno di questa scheda prodotto
    </div>
</body>
```

Personalizzazione degli stili:

Nella pagina di gestione di Brilliant, vai su Impostazioni / Stili generali e regola colori e tipografia affinché l'assistente assomigli il più possibile al tuo negozio:

4. Verifiche di funzionamento

Per verificare che l'installazione sia avvenuta con successo, naviga nel tuo negozio e controlla i seguenti elementi:

Pulsante flottante: Deve comparire il pulsante di attivazione di Brilliant nell'angolo del tuo sito web.

Schede prodotto: Devi vedere i chip o etichette intelligenti integrati nelle schede prodotto.

Interazione: Fai una domanda all'assistente e verifica che le risposte vengano generate correttamente basandosi sul tuo catalogo.

Vuoi saperne di più?