Come aggiungere il chatbot IA Asyntai a Kentico

Guida passo passo per i siti web Kentico CMS

Piattaforma:

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Nota: Il codice sopra è solo un esempio. Devi copiare il tuo codice di incorporamento univoco dalla tua Dashboard poiché contiene il tuo ID widget personale.

Passaggio 2: Aggiungi il codice al Master Page Template (consigliato)

Per aggiungere il chatbot a tutte le pagine del tuo sito web Kentico contemporaneamente, utilizza il metodo Master Page Template:

Accedi al tuo pannello di amministrazione Kentico e naviga all'applicazione Page templates
Individua e apri il tuo Master page template (il template utilizzato in tutte le pagine)
Clicca sulla scheda Header nell'editor del template
Nella sezione header, incolla il tuo codice di integrazione Asyntai
In alternativa, aggiungi il codice al layout del template prima del tag di chiusura </head>
Clicca su Save per applicare le modifiche
Svuota la cache del tuo sito e verifica le modifiche sul sito live

Suggerimento: L'utilizzo del Master Page Template garantisce che il chatbot appaia su ogni pagina che eredita da questo template. Questo è il metodo più efficiente per una distribuzione su tutto il sito in Kentico.

Metodo alternativo 1: Header del Page Template

Se desideri aggiungere il chatbot solo a template di pagina specifici:

Vai all'applicazione Page templates in Kentico Admin
Seleziona il template di pagina specifico che desideri modificare
Clicca sulla scheda Header
Aggiungi il tuo codice di integrazione Asyntai utilizzando un tag script:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Clicca su Save
Tutte le pagine che utilizzano questo template ora includeranno il chatbot

Nota: Questo metodo è utile quando desideri aggiungere il chatbot a sezioni specifiche del tuo sito che condividono lo stesso template di pagina, piuttosto che all'intero sito.

Metodo alternativo 2: Web Part HEAD HTML

Per un controllo più granulare su pagine specifiche o per JavaScript ereditabile nelle sottopagine:

Apri la pagina che desideri modificare nell'editor di pagina Kentico
Aggiungi una nuova web part alla pagina (preferibilmente in una pagina padre per l'ereditarietà)
Cerca e seleziona la web part HEAD HTML
Nella configurazione della web part, incolla il tuo codice di integrazione Asyntai
Configura la web part come ereditabile se desideri che le pagine figlie abbiano il chatbot
Clicca su OK per salvare la web part
Salva e pubblica la pagina

Suggerimento: La web part HEAD HTML è perfetta per aggiungere codice a una pagina padre che si propagherà automaticamente a tutte le pagine figlie, creando un'installazione a livello di sezione.

Metodo alternativo 3: File JavaScript personalizzati (avanzato)

Per gli sviluppatori che preferiscono gestire gli script come file:

Nel tuo progetto Kentico, naviga nella directory ~/CMSScripts/Custom/
Crea un nuovo file JavaScript (es. asyntai-widget.js)
Aggiungi il codice per caricare dinamicamente il tuo widget Asyntai:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

Fai riferimento a questo file nell'intestazione del tuo Master Page Template:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

Importante: Questo metodo avanzato richiede l'accesso al file system e la conoscenza della struttura delle directory di Kentico. Assicurati di avere i permessi appropriati e di testare sempre prima in un ambiente di staging.

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche e svuotato la cache, apri il tuo sito web in una nuova scheda del browser o in una finestra di navigazione in incognito. Dovresti vedere il pulsante del widget chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di aver salvato tutte le modifiche e svuotato la cache di Kentico (Settings > System > Clear cache). Prova a visualizzare il tuo sito in una finestra di navigazione in incognito. Controlla la console del browser (F12) per eventuali errori JavaScript che potrebbero impedire il caricamento del widget.