Joomla
Integra AI SmartTalk con il tuo sito Joomla per aggiungere un chatbot intelligente e sincronizzare automaticamente i tuoi contenuti con la tua base di conoscenza.
1. Prerequisiti
Prima di iniziare, assicurati di avere:
- Un account AI SmartTalk attivo
- Accesso da amministratore al tuo sito Joomla (versione 6.x)
- cURL abilitato sul tuo server
- Per l'e-commerce: componente HikaShop installato (opzionale)
2. Download del Plugin
- Accedi al tuo account AI SmartTalk
- Naviga su Integrazione nel menu principale
- Trova la sezione Joomla
- Clicca sul pulsante Download per salvare il file ZIP del plugin sul tuo computer
3. Installazione su Joomla
- Accedi al tuo pannello di amministrazione di Joomla
- Vai su Estensioni > Gestisci > Installa
- Clicca sulla scheda Carica file pacchetto
- Seleziona il file ZIP di AI SmartTalk che hai scaricato
- Clicca su Carica e Installa
- Attendi il messaggio di conferma dell'installazione
4. Configurare il Plugin
4.1 Abilitare il Plugin
- Vai su Estensioni > Plugin
- Cerca System - AI SmartTalk
- Clicca sul nome del plugin per aprire le impostazioni
- Imposta Stato su Abilitato
4.2 Inserire le Credenziali API
- Nel tuo account AI SmartTalk, vai su Integrazione > Joomla
- Copia il Chat Model ID e il Chat Model Token
- Torna alle impostazioni del plugin Joomla
- Incolla il Chat Model ID nel campo corrispondente
- Incolla il Chat Model Token nel campo corrispondente
4.3 Scegliere i Tipi di Contenuto da Sincronizzare
Seleziona quali contenuti desideri sincronizzare con il tuo chatbot:
- Prodotti: Sincronizza i prodotti HikaShop (richiede HikaShop)
- Articoli: Sincronizza gli articoli Joomla
- Categorie: Sincronizza le categorie Joomla
4.4 Configura Auto-Sync
- Abilita Auto Sync per aggiornare automaticamente il tuo chatbot quando i contenuti cambiano
- Quando è disabilitato, puoi sincronizzare manualmente dalle impostazioni del plugin
4.5 Personalizza la Visualizzazione del Chatbot (Opzionale)
- CDN URL: Il valore predefinito è
https://cdn.aismarttalk.tech(cambia solo se utilizzi la versione whitebranded) - Posizione Iframe: Scegli dove appare il chatbot sul tuo sito
5. Sincronizzazione dei Dati
Sincronizzazione Iniziale
- Nelle impostazioni del plugin, fai clic su Salva e Chiudi
- Il plugin sincronizzerà automaticamente tutto il contenuto pubblicato:
- Articoli pubblicati con accesso pubblico
- Categorie pubblicate con accesso pubblico
- Prodotti HikaShop pubblicati con stock (se abilitato)
Sincronizzazione Automatica
Una volta configurato, il plugin sincronizza automaticamente:
- Quando salvi un articolo: Sincronizza immediatamente se pubblicato
- Quando aggiorni un prodotto: Sincronizza se pubblicato e in stock
- Quando cambi stato: Rimuove dal chatbot se non pubblicato
Ri-sincronizzazione Manuale
Per forzare una ri-sincronizzazione completa:
- Apri le impostazioni del plugin
- Fai clic su Salva e Chiudi
- Tutto il contenuto non sincronizzato verrà sincronizzato automaticamente
6. Verifica dell'Integrazione
Controlla il Display del Chatbot
- Visita il frontend del tuo sito Joomla
- Cerca la bolla del chatbot nell'angolo in basso a destra
- Clicca per aprire la finestra di chat
- Il chatbot dovrebbe caricarsi con le tue impostazioni configurate
Controlla i Contenuti Sincronizzati
- Accedi al tuo account AI SmartTalk
- Vai alla sezione Knowledge
- Verifica che i tuoi contenuti Joomla appaiano:
- Gli articoli dovrebbero mostrarsi con il loro testo completo
- I prodotti dovrebbero includere descrizioni e dettagli
- Le categorie dovrebbero essere elencate
Testa il Chatbot
- Fai una domanda sui tuoi contenuti Joomla
- Il chatbot dovrebbe rispondere con informazioni accurate
- Testa le query su articoli, prodotti o categorie che hai sincronizzato
7. Comportamento di Sincronizzazione dei Contenuti
Cosa Viene Sincronizzato
Articoli:
- Solo articoli pubblicati (
state = 1) - Livelli di accesso pubblici o registrati (
access = 1 o 5) - Contenuto completo dell'articolo, incluso il testo introduttivo
Prodotti (HikaShop):
- Solo prodotti pubblicati
- Prodotti con stock (quantità > 0 o stock illimitato)
- Descrizioni dei prodotti, prezzi e dettagli
Categorie:
- Solo categorie pubblicate
- Livelli di accesso pubblici o registrati
- Descrizioni delle categorie
Cosa Viene Rimosso
Il contenuto viene rimosso automaticamente dal chatbot quando:
- Un articolo viene dispubblicato
- Un prodotto esaurisce lo stock
- Un prodotto viene dispubblicato
- Una categoria viene dispubblicata
8. Risoluzione dei problemi
Il chatbot non appare sul sito
- Controlla che il plugin sia Abilitato
- Verifica che l'ID del Modello di Chat sia inserito correttamente
- Pulisci la cache di Joomla: Sistema > Pulisci Cache
- Controlla la console del browser per errori JavaScript
I contenuti non si sincronizzano
- Assicurati che Sincronizzazione Automatica sia abilitata nelle impostazioni del plugin
- Controlla che i contenuti siano pubblicati e abbiano accesso pubblico
- Per i prodotti, verifica che siano disponibili in stock
- Controlla i log degli errori del server per problemi di cURL o di connessione
La sincronizzazione dei prodotti non funziona
- Verifica che HikaShop sia installato e attivato
- Controlla che i prodotti siano pubblicati e disponibili in stock
- Assicurati che il tipo di contenuto "Prodotti" sia selezionato nelle impostazioni
Errori di connessione API
- Verifica che il Token del Modello di Chat sia corretto
- Controlla che il tuo server consenta connessioni HTTPS in uscita
- Assicurati che l'estensione cURL sia abilitata in PHP
- Testa la connettività API dalla riga di comando del server
9. Disinstallazione del Plugin
Se hai bisogno di rimuovere il plugin:
- Il plugin pulirà automaticamente:
- Rimuovere le colonne di tracciamento della sincronizzazione dalle tabelle del database
- Eliminare tutto il contenuto sincronizzato da AI SmartTalk
- Vai su Estensioni > Gestisci > Gestisci
- Cerca AI SmartTalk
- Clicca sulla casella di controllo e clicca su Disinstalla
10. Conclusione
Hai completato con successo:
- Installato il plugin AI SmartTalk su Joomla
- Collegato il tuo sito al tuo chatbot AI SmartTalk
- Configurato la sincronizzazione automatica dei contenuti
- Aggiunto un chatbot intelligente al tuo sito web
I tuoi visitatori possono ora ottenere risposte immediate sui tuoi contenuti, prodotti e servizi 24/7 tramite il chatbot alimentato da AI.
Per supporto, contattaci a contact+support@aismarttalk.tech