Modulo PrestaShop
Ultimo aggiornamento:
Per amministratori PrestaShop e manager tecnici. Precedente: · Prossimo:
Il modulo PrestaKick collega PrestaShop a PrestaKick, sincronizza i dati e mostra le funzionalità rivolte al cliente sul sito web.
Apri la sezione gestione moduli
Dopo aver installato il modulo, apri PrestaKick AI nel PrestaShop Back Office. Le sezioni principali sono:
- Connection: connessione al negozio e accesso ai dati.
- Widget: configurazione del frame chat.
- Features: attivare la ricerca e i suggerimenti di prodotto.
- Cron Jobs: configurare compiti ricorrenti e visualizzare i log.
- AI Content e AI Translate: creare o tradurre contenuti nel Back Office.
- Support: visualizzare le informazioni di supporto.
Dopo aver cambiato la configurazione, seleziona Save configuration. Se lasci la pagina prima di salvare, la modifica non avrà effetto.
Connettiti usando OAuth
OAuth è il modo consigliato per connettersi:
- Apri Connection.
- Seleziona Connect with PrestaKick.
- Accedi alla Dashboard se necessario.
- Seleziona il negozio giusto e poi seleziona Confirm connection.
- Torna al modulo e verifica lo stato del Connected.
- Seleziona Save configuration.
Completa una connessione prima di aprire un nuovo flusso OAuth. I collegamenti OAuth sono a tempo limitato e possono essere usati solo una volta.
Collegamento manuale
Usa Connect manually solo quando non riesci a connetterti usando OAuth. Devi inserire i valori forniti dalla Dashboard, inclusi:
- PrestaKick URL
- Module Secret
- API Base URL
- Widget Key
- Shop ID
- API Widget URL
Per uno store live, l'API deve puntare a https://api.prestakick.com e il servizio di chat a https://chat.prestakick.com.
Dopo aver inserito, seleziona Save configuration e poi Test connection.
Permessi di accesso ai dati
La sezione Store API Key permette PrestaKick di richiedere dati dallo store. API Permissions specificare il tipo di dati da leggere, ad esempio:
- Prodotti e categorie.
- Clienti e ordini.
- Carrello della spesa.
- Memorizzare le informazioni.
- Pagine CMS.
Attiva solo i tipi di dati di cui hai bisogno. Se disattivi un permesso, potrebbero mancare funzionalità che dipendono da quel tipo di dati.
Quando crei una nuova chiave API, la vecchia chiave smette di funzionare. Seleziona Save configuration, poi aggiorna eventuali sistemi che usano ancora la vecchia chiave.
Abilita la ricerca e i suggerimenti
Features aperte da gestire:
- Image Search (Vision Search): cercare prodotti per immagini.
- Semantic Search: trovare i prodotti per significato.
- Display Related Products: visualizzare prodotti correlati in località selezionate.
Se la pagina mostra API connection required, completa prima la connessione. Alcune caratteristiche richiedono una pianta adeguata; vedi .
Come vengono sincronizzati i dati
Quando i dati cambiano in PrestaShop, il modulo aggiunge la modifica a una coda. Cron elabora la coda e invia i dati a PrestaKick.
Puoi anche richiedere una resincronizzazione dalla pagina Data sync nella Dashboard. Ogni tipo di dato ha un limite manuale di frequenza di sincronizzazione; Se vedi un messaggio di limite, aspetta di poter riprovare.
Stato della connessione
| Stato | Significato | Cosa fare |
|---|---|---|
| Healthy | Segnale di attività recente e coda normale | Nessuna azione necessaria |
| Degraded | Vecchi segnali o code in crescita | Controlla il cron e i log se lo stato persiste |
| Offline | Non ricevo segnale recente | Controlla il modulo del server, il cron e la connessione Internet |
| Unknown | Dati di valutazione insufficienti | Aspetta qualche minuto dopo la prima connessione |
Connected conferma solo che i dettagli della connessione sono validi. Gli stati sopra indicati riflettono le attività recenti del modulo.
Imposta i lavori Cron
- Apri i lavori → impostazioni Cron.
- Copia il comando o l'URL fornito dal modulo.
- Aggiungi al programmatore del tuo hosting in base alla frequenza mostrata sullo schermo.
- Usa Run now per una prova se necessario.
- Apri i Cron Jobs → Log per vedere i risultati.
Non condividere gli URL cron perché contengono codici di sicurezza. Se i log segnalano Unauthorized: invalid or missing cron token., copia le nuove informazioni dal Settings e aggiornale sull'hosting.
Contenuti AI e traduzione AI
AI Content supporta la creazione di contenuti. AI Translate supporta la traduzione in altre lingue. Ogni sezione ha le sue ambientazioni e la sua storia.
Correggi i contenuti generati dall'IA prima di pubblicare. Controlla nomi dei prodotti, specifiche, politiche e terminologia del marchio.
Quando serve supporto
Invia all'assistenza:
- Nome del negozio e dominio del negozio.
- Screenshot completo del messaggio di errore.
- Quando si è verificato l'errore, con il fuso orario.
- Stato nei Connection e nei registri correlati in Cron Jobs → Logs.
Non inviare Module Secrets, API Keys, Widget Keys o cron token.