Come aggiungere il chatbot IA Asyntai a MODX

Guida passo passo per i siti web MODX 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 MODX (consigliato)

Il modo consigliato per aggiungere il chatbot è modificare il tuo Template MODX direttamente nel MODX Manager:

Accedi al tuo MODX Manager (pannello di controllo)
Nella barra laterale sinistra, vai su Elements > Templates
Apri il template del tuo sito (solitamente chiamato "BaseTemplate" o il tuo template attivo)
Trova il tag di chiusura </body> nel codice del template
Incolla il tuo codice di integrazione Asyntai appena prima del tag di chiusura </body>
Clicca su "Save" per salvare il template

<!-- Your existing template content -->

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

Suggerimento: L'aggiunta del codice appena prima del tag di chiusura </body> garantisce che il chatbot si carichi dopo tutto il contenuto della pagina, che è il posizionamento consigliato per i widget chat e non rallenterà il caricamento della pagina.

Metodo alternativo 1: Utilizzo di un Chunk MODX

Puoi utilizzare un Chunk MODX per mantenere il codice di incorporamento separato e riutilizzabile:

Nel MODX Manager, vai su Elements > Chunks
Clicca su "New Chunk" per creare un nuovo chunk
Assegna al chunk il nome "asyntaiWidget"
Incolla il codice di incorporamento Asyntai nell'area del contenuto
Clicca su "Save"
Apri il tuo template (sotto Elements > Templates)
Aggiungi la chiamata al chunk [[$asyntaiWidget]] appena prima del tag di chiusura </body>
Salva il template

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Suggerimento: L'utilizzo di un Chunk semplifica la gestione e l'aggiornamento del codice di integrazione in un unico punto, specialmente se utilizzi più template nel tuo sito.

Metodo alternativo 2: Utilizzo delle impostazioni di sistema MODX (HTML Head/Footer)

Alcune configurazioni MODX includono segnaposto per gli script del footer tramite le impostazioni di sistema:

Nel MODX Manager, vai su System > System Settings
Filtra per "htmlhead" o cerca un'impostazione di sistema personalizzata per gli script del footer
Se la tua configurazione ha un segnaposto per gli script del footer (come [[++footer_scripts]]), puoi utilizzarlo
Imposta il valore dell'impostazione di sistema con il tuo codice di integrazione Asyntai
Assicurati che il segnaposto corrispondente [[++footer_scripts]] sia presente nel tuo template prima del tag di chiusura </body>
Salva l'impostazione di sistema

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Nota: Questo metodo dipende dalla tua configurazione MODX che ha un'impostazione di sistema personalizzata per gli script del footer. Se non esiste, puoi creare un'impostazione di sistema personalizzata e farvi riferimento nel tuo template utilizzando la sintassi [[++setting_key]].

Metodo alternativo 3: Utilizzo di un Plugin MODX (OnWebPagePrerender)

Per un approccio avanzato, puoi creare un Plugin MODX che inietta automaticamente il codice del chatbot in ogni pagina:

Nel MODX Manager, vai su Elements > Plugins
Clicca su "New Plugin" per creare un nuovo plugin
Assegna al plugin il nome "AsyntaiChatbot"
Incolla il seguente codice PHP nell'area codice del plugin:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Clicca sulla scheda "System Events"
Seleziona la casella accanto a "OnWebPagePrerender" per attivare questo plugin su quell'evento
Clicca su "Save"

Importante: Sostituisci YOUR_WIDGET_ID con il tuo ID widget effettivo dalla Dashboard Asyntai. Questo plugin inietterà automaticamente lo script del chatbot in ogni pagina del tuo sito MODX prima che venga renderizzata.

Passaggio 3: Svuota la cache e verifica

Dopo aver aggiunto il codice di integrazione utilizzando uno qualsiasi dei metodi sopra, devi svuotare la cache di MODX e verificare l'installazione:

Nel MODX Manager, vai su Manage > Clear Cache (o clicca sull'icona di svuotamento cache nel menu in alto)
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 della tua pagina
Cliccaci sopra per assicurarti che si apra e funzioni correttamente

Non vedi il widget? Assicurati di aver svuotato la cache di MODX da Manage > Clear Cache nel MODX Manager. Prova anche a svuotare la cache del browser o a visualizzare il sito in una finestra di navigazione in incognito. Se hai utilizzato il metodo Plugin, verifica che l'evento di sistema "OnWebPagePrerender" sia selezionato per il tuo plugin.