Come installare un Chatbot Quantiq sul proprio sito

Dopo aver creato e configurato un Chatbot per siti in Quantiq, il passaggio successivo è pubblicarlo sul dominio in cui deve essere utilizzato. Il widget esterno è pensato per essere incorporato nel sito e caricato in modo isolato, mantenendo separata la configurazione del chatbot dal codice del sito.

Prima di iniziare, assicurati che il chatbot sia già configurato e testato. Se devi ancora impostare comportamento, messaggi e fonti, consulta Come creare e configurare un Chatbot per siti.

1. Verifica il chatbot prima della pubblicazione

Apri il chatbot in Quantiq e controlla almeno questi elementi:

• titolo e identità del chatbot;
• messaggio iniziale e testo della bubble;
• istruzioni e limiti di risposta;
• lingua e modello AI;
• fonti di conoscenza già elaborate;
• stato attivo del chatbot.

È meglio risolvere eventuali problemi nella configurazione prima di passare all’embed, così puoi distinguere facilmente un errore del chatbot da un problema di installazione sul sito.

2. Aggiungi il dominio autorizzato

Configura il dominio sul quale il chatbot deve essere pubblicato. Quantiq associa il chatbot al dominio autorizzato e alle credenziali necessarie al widget esterno.

Inserisci il dominio reale del sito e controlla con attenzione eventuali differenze tra dominio principale, sottodomini e ambienti di staging. Se il chatbot deve funzionare su più proprietà, verifica che il tuo piano e la configurazione disponibile supportino i domini necessari.

3. Copia il codice di incorporamento

Nell’area di configurazione esterna copia lo script generato per il chatbot. Il codice contiene le informazioni necessarie a caricare il widget e recuperare la configurazione corretta.

In un sito tradizionale puoi inserirlo nell’area dedicata agli script globali, normalmente prima della chiusura di . In WordPress, Shopify o altri CMS puoi invece usare l’area per il codice personalizzato prevista dal tema, dal CMS o dal relativo sistema di integrazione.

Evita di modificare manualmente chiavi o identificatori presenti nello script, a meno che una guida Quantiq non lo richieda esplicitamente.

4. Controlla il widget sul sito

Dopo aver salvato il codice, apri il sito in una nuova sessione e verifica che il widget venga caricato. Il chatbot esterno può gestire elementi come trigger, avatar, posizione e apertura o chiusura della finestra.

Prova almeno una conversazione completa e controlla:

• apertura e chiusura del widget;
• visualizzazione su desktop e mobile;
• messaggio iniziale;
• risposte basate sulle fonti;
• link eventualmente restituiti;
• comportamento fuori ambito.

5. Verifica che le conversazioni arrivino nella Chatbot Inbox

Dopo una conversazione di prova, apri la Chatbot Inbox di Quantiq e controlla che l’attività venga registrata. L’Inbox serve a seguire le conversazioni recenti, individuare messaggi da leggere e capire quali chatbot richiedono attenzione.

Per la gestione operativa consulta Come gestire conversazioni e messaggi nella Chatbot Inbox.

6. Cosa controllare prima del go-live

• Il dominio autorizzato corrisponde al sito reale.
• Il chatbot risponde correttamente alle domande principali.
• Le fonti non contengono informazioni obsolete o riservate.
• Il widget è leggibile su mobile.
• Le conversazioni vengono registrate correttamente.
• Le istruzioni prevedono cosa fare quando la richiesta richiede un intervento umano.

Se il widget non compare

Controlla prima che lo script sia effettivamente presente nella pagina pubblica, poi verifica dominio autorizzato e stato del chatbot. Se il codice viene caricato ma il widget non si apre, evita di duplicare lo script in più punti del sito e controlla eventuali sistemi di cache o ottimizzazione JavaScript.

Una volta completata l’installazione, il chatbot può essere gestito da Quantiq senza dover modificare ogni volta il codice incorporato sul sito.