Requisiti
- WordPress 6.0 o superiore, PHP 8.1 o superiore.
- WooCommerce 8.x+ consigliato ma non obbligatorio: il chatbot funziona anche solo con feed prodotti o inserimento manuale.
- Una licenza attiva acquistata su store.smartchatassistant.com (la ricevi via email subito dopo l'acquisto) — oppure la prova gratuita di 14 giorni (tutte le funzioni Pro, nessuna carta richiesta).
- Nessuna chiave AI da procurare: l'intelligenza artificiale è inclusa nel piano e gestita dai nostri server.
Installazione in 5 minuti
ai-shopping-assistant.zip). Il download è disponibile solo con licenza attiva.AISA-XXXX-XXXX-XXXX-XXXX) al passo 1 e premi Attiva licenza. Il tuo dominio viene registrato automaticamente.Fine: la bolla della chat appare sul tuo sito, in basso a destra (o a sinistra, se preferisci).
localhost, *.local, *.test e *.staging.* non consumano attivazioni: puoi provare tutto in staging prima di andare online.Licenza e domini
Ogni licenza funziona esclusivamente sui domini autorizzati del tuo piano (Starter e Pro: 1 dominio; Business: 3 domini).
- Prima attivazione: il dominio si registra da solo, entro i limiti del piano. Se il fornitore ha impostato l'approvazione manuale, resta "in attesa" finché non viene approvato: il plugin te lo mostra chiaramente nel wizard.
- Cambiare sito: dal portale clienti puoi rimuovere un dominio e attivarne un altro (massimo 3 cambi l'anno self-service; oltre, contatta il supporto).
- Scadenza e rinnovo: il rinnovo è automatico via Stripe. Se un pagamento fallisce hai 7 giorni di periodo di grazia con l'assistente funzionante e avvisi in bacheca; poi il servizio si sospende (il tuo sito resta perfettamente integro).
Il catalogo prodotti
Il chatbot attinge da tre sorgenti, combinabili, gestite da AI Assistant → Catalogo:
| Sorgente | Come si usa | Ideale per |
|---|---|---|
| WooCommerce | Sincronizzazione automatica: ogni modifica a prodotti, prezzi e stock si riflette in chat. Il primo import va a blocchi con barra di avanzamento ("348 di 1.250 prodotti"), senza timeout anche su cataloghi grandi; se ricarichi la pagina riprende da dov'era. | Chi vende con WooCommerce (varianti incluse: colore, taglia…) |
| Feed prodotti | Incolla l'URL (o carica il file) di un feed Google Shopping XML, Facebook/Meta XML, CSV o JSON. Mappatura automatica dei campi, refresh programmato (orario/giornaliero) e report import. L'import gira in background: anche cataloghi da migliaia di prodotti non bloccano il pannello (stato "import in corso", poi il report). | Cataloghi di fornitori, dropshipping, siti senza WooCommerce |
| Prodotti manuali | Form con nome, descrizione, prezzo, foto, link e attributi. L'anteprima mostra la card esattamente come apparirà in chat. | Promozioni, servizi, prodotti fuori e-commerce |
In caso di doppioni tra sorgenti vince la priorità configurata in Impostazioni → Catalogo (default: manuale > WooCommerce > feed).
Knowledge AI: cosa conosce l'assistente
Da AI Assistant → Knowledge AI decidi esattamente cosa l'assistente può proporre e consigliare:
- Categorie e brand inclusi: flagga le categorie WooCommerce e i brand che l'AI può usare — nessun flag = tutto incluso (default), con pulsanti Seleziona/Deseleziona tutte. Flaggare una categoria padre include le sue sottocategorie; se i brand nel tuo negozio sono organizzati come sottocategorie, flaggali lì: il filtro li riconosce comunque come brand. I prodotti fuori dalle regole spariscono da ricerche, card e panoramica; al salvataggio il catalogo si riallinea da solo in background.
- Link alle pagine categoria: le categorie del catalogo (feed compreso, aggiornate a ogni import) con l'URL della pagina dedicata — proposto automaticamente per le categorie WooCommerce, da incollare per i feed di siti esterni. Quando l'assistente consiglia una categoria, fornisce anche il link. Gli URL salvati non si perdono se una categoria sparisce temporaneamente dal feed, e puoi aggiungere righe per categorie non ancora presenti.
- Brand con pagina e descrizione: per ogni brand puoi aggiungere URL della pagina dedicata e una breve descrizione: l'AI le userà quando un cliente chiede del brand («chi è …?»), link compreso.
- Prodotti: includi/escludi: elenco paginato con ricerca; il toggle esclude (o reinclude) il singolo prodotto e le sue varianti. L'esclusione manuale vince sempre sulle regole di categoria/brand e sopravvive alle sincronizzazioni.
- Pagine del sito: descrivi cosa fa ogni pagina utile (resi, spedizioni, guida taglie…): quando è pertinente l'assistente indirizza il cliente alla pagina giusta includendo il link. Puoi aggiungere anche pagine esterne (es. sul sito del fornitore) con titolo, URL e descrizione — e il prompt impedisce all'AI di fornire link di pagine non configurate.
Personalizzare il widget
Da AI Assistant → Impostazioni:
- Aspetto: colore primario, logo/avatar, modalità popup o sidebar, CSS personalizzato.
- Posizione e distanze: bolla in basso a destra o a sinistra, con distanza dai bordi regolabile in px (dal fondo e dal lato, 0–400). Utile per alzare la chat sopra cookie banner o pulsanti fissi del tema; il pannello della conversazione si apre sempre appena sopra la bolla e adatta la propria altezza.
- Nome e benvenuto: il nome dell'assistente e il primo messaggio che accoglie il visitatore.
- Quick replies: fino a 4 suggerimenti cliccabili mostrati all'apertura (es. "Offerte in corso", "Cerco un regalo").
- Tono: Amichevole, Formale o Vendita assistita, più le istruzioni del negozio (spedizioni, resi, punti di forza) che l'AI userà nelle risposte. Ogni modifica è versionata: puoi ripristinare le versioni precedenti.
- Contatti negozio: email, telefono, WhatsApp, pagina contatti e orari. Quando un cliente chiede di essere contattato (o come contattarvi), l'assistente risponde con questi dati — mai inventati — e il widget mostra pulsanti cliccabili (chiama, WhatsApp, email, pagina contatti) più il modulo per lasciare i propri recapiti.
- Lead generation: modulo "lasciaci i tuoi dati" proposto dopo alcuni messaggi (configurabile) e comunque a ogni richiesta esplicita di contatto. I lead arrivano via email al destinatario configurato (default: email admin del sito) e restano consultabili in AI Assistant → Lead.
- Handoff umano: un contatto (email o WhatsApp) proposto quando l'assistente non trova la risposta.
- Schermo intero: il visitatore può espandere la chat a tutto schermo con il pulsante ⤢ nell'header (⤡ o Esc per tornare alla dimensione normale); a tutto schermo le card prodotto si dispongono in griglia.
Contenuti, FAQ e documenti
Oltre ai prodotti, l'assistente può rispondere su spedizioni, resi, taglie e policy. In Catalogo → Contenuti & FAQ:
- Pagine e articoli: seleziona quali indicizzare (es. "Spedizioni e resi", "Chi siamo").
- FAQ: aggiungi coppie domanda/risposta puntuali.
- Documenti: carica file TXT o PDF (per i PDF complessi consigliamo il TXT).
Cosa può chiedere il cliente
- «Cerco un vestito rosso sotto i 50 €» → card dei prodotti corrispondenti con foto, prezzo (ed eventuale sconto), disponibilità e pulsante Vai al prodotto.
- «Avete la maglia rossa in taglia M?» → l'assistente risolve la variante esatta con il suo prezzo e stock.
- «Cosa avete in offerta?», «Quanto costa la spedizione?», «Come funzionano i resi?»
- «Che categorie/marche avete?» → l'assistente elenca le categorie e le marche reali del catalogo (con fascia prezzo) e mostra pulsanti cliccabili che aprono i rispettivi archivi o pagine — solo per le voci abilitate in Knowledge AI.
- «Vorrei essere contattato» → risponde con i contatti reali del negozio, mostra i pulsanti chiama/WhatsApp/email e propone il modulo per lasciare i propri recapiti.
Ogni card è interamente cliccabile e ha il suo pulsante di condivisione (WhatsApp, Telegram, Facebook, email, copia link). L'intera conversazione è condivisibile con il pulsante ⤴ nell'header della chat. Sotto i risultati compare il carosello "Potrebbe interessarti anche".
Statistiche e conversazioni
- AI Assistant → Statistiche: conversazioni per giorno, click sulle card e CTR, condivisioni, fallback rate (quante risposte non hanno proposto prodotti), domande più frequenti e prodotti più cliccati. I link delle card portano UTM (
utm_source=aisa_chat) per vederle in Google Analytics. - AI Assistant → Conversazioni: storico con ricerca nel testo, filtri per data, trascrizione completa ed export CSV.
- Dashboard: stato licenza, prodotti indicizzati e consumo quota con avvisi all'80% e al 100% (a quota esaurita l'assistente si mette in pausa fino al mese successivo o all'upgrade di piano).
Privacy e GDPR
- Consenso: di default la cronologia si salva solo se il visitatore spunta il consenso nel widget; senza consenso la chat funziona ugualmente, senza persistenza.
- Anonimizzazione IP: attiva di default — viene salvato solo un hash non reversibile, con chiave che ruota ogni giorno.
- Retention: le conversazioni si cancellano automaticamente dopo il periodo configurato (default 90 giorni).
- Diritti degli utenti: export e cancellazione integrati negli strumenti privacy di WordPress (Strumenti → Esporta/Cancella dati personali), più cancellazione puntuale dallo storico conversazioni.
- I dati delle conversazioni non vengono usati per addestrare modelli di terze parti.
Risoluzione problemi
Il widget non appare sul sito
1) Verifica in AI Assistant → Dashboard che la licenza sia attiva e il dominio approvato. 2) Controlla che il widget sia attivo in Impostazioni. 3) Svuota la cache (plugin di caching e CDN). Nota: se la licenza non è valida, il widget è visibile in anteprima solo agli amministratori, mai ai visitatori.
«Dominio in attesa di approvazione»
La tua licenza è configurata con approvazione manuale: riceverai l'abilitazione a breve. Lo stato è visibile al passo 2 del wizard e nel portale clienti.
L'assistente non trova un prodotto che esiste
Esegui Catalogo → Sincronizza ora; verifica che il prodotto sia pubblicato e visibile; se arriva da feed, controlla il report dell'ultimo import (colonna "Report").
«Quota conversazioni esaurita»
Hai raggiunto il limite mensile del piano. La quota si azzera il mese successivo, oppure puoi passare a un piano superiore dal portale clienti: l'upgrade è immediato.
Ho cambiato dominio / migrato il sito
Rimuovi il vecchio dominio dal portale clienti e riattiva la licenza dal wizard sul nuovo sito. Le migrazioni verso staging non consumano attivazioni.
Il sito è lento o si è rotto: è colpa del plugin?
No: il widget pesa meno di 50KB, si carica in differita e non tocca il rendering della pagina. In caso di qualunque errore interno il plugin si disattiva silenziosamente senza impattare il sito. Se noti anomalie, scrivici comunque.
Domande frequenti
Serve una chiave OpenAI o Anthropic?
No. L'AI è inclusa nel piano e gestita dai nostri server: nessuna chiave da acquistare, configurare o proteggere.
Funziona senza WooCommerce?
Sì: puoi usare solo feed prodotti e/o inserimento manuale. Con WooCommerce in più ottieni sync automatico e risoluzione delle varianti.
Posso usarlo su più siti?
Starter e Pro includono 1 dominio, Business 3. Per agenzie con molti clienti: piano Business white-label o contattaci.
In che lingue risponde?
L'assistente risponde nella lingua in cui scrive il cliente (italiano, inglese, francese, tedesco, spagnolo, portoghese, olandese): il rilevamento è automatico e nei casi ambigui decide l'AI. Sui siti multilingua (WPML/Polylang) i messaggi ambigui usano la lingua della versione del sito che il visitatore sta navigando. L'admin è in italiano e i testi del widget sono traducibili via .pot.
Come disdico?
Dal portale clienti → Gestisci pagamenti (Stripe Customer Portal). L'assistente resta attivo fino a fine periodo pagato, poi si sospende senza toccare il sito.
Cosa succede ai miei dati se disinstallo?
La disinstallazione rimuove tabelle e impostazioni del plugin dal tuo database. I prodotti WooCommerce e i contenuti del sito non vengono toccati.
Serve aiuto? Scrivici: support@smartchatassistant.com — rispondiamo entro 1 giorno lavorativo (priorità per i piani Business).