Risoluzione dei problemi
Ultimo aggiornamento:
Per gli operatori di officina e i responsabili tecnici. Precedente:
Trova il messaggio che vedi sullo schermo, poi segui i passaggi nella tabella corretta. I messaggi sono conservati in inglese così puoi abbinarli all'interfaccia.
Controlli rapidi
Prima di risolvere un problema specifico:
- Verifica di operare nel negozio giusto.
- Apri ** PrestaKick AI → Connection** nel modulo.
- Controlla lo stato Connected.
- Se hai appena cambiato la configurazione, seleziona Save configuration.
- Apri i Cron Jobs → i Log e controlla l'ultima run.
- Sul Cruscotto, controlla lo stato di Healthy, Degraded, Offline o Unknown.
- Riprova con una finestra incognito per escludere i dati vecchi nel browser.
Errore di connessione del modulo
| Messaggio o sintomo | Causa comune | Cosa fare |
|---|---|---|
| API connection required | Modulo che non si connette o che non chiama l'API | Apri Connection, riconnetti e seleziona Save configuration |
| Not connected | OAuth incompleto o disconnesso | Scegli Connect with PrestaKick, scegli il negozio giusto e conferma |
| Connected ma Features segnala ancora un errore | Impostazioni non salvate, URL errato o nessun accesso Internet in uscita | Salva le impostazioni, controlla https://api.prestakick.com e poi usa Test connection |
| Connection failed / Connection test failed | Informazioni mancanti o API inaccessibili | Controlla Module Secret, API Base URL, Shop ID e connettività di rete |
| Invalid API Base URL format | L'URL è malformato |
Non inviare Segreti del Modulo o Chiavi API nelle richieste di supporto.
Errore OAuth
| Messaggio | Cosa fare |
|---|---|
| Invalid connection request | Chiudi la pagina corrente e ricomincia da Connect with PrestaKick nel modulo |
| OAuth connection token has expired | Ricomincia dal modulo; Il vecchio link è scaduto |
| OAuth connection token has already been used | Non riaprire il vecchio link; avvia un nuovo flusso di connessione |
| Shop is already connected to another PrestaShop URL | Controlla gli URL vecchi e nuovi prima di scegliere di riconnettersi |
| Only the shop owner can connect this shop | Accedi con un account proprietario o chiedi al proprietario di farlo |
| No unconnected shops | Crea un negozio o ricollega un negozio esistente se è quello che intendi fare |
Apri solo un processo OAuth alla volta.
Modulo offline o sincronizzazione manca di dati
| Fenomeno | Come gestirlo |
|---|---|
| I rapporti dei moduli Offline | Controlla che il modulo sia abilitato, che cron sia in esecuzione e che il server abbia accesso a Internet |
| I rapporti dei moduli Degraded | Apri Cron Jobs → Log, controlla gli errori ripetuti e la coda, poi monitora se lo stato si recupera |
| I rapporti del modulo Unknown dopo una nuova connessione | Aspetta qualche minuto e avvia cron una volta |
| Dati vecchi o mancanti del Dashboard | Controlla lo stato del modulo e apri il Data sync per richiedere una resincronizzazione |
| Manual sync is rate limited to once per hour per entity type | Aspetta che scada il limite di tempo prima di eseguire di nuovo il tipo di dato |
| Report di lavoro di sincronizzazione Failed | Apri i dettagli, risolvi la causa, poi rifai il lavoro |
| Unauthorized: Invalid or missing API Key | Controlla la chiave API dello store, seleziona Save configuration o riconnettiti usando OAuth |
| Unauthorized: invalid or missing cron token. |
Widget che non appare
Controlla in quest'ordine:
- Show Widget abilitato, oppure l'IP di test è nel Preview IPs.
- Hai scelto Save configuration.
- Il nome di dominio attuale è nel Allowed storefront domains.
- Il modulo non è in Offline stato.
- Il browser non utilizza JavaScript vecchio; Prova con un aggiornamento forzato o una finestra in incognito.
- Se il test è sul telefono, Show on Mobile è acceso.
| Messaggio | Cosa fare |
|---|---|
| Widget origin is not allowed for this shop | Il proprietario aggiunge il nome di dominio corretto in Impostazioni → Dominio & Accesso, poi seleziona Save rules |
| Invalid widget key | Ricollega OAuth o aggiorna una nuova Chiave del Widget nella tua configurazione attuale |
| Failed to save widget configuration | Controlla la connessione, i permessi e i limiti del piano, poi salva di nuovo |
| Upgrade to Starter or higher to allow image uploads | Passa a Starter o superiore, oppure disattiva Allow image uploads |
Chat e assistenti AI
| Messaggio o sintomo | Cosa fare |
|---|---|
| La chat si apre ma l'IA non risponde | Controlla quote, stato del modulo, dati sincronizzati e notifiche di servizio |
| You are sending messages too fast... | Aspetta qualche secondo e poi riinvia |
| AI credits have been exhausted | I proprietari acquistano più crediti, aggiornano il piano o aspettano un nuovo limite |
| Too many requests. Please try again later | Aspetta e riprova; Se succede spesso con traffico reale, contatta l'assistenza |
| Service is temporarily unavailable | Riprova più tardi; gli agenti possono prendere il controllo delle conversazioni se la Chat Inbox è ancora attiva |
| L'assistente dà una risposta generica | Controlla descrizioni dei prodotti, pagine di policy, sincronizzazioni e istruzioni per l'Assistente |
| Message could not be sent. | Controlla la connessione e riprova |
| Could not send the image. | Controlla il formato dell'immagine, la dimensione del file e se il piano consente il caricamento delle immagini |
Accesso e sicurezza
| Messaggio | Cosa fare |
|---|---|
| Invalid credentials | Controlla email, password e Blocco Maiuscolo; Usa Forgot password se necessario |
| Account is not verified | Apri un'email di verifica o richiedi un nuovo invio del link |
| Account is suspended or locked | Contatta il supporto tramite i canali ufficiali |
| TOTP code is required | Inserisci un codice a sei cifre da un'app autenticatrice |
| TOTP code is invalid | Aspetta un nuovo codice e controlla che il telefono imposti automaticamente l'orario |
| Refresh token has expired | Rientra nella Dashboard |
| Funzionamento sensibile incompleto | Controlla il tuo ruolo e completa la riautenticazione |
| You need an active shop membership... | Controlla lo stato del negozio selezionato e dell'iscrizione |
Se perdi il dispositivo di autenticazione, usa un codice di recupero inutilizzato. Non inviare codici TOTP o di recupero ad altri.
Piani e limiti
| Messaggio | Cosa fare |
|---|---|
| Image search is not available on the current plan | Aggiorna a Starter o superiore, oppure disattiva la funzione |
| Recommendations are not available on the current plan | Aggiorna a Launch o superiore, oppure disattiva le raccomandazioni |
| The monthly recommendation request quota has been reached | Aspetta il prossimo periodo di quota o aggiorna il piano |
| Current usage exceeds the selected plan limits | Riduci il consumo sotto il limite o scegli un piano diverso |
| Your current plan does not allow connecting another shop | Aggiorna il tuo piano o usa un negozio entro i tuoi limiti attuali |
| Image storage quota exceeded | Elimina i dati inutili se c'è un'opzione adatta, oppure aggiorna il piano |
Quando devi contattare il supporto
Preparazione:
- Nome del negozio e nome di dominio del sito web.
- Screenshot completo del messaggio di errore.
- L'orario di avvenimento, con il fuso orario.
- Appena fatti passi.
- Se l'errore riguarda tutti o solo un account, dispositivo o indirizzo IP.
- Il record rilevante nei Cron Jobs → Logs, se applicabile.
Non inviare password, codici TOTP, codici di recupero, Module Secrets, API Keys, Widget Keys o cron token.