Come installare l'agente su WordPress e WooCommerce
Tre modi per inserire il codice su WordPress, come l'agente legge il catalogo WooCommerce, cosa fare con i plugin di caching e come collegare la chat al carrello.
Su WordPress, il codice si inserisce in tre modi. Scegliete in base alla vostra familiarità con la modifica dei file del tema.
Metodo 1: plugin di inserimento codice (consigliato)#
L'opzione più sicura: la modifica non andrà persa con l'aggiornamento del tema.
- Installate un qualsiasi plugin per l'inserimento di script: WPCode, Insert Headers and Footers, Code Snippets.
- Aprite le impostazioni del plugin e trovate il campo per il codice nel footer — di solito si chiama Footer o Body (before closing tag).
- Incollate la riga dal pannello di controllo e salvate.
Metodo 2: file del tema#
- Aspetto → Editor dei file del tema.
- Aprite
footer.php. - Incollate il codice prima di
</body>. - Aggiornate il file.
Importante: modificate il tema figlio. Quando il tema padre viene aggiornato, il file verrà sovrascritto insieme al vostro codice.
Metodo 3: tramite functions.php#
Per chi preferisce il codice. In functions.php del tema figlio:
add_action('wp_footer', function () {
echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="il-tuo-slug" async></script>';
});Prendete la riga esatta dello script dal pannello di controllo, usando il pulsante «Copia codice».
Catalogo da WooCommerce#
Indicate l'indirizzo del sito nelle impostazioni e avviate l'analisi. Il crawler legge i prodotti WooCommerce tramite i dati strutturati delle pagine: nome, prezzo, disponibilità, descrizione, foto, categorie.
Cosa sapere:
- Prodotti variabili appaiono nella scheda con un intervallo di prezzi e caratteristiche.
- Nascosti e bozze non vengono letti — ed è corretto così.
- Prodotti solo per utenti autorizzati l'agente non li vedrà: naviga il sito come un normale visitatore.
- Se avete un'esportazione di prodotti in CSV, potete caricarla nella sezione «Catalogo» — a volte è più veloce e preciso del crawling.
Carrello e pagamento#
Su WooCommerce, il pagamento in chat di solito non si abilita: il negozio ha la sua cassa con spedizione, tasse e coupon.
Nelle impostazioni, indicate il link al carrello, il più delle volte https://il-vostro-dominio/cart o /carrello. L'agente guiderà l'acquirente lì.
Per vedere quali dialoghi si trasformano in ordini, aggiungete il frammento del pixel di acquisto alla pagina «Grazie per l'ordine». Su WooCommerce, questo è il template checkout/thankyou.php o lo stesso plugin di inserimento codice con una condizione per la pagina dell'ordine.
Il pulsante nella chat aggiunge il prodotto al carrello WooCommerce#
Le schede prodotto nelle risposte dell'agente non sono immagini decorative. Ognuna ha un link alla pagina del prodotto nel vostro negozio, e l'agente sa usare il meccanismo standard di WooCommerce per aggiungere al carrello: un indirizzo del tipo ?add-to-cart=123.
Il cliente clicca il pulsante nella chat, il prodotto finisce nel carrello, e da lì funziona la vostra cassa con tutti i plugin di spedizione, coupon e tasse. Non sono necessarie integrazioni o chiavi: il meccanismo è integrato in WooCommerce fin dalla nascita.
Se il link porta a una pagina di un prodotto variabile, l'agente la apre — il cliente deve scegliere taglia e colore da solo, ed è giusto così: precompilare l'opzione per lui è rischioso.
Un'altra cosa da sapere: l'agente vede la pagina in cui è aperta la chat. Legge il markup del prodotto — nome, SKU, prezzo — e risponde nel contesto. Il visitatore è sulla scheda e scrive «c'è qualcosa di più economico?» — l'agente capisce con cosa confrontare e propone un'alternativa dal vostro catalogo, non un consiglio astratto.
La ragione principale per cui «il widget non è apparso» su WordPress è la cache. Dopo aver inserito il codice:
- Svuotate la cache del plugin: WP Rocket, W3 Total Cache, LiteSpeed o quello che usate.
- Svuotate la cache del CDN, se usate Cloudflare.
- Controllate il sito in modalità incognito.
Se nel plugin è abilitata l'«unione e caricamento differito degli script», aggiungete il nostro script alle eccezioni: la fusione di script di terze parti a volte interrompe il caricamento.
Tema chiaro e scuro#
Il widget supporta entrambe le opzioni. Nelle impostazioni si sceglie il tema chiaro, scuro o «come il visitatore» — quest'ultimo segue le impostazioni di sistema del dispositivo ed è l'impostazione predefinita.
È comodo se il vostro tema WordPress ha un interruttore giorno/notte: lasciate «come il visitatore» e la chat corrisponderà a ciò che la persona ha già scelto.
Plugin di caching#
Verifica#
- Il pulsante della chat appare nell'angolo in basso a destra su qualsiasi pagina del sito.
- Una domanda sul prodotto mostra una scheda con il prezzo.
- Il pulsante di checkout porta al carrello WooCommerce.
- Su mobile il pulsante non copre il menu e il carrello.
Domande frequenti#
Serve un plugin separato Commerce Agents#
No. Basta una riga di codice, un plugin separato non è richiesto né si installa.
Il widget non è apparso, cosa controllare per primo#
La cache: plugin di caching e CDN. Poi — che il codice sia inserito nel footer e non in un widget arbitrario della sidebar, e che il tema visualizzi effettivamente wp_footer().
L'agente saprà di sconti e coupon#
Riguardo ai coupon no: si applicano nel carrello WooCommerce. L'agente mostra i prezzi rilevati durante il crawling, inclusi i prezzi scontati se visualizzati sulla pagina del prodotto.
Rallenterà il sito#
Lo script è asincrono, pesa poco e non blocca il rendering della pagina. L'impatto su PageSpeed è minimo.
Si può mostrare il widget solo nel negozio, non nel blog#
Sì, se si inserisce il codice tramite un plugin con condizioni di visualizzazione o in functions.php con la verifica is_woocommerce(). Nel caso semplice, l'agente su tutte le pagine non disturba: risponde anche a domande sulla spedizione dal blog.