Configura il chatbot

Integrazione sito web

Aggiungi il chatbot al tuo sito con un solo tag script e stabilisci dove può funzionare.

Aggiungi lo script

Configurazione › Integrazione sito web

Copia il codice di integrazione dalla dashboard e incollalo subito prima del tag di chiusura </body>. Aggiungilo in ogni pagina in cui deve comparire il chatbot, oppure una sola volta in un modello comune a tutte le pagine. L'attributo defer garantisce che la pagina non rallenti.

HTML

<script defer src="https://cdn.swai.chat/chatbot-public/frontend/loader.js?chatbotId=YOUR_CHATBOT_ID"></script>

L'integrazione in un sito online richiede un piano a pagamento. Durante la prova, testa con l'anteprima nella dashboard.

Dove incollare il codice

WordPress: Con un plugin per gli script di header e footer, oppure tramite l'impostazione di codice personalizzato del tema.
Webflow: Site settings › Custom code › Footer code, poi pubblica.
Shopify: Negozio online › Temi › Modifica codice › theme.liquid, prima di </body>.
Wix: Impostazioni › Codice personalizzato › Aggiungi codice, posizionato in «Body – fine» su tutte le pagine.
HTML: Incollalo nel modello di pagina prima di </body>.

Usa sempre un blocco di codice personalizzato, embed o HTML. I blocchi di testo dei website builder rimuovono gli script.

Modalità di visualizzazione

Con il parametro mode scegli come compare il chatbot. Puoi provare ogni modalità con i pulsanti di anteprima nella dashboard.

bubble (predefinita): Un pulsante chat nell'angolo in basso che apre la finestra della chat. La scelta giusta per la maggior parte dei siti.
floating: Un campo di input in fondo alla pagina che invita i visitatori a fare subito una domanda.
embedded: La chat riempie il suo contenitore, per una pagina dedicata di aiuto o chat. Assicurati che il contenitore abbia un'altezza.

Parametri

Aggiungi i parametri all'URL dello script, separati da &:

HTML

<script defer src="https://cdn.swai.chat/chatbot-public/frontend/loader.js?chatbotId=YOUR_CHATBOT_ID&mode=floating"></script>

chatbotId: Obbligatorio. L'ID del tuo chatbot, già inserito nel codice copiato.
mode: bubble, floating o embedded. Predefinito: bubble.
openOnLoad: true apre la chat al caricamento della pagina. Si applica alle modalità bubble e floating e non ha effetto in modalità embedded. Quando un visitatore chiude la chat, questa resta chiusa in quella scheda del browser e si riapre automaticamente in una nuova scheda o in una nuova sessione del browser. Predefinito: disattivato.

Restrizione di dominio

In Restrizioni di dominio inserisci l'indirizzo del sito su cui gira il chatbot, ad esempio https://www.example.com. Il chatbot funziona solo lì, così altri siti non possono integrarlo con il tuo codice e consumare la tua quota di messaggi.

La restrizione di dominio protegge dall'integrazione su altri siti, ma non è un controllo degli accessi. Verifica l'indirizzo del sito che il browser invia con ogni richiesta, e uno script eseguito fuori da un browser può falsificarlo. Per questo non considerare riservati il chatbot e la sua base di conoscenza.

Il dominio deve corrispondere: www.example.com ed example.com valgono come lo stesso dominio, mentre ogni altro sottodominio, come shop.example.com, è un dominio diverso.