Centro assistenza
Aggiunta del chatbot al sito web

Aggiungere il chatbot al tuo sito web

Ultimo aggiornamento:

Aggiungere ChatLab al tuo sito web permette ai visitatori di interagire con il tuo chatbot AI direttamente sulle tue pagine. Questa guida spiega come ottenere il codice di incorporamento e aggiungerlo al tuo sito web.

Prima di iniziare

Crea e allena il tuo chatbot prima di condividerlo con i clienti. Per l'installazione, hai anche bisogno dei permessi per modificare e pubblicare il sito web. Consulta Come creare il tuo primo chatbot.

Apertura della scheda Test & Deploy

Seleziona il tuo chatbot dalla dashboard principale, quindi fai clic sulla scheda Test & Deploy (Testa e pubblica). Puoi anche fare clic sul pulsante verde Test chatbot (Testa il chatbot) nella sezione Overview (Panoramica) del chatbot. La scheda include due parti:

  • Test (a sinistra) - il tuo chatbot attivo in un ambiente di prova che simula il tuo sito web, così puoi provarlo prima che lo vedano i visitatori. Nella modalità Widget, la finestra di chat si posiziona nell'angolo in basso a destra nelle sue dimensioni reali, con l'icona della chat sotto di essa, esattamente come la vedranno i visitatori. Il selettore Widget / Frame nell'angolo in alto a destra dell'ambiente di prova passa a Frame, la chat sempre aperta fornita dal codice iframe.
  • Deploy (a destra) - dove scegli la piattaforma del sito web o il canale di messaggistica e ne segui le istruzioni. Sotto di essa, l'opzione Share a test link (Condividi un link di prova) ti fornisce i link da inviare ad altri (vedi Inviare un link al tuo chatbot).

Scheda Test & Deploy evidenziata

Il tuo sito web dietro il chatbot

Quando il tuo chatbot è addestrato su un singolo sito web, l'ambiente di prova mostra uno screenshot di quel sito web dietro la finestra di chat, permettendoti di vedere come appare il chatbot sulle tue pagine. Lo screenshot viene acquisito una sola volta quando apri la scheda per la prima volta (finché non è pronto, l'ambiente di prova mostra il contorno di una pagina e il chatbot funziona già) e viene conservato; ne viene acquisito uno nuovo solo quando modifichi l'indirizzo. I chatbot addestrati su più siti web, oppure solo su file e testo, mostrano invece il contorno neutro di una pagina.

Fai clic sull'indirizzo del sito web nella parte superiore dell'ambiente di prova per gestire lo sfondo:

  • Website address (Indirizzo del sito web) con Save (Salva) - mostra una pagina diversa, ad esempio la pagina di un prodotto. Try again (Riprova) ripete uno screenshot non riuscito.
  • Hide background (Nascondi sfondo) / Show background (Mostra sfondo) - disattiva e riattiva lo screenshot senza eliminarlo.
  • Remove background (Rimuovi sfondo) - elimina lo screenshot. L'ambiente di prova mostra il contorno neutro finché non inserisci nuovamente un indirizzo.

Lo sfondo è solo un'anteprima nel pannello di amministrazione. Non modifica nulla sul tuo sito web.

Scegliere la tua piattaforma

Sotto Where do you want to add the chatbot? (Dove vuoi aggiungere il chatbot?), la sezione Deploy (Pubblica) elenca le destinazioni supportate divise in tre gruppi: Website, per inserire il chatbot sulle pagine che gestisci, Online store platforms (fai clic sull'intestazione per espanderla) e Messaging channels, per collegarlo a un account di messaggistica esistente. Fai clic sulla voce corrispondente a dove desideri che compaia il chatbot per visualizzare le istruzioni dettagliate.

Elenco delle piattaforme evidenziato nella sezione Deploy

Piattaforme supportate:

  • HTML Code - funziona con qualsiasi sito web in cui puoi modificare l'HTML
  • WordPress - tramite il plugin ufficiale ChatLab o l'inserimento manuale del codice
  • Wix - tramite Settings > Custom Code (Impostazioni > Codice personalizzato)
  • Webflow - tramite Site settings > Custom code (Impostazioni sito > Codice personalizzato), con l'accesso al codice personalizzato abilitato per il tuo sito o workspace
  • PrestaShop - tramite il modulo PrestaShop di ChatLab o l'inserimento manuale del codice
  • Shopify - tramite l'app ChatLab dallo Shopify App Store (come app embed nel tuo tema), oppure tramite codice manuale nel file theme.liquid
  • WooCommerce - tramite il plugin WordPress o l'inserimento manuale del codice
  • Shoper - tramite l'app ChatLab dal Shoper App Store o l'inserimento manuale del codice
  • Abicart - tramite Store design > Themes > Site header
  • Ecwid - tramite Website > Overview > Custom JavaScript code
  • CS-Cart - tramite l'add-on ChatLab o il codice manuale in Design > Layouts > Custom HTML code
  • BigCommerce - aggiunto automaticamente al collegamento dello store oppure tramite Storefront > Script Manager

Canali di messaggistica:

I canali di messaggistica non utilizzano il codice di embed riportato sotto. Si collegano a un account già esistente, quindi non occorre incollare alcun codice in un sito web.

Ogni piattaforma mostra istruzioni dettagliate passo dopo passo per la specifica integrazione. Per le piattaforme dotate di articoli di guida dedicati, in basso compare il link View full instructions (Visualizza le istruzioni complete).

Aggiunta tramite HTML Code

L'opzione HTML Code funziona con qualsiasi sito web di cui puoi modificare il codice sorgente. Vedrai due opzioni di incorporamento: Widget e Iframe.

Modalità Widget

La scheda Widget mostra il codice che aggiunge un'icona di chat al tuo sito web. Quando i visitatori fanno clic sull'icona, si apre un popup di chat.

Scheda Widget evidenziata

  1. Fai clic sulla scheda Widget
  2. Fai clic su Copy to clipboard (Copia negli appunti) per copiare il codice
  3. Individua la sezione <head> del tuo sito web
  4. Incolla il codice come ultimo elemento all'interno della sezione <head>
  5. Aggiorna il browser per verificare che l'icona del chatbot appaia

Modalità Iframe

La scheda Iframe mostra il codice che incorpora il chatbot direttamente nel contenuto della tua pagina. Il chatbot è sempre visibile e può essere circondato da altri elementi della pagina.

Scheda Iframe evidenziata

  1. Fai clic sulla scheda Iframe
  2. Fai clic su Copy to clipboard (Copia negli appunti) per copiare il codice
  3. Incolla il codice in qualsiasi punto dell'HTML del tuo sito web in cui desideri che appaia il chatbot
  4. Regola gli attributi width e height per adattarli al tuo layout

Non sai quale scegliere? Leggi Qual è la differenza tra widget e Iframe? per un confronto dettagliato.

Aggiunta tramite plugin o app: WordPress, WooCommerce, PrestaShop, Shopify, Shoper e CS-Cart

Per queste sei piattaforme ChatLab offre un proprio plugin, modulo, app o componente aggiuntivo. Una volta collegato al tuo chatbot, aggiunge automaticamente il chatbot al tuo sito, senza dover copiare alcun codice. Per i negozi online collega inoltre lo store, permettendo al chatbot di cercare i tuoi prodotti e verificare lo stato degli ordini. Incollare manualmente il codice rimane possibile come alternativa, ma mostra solo il widget di chat.

Quando selezioni una di queste piattaforme, compaiono due schede: Plugin Installation (Installazione tramite plugin - consigliata) e Manual Installation (Installazione manuale).

Piattaforma WordPress con il pulsante Get the plugin on WordPress.org evidenziato

Shopify selezionato sotto Piattaforme per negozi online, con la scheda Plugin Installation

Plugin Installation (consigliata)

  1. Fai clic sul pulsante in alto nella scheda Plugin Installation: Get the plugin on WordPress.org per WordPress e WooCommerce, Download the ChatLab module (.zip) per PrestaShop, Get the app in the Shopify App Store per Shopify, Get the app in the Shoper App Store per Shoper, oppure Download the ChatLab add-on (.tgz) per CS-Cart. Il pulsante per PrestaShop non apre la pagina di un marketplace - scarica il modulo sul tuo computer come singolo file ZIP (chatlab.zip), che caricherai sul tuo negozio nel passaggio successivo.
  2. Installa il plugin, modulo, app o componente aggiuntivo di ChatLab nel pannello di amministrazione del tuo sito web. Per PrestaShop, apri Modules > Module Manager > Upload a module nel back office di PrestaShop e seleziona il file ZIP scaricato. La guida completa per PrestaShop è disponibile in Come aggiungere un chatbot a PrestaShop. Per CS-Cart, apri Add-ons > Downloaded add-ons, scegli Manual installation dal menu a forma di ingranaggio e carica il file scaricato.
  3. Apri ChatLab lì, accedi con il tuo account ChatLab e seleziona questo chatbot quando richiesto. Per PrestaShop, fai clic su Configure sul modulo installato, quindi su Connect my store. Per CS-Cart, apri Marketing > ChatLab AI Chatbot e fai clic su Continue. Per un negozio WooCommerce, mantieni spuntata la voce WooCommerce integration per collegare anche i dati dello store.
  4. Il collegamento si completa automaticamente e il chatbot appare sul tuo sito web. Su Shopify, apri anche Online Store > Themes > Customize > App embeds, attiva ChatLab AI Chat e salva. Apri il tuo sito e invia un messaggio di prova.

Ogni piattaforma ha una guida dedicata con tutti i passaggi e gli screenshot:

Shoper

Seleziona Shoper nell'elenco delle piattaforme della sezione Deploy (Pubblica). Nella scheda Plugin Installation, fai clic su Get the app in the Shoper App Store per aprire l'app gratuita di ChatLab nello Shoper App Store.

Piattaforma Shoper con il pulsante Get the app in the Shoper App Store evidenziato

  1. Installa l'app gratuita ChatLab dallo Shoper App Store. Puoi trovarla anche dal pannello di amministrazione di Shoper sotto Add-ons and integrations > Applications.
  2. Apri l'app ChatLab nel pannello di amministrazione di Shoper. Il pannello ChatLab si aprirà in una nuova finestra.
  3. Imposta la tua password o accedi con il tuo account ChatLab, e collega il negozio a questo chatbot quando richiesto.
  4. Il tuo negozio si collega automaticamente e il chatbot appare sulla vetrina del sito.

Per aggiungere solo il widget di chat senza l'app, passa a Manual Installation, copia il codice, quindi nell'amministrazione di Shoper vai su Add-ons and integrations > Custom integrations, incolla il codice nel campo Page header e salva. Aggiorna la pagina del tuo negozio per verificare che il chatbot compaia. Per la guida dettagliata, consulta Integrazione con Shoper.

Manual Installation

Passa a Manual Installation, copia il codice e incollalo nell'intestazione del tuo sito seguendo i passaggi indicati per la tua piattaforma. Per WordPress e WooCommerce questa operazione viene eseguita con un plugin per l'inserimento di codice, come Insert Headers and Footers. Pubblica le modifiche e testa la chat. Installa il chatbot una sola volta, utilizzando il plugin/app oppure il codice manuale, non entrambi.

Aggiunta tramite altre piattaforme

Per Wix, Webflow e Abicart non c'è alcun plugin da installare: incolli tu stesso il codice nel tuo sito. Per Ecwid, l'app ChatLab di Ecwid App Market collega il negozio al tuo chatbot; se il widget di chat non compare nella tua vetrina, incolla il codice in Custom JavaScript code (Codice JavaScript personalizzato) o nel sito web in cui è incorporato il tuo negozio. Per BigCommerce, ChatLab aggiunge il widget al posto tuo quando il negozio è collegato con accesso ai contenuti; in caso contrario, incolli il codice nello Script Manager. Seleziona la piattaforma nella sezione Deploy (Pubblica) per vedere:

  1. Il codice di incorporamento con le opzioni Widget e Iframe
  2. Istruzioni dettagliate per incollare il codice, specifiche per ogni piattaforma
  3. Un link View full instructions (Visualizza le istruzioni complete) che rimanda alla guida completa della piattaforma

Guide complete per queste piattaforme:

Conformità al GDPR

Se hai bisogno che il tuo chatbot venga caricato solo dopo aver ottenuto il consenso ai cookie, consulta Configurazione di ChatLab per la conformità al GDPR per le guide di integrazione con CookieBot, Usercentrics e Google Tag Manager.

Content Security Policy (CSP)

Se il tuo sito web utilizza le intestazioni Content Security Policy, devi autorizzare i domini di ChatLab per consentire il funzionamento del chatbot. Le direttive necessarie dipendono dall'uso della modalità Widget o Iframe.

Modalità Widget

Il widget carica uno script sulla tua pagina che genera l'interfaccia di chat. Unisci le seguenti origini ChatLab alle direttive CSP esistenti; non sostituire la policy per il resto del tuo sito web:

script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com 'unsafe-inline';
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;

Per impostazione predefinita, il widget inietta alcuni stili inline. La tua policy deve inoltre autorizzare lo script di configurazione inline, ad esempio con un nonce o un hash CSP. Autorizza le origini delle immagini utilizzate dal tuo bot e dalle schede prodotto in img-src; l'audio e altre funzioni abilitate potrebbero richiedere ulteriori origini. Per un dominio agency, utilizza i domini presenti nello snippet generato.

CSP Safe Mode - evitare unsafe-inline

Se la policy di sicurezza del tuo sito web non consente 'unsafe-inline' in style-src, puoi abilitare CSP Safe Mode (Modalità sicura CSP). In questo modo il foglio di stile del contenitore del widget viene caricato da un file CSS esterno. Ciò non autorizza lo script di configurazione inline né garantisce che ogni stile personalizzato e funzione abilitata rispetti la tua policy.

Per abilitarla, aggiungi window.aichatbotCspSafe = true; prima del tag di script di ChatLab:

<script>
  window.aichatbotApiKey = "YOUR_API_KEY";
  window.aichatbotCspSafe = true;
</script>
<script src="https://script.chatlab.com/aichatbot.js" defer></script>

Con la modalità CSP Safe Mode abilitata, testa una policy sui fogli di stile senza 'unsafe-inline'. Un punto di partenza è:

script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com;
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;

Modalità Iframe

La pagina principale deve autorizzare l'origine presente nell'URL dell'iframe copiato. Per l'hosting ChatLab standard, aggiungi questa riga alla policy esistente:

frame-src https://api.chatlab.com;

Articoli correlati