---
title: Come installare l'agente su WordPress e WooCommerce
description: 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.
section: platforms
keywords: WordPress, WooCommerce, installare agente WordPress, widget chat WordPress, chat AI sito web, footer.php, plugin inserimento codice WordPress, agente AI, assistente virtuale e-commerce, integrazione chat WooCommerce, configurare agente AI, caching plugin WordPress, collegare chat carrello, codice agente WordPress
updated: 2026-09-06
---
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.

1.  Installate un qualsiasi plugin per l'inserimento di script: WPCode, Insert Headers and Footers, Code Snippets.
2.  Aprite le impostazioni del plugin e trovate il campo per il codice nel footer — di solito si chiama **Footer** o **Body (before closing tag)**.
3.  Incollate la riga dal pannello di controllo e salvate.

## Metodo 2: file del tema

1.  **Aspetto → Editor dei file del tema**.
2.  Aprite `footer.php`.
3.  Incollate il codice prima di `</body>`.
4.  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:

```php
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:

1.  Svuotate la cache del plugin: WP Rocket, W3 Total Cache, LiteSpeed o quello che usate.
2.  Svuotate la cache del CDN, se usate Cloudflare.
3.  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.