Risoluzione dei problemi
Problemi comuni e soluzioni per il modulo AI SmartTalk di PrestaShop.
Installazione
Il modulo non si installa
- Controlla la tua versione di PrestaShop: Il modulo richiede PrestaShop 8 o 9
- Controlla la memoria del server: Assicurati che il tuo server abbia abbastanza memoria per installare i moduli
- Controlla i permessi dei file: La directory
modules/deve essere scrivibile dal server web - Disabilita i moduli in conflitto: Prova a disabilitare temporaneamente altri moduli se ci sono conflitti
Il modulo è stato installato ma non appare nel menu
- Pulisci la cache di PrestaShop: Parametri avanzati > Prestazioni > Pulisci cache
- Prova a disconnetterti e riconnetterti al tuo admin di PrestaShop
Connessione
Il pulsante "Connetti con AI SmartTalk" non funziona
- Controlla l'HTTPS in uscita: Il tuo server deve consentire connessioni HTTPS in uscita verso
aismarttalk.tech - Controlla i blocchi dei pop-up: Il flusso OAuth si apre in una nuova finestra — assicurati che il tuo browser non lo stia bloccando
- Controlla il tuo firewall: Assicurati che le porte 443 (HTTPS) non siano bloccate
La connessione reindirizza ma non succede nulla
- Il token OAuth è valido per 10 minuti. Se hai aspettato troppo a lungo, prova a disconnetterti e riconnetterti
- Pulisci i cookie del tuo browser e riprova
Multi-sito: un sito appare come "Disconnesso"
- Ogni sito ha bisogno della propria connessione OAuth. Vai all'istanza di PrestaShop interessata e clicca di nuovo su Connetti
- Assicurati che ogni sito abbia un nome di dominio o una porta distinti
Chatbot
Il chatbot non appare nel mio negozio
- Controlla lo stato del modulo: Assicurati che il chatbot sia abilitato nella scheda Chatbot del modulo
- Controlla la selezione dell'assistente: Assicurati che un assistente AI sia selezionato e salvato
- Controlla la connessione: Il modulo deve essere connesso a AI SmartTalk (badge di stato verde)
- Pulisci le cache: Pulisci sia la cache di PrestaShop (Parametri avanzati > Prestazioni) che la cache del tuo browser
- Controlla la posizione del hook: Prova a passare tra "Footer" e "Prima del Footer" nelle impostazioni di Aspetto
Il chatbot appare ma non risponde
- Verifica che il tuo abbonamento a AI SmartTalk sia attivo
- Controlla che l'assistente selezionato sia configurato correttamente nel tuo dashboard di AI SmartTalk
- Controlla la console di sviluppo del tuo browser per errori JavaScript
API & Azioni AI
Le azioni AI falliscono con "permesso negato" o "non autorizzato"
- Controlla la tua chiave Webservice: Assicurati che sia abilitata e abbia i permessi corretti (vedi Permessi API)
- Verifica che la chiave sia inserita: Il token Webservice deve essere trasmesso durante la connessione OAuth. Se manca, aggiornalo nel tuo dashboard di AI SmartTalk sotto le impostazioni di integrazione di PrestaShop
Gli aggiornamenti dei prodotti non funzionano
- Assicurati che
productsabbia sia i permessi GET che PUT sulla tua chiave Webservice - Controlla che l'ID prodotto esista e che il prodotto non sia bloccato da un altro modulo
I cambiamenti di stato degli ordini falliscono
- Assicurati che
order_historiesabbia sia i permessi GET che POST - Verifica che l'ID stato dell'ordine sia valido per il tuo negozio (gli ID stato variano in base alla configurazione di PrestaShop)
La ricerca clienti non restituisce risultati
- Assicurati che
customersabbia il permesso GET - Controlla che l'indirizzo email sia corretto e corrisponda a un cliente esistente
Sincronizzazione
La sincronizzazione dei prodotti non inizia o fallisce
- Controlla le impostazioni di timeout PHP del tuo server — cataloghi grandi potrebbero richiedere più tempo
- Verifica che la tua connessione internet sia stabile
- Controlla i log di errore di PrestaShop in Parametri avanzati > Log
Solo alcuni prodotti vengono sincronizzati
- Controlla se i filtri di sincronizzazione sono attivi (un badge "Filtrato" appare nella scheda Sincronizza)
- Rivedi i filtri di categoria e tipo di prodotto per assicurarti che corrispondano alle tue aspettative
La sincronizzazione dei clienti non funziona
- Assicurati che la sincronizzazione dei clienti sia abilitata nella scheda Sincronizza
- I clienti vengono esportati in batch di 50 — database grandi potrebbero richiedere diversi minuti
Webhook
I webhook non si attivano
- Verifica che i trigger dei webhook siano abilitati nella scheda Webhook
- Controlla che il tuo server consenta richieste HTTP in uscita verso AI SmartTalk
- Assicurati di avere un workflow SmartFlow configurato per ricevere il trigger del webhook
- Controlla i log di PrestaShop per eventuali errori durante l'esecuzione del hook
I webhook si attivano ma non succede nulla in SmartFlow
- Verifica che il tuo workflow SmartFlow sia pubblicato e attivo
- Controlla che il tipo di trigger del workflow corrisponda all'evento webhook di PrestaShop
- Rivedi i log di esecuzione di SmartFlow nel tuo dashboard di AI SmartTalk
Prestazioni
Il modulo rallenta il mio negozio
- Disabilita i trigger dei webhook non utilizzati per ridurre le richieste in uscita
- Assicurati che la cache funzioni correttamente — il modulo utilizza una cache integrata per la configurazione dell'embed
- Controlla che il tuo server abbia risorse adeguate (CPU, memoria)
Il back office è lento dopo aver installato il modulo
- Il modulo funziona solo nella sua pagina di configurazione e in hook specifici — non dovrebbe influenzare le prestazioni generali del back office
- Se riscontri problemi, controlla eventuali conflitti con altri moduli
Hai ancora bisogno di aiuto?
Se il tuo problema non è trattato qui:
- Controlla il dashboard di AI SmartTalk per messaggi di errore o avvisi
- Rivedi i log di errore di PrestaShop (Parametri avanzati > Log)
- Contatta il nostro team di supporto all'indirizzo contact+support@aismarttalk.tech