Come aggiungere il chatbot IA Asyntai a October CMS

Guida passo passo per i siti web October 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 al Template Layout (consigliato)

Il modo consigliato per aggiungere il chatbot è modificare il layout predefinito nel backend di October CMS:

Accedi al backend di October CMS
Vai su CMS > Layouts nel menu principale
Apri il layout predefinito (solitamente default.htm)
Trova il tag di chiusura </body> e il {% scripts %} segnaposto
Aggiungi il tuo codice di incorporamento Asyntai proprio prima {% scripts %} e </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Clicca su "Save" per applicare le modifiche

Suggerimento: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Puoi utilizzare il segnaposto scripts di October CMS per iniettare il chatbot da una pagina o un partial:

Apri qualsiasi pagina o partial nell'editor CMS
Aggiungi il seguente codice utilizzando il {% put scripts %} blocco:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Sostituisci YOUR_WIDGET_ID con l'ID widget effettivo dalla dashboard
Clicca su "Save"

Nota: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Metodo alternativo 2: Utilizzo di Component PHP

Se preferisci un approccio programmatico, puoi aggiungere lo script del chatbot tramite un componente personalizzato:

Crea o modifica un componente nel tuo plugin October CMS
Nel metodo onRun() del componente, utilizza il metodo addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Sostituisci YOUR_WIDGET_ID con il tuo ID widget effettivo
Registra il componente nelle pagine dove desideri che il chatbot appaia

Suggerimento: L'utilizzo di un componente ti offre il controllo programmatico su quando e dove il chatbot viene caricato. Puoi aggiungere logica condizionale all'interno di onRun() per controllare il caricamento in base ai ruoli utente, ai tipi di pagina o ad altri criteri.

Metodo alternativo 3: Utilizzo di un Partial

Puoi creare un partial riutilizzabile per il widget del chatbot:

Vai su CMS > Partials nel backend di October CMS
Clicca su "+ Add" per creare un nuovo partial
Assegnagli il nome asyntai-widget.htm
Aggiungi il tuo codice di integrazione Asyntai al partial:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Clicca su "Save"
Apri il tuo template layout e includi il partial prima di </body>:
{% partial 'asyntai-widget' %}
Salva il layout

Suggerimento: Usare un partial rende facile abilitare o disabilitare il chatbot su tutto il sito semplicemente aggiungendo o rimuovendo l'inclusione del partial dal layout.

Passaggio 3: verifica l'installazione

Dopo aver salvato le modifiche, visita il tuo sito October CMS 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 nel backend del CMS. Svuota la cache del browser o visualizza in una finestra di navigazione in incognito. Se il tuo sito utilizza la cache, svuota la cache di October CMS eseguendo php artisan cache:clear dalla riga di comando, oppure usa l'opzione Settings > System > Clear Cache nel backend.

Selezione del layout: Assicurati che le pagine in cui vuoi che appaia il chatbot utilizzino il layout corretto. Puoi verificare quale layout utilizza una pagina aprendola in CMS > Pages e controllando il menu a tendina Layout nelle impostazioni della pagina.