Interfaccia web minimal in scala di grigi con widget chat assistente virtuale in evidenza e dettagli arancioni, collegato a icone server e documenti su sfondo chiaro.
Featured

Come inserire un assistente virtuale nel tuo CMS (senza fare disastri)

Negli ultimi mesi mi sento ripetere spesso la stessa frase: “Vorrei un assistente virtuale sul sito… ma che funzioni davvero”.

Traduzione: non un pop-up aggressivo stile call center anni ’90, ma un sistema che risponda alle domande reali dei clienti, alleggerisca il lavoro umano e guidi l’utente verso ciò che cerca (servizi, preventivi, contatti, FAQ, supporto).

La buona notizia è che oggi integrare un assistente virtuale in un CMS è fattibile anche senza trasformarsi in un ingegnere NASA. La cattiva notizia è che si può fare “male” con grande facilità.

1) Prima domanda: a cosa deve servire (davvero) questo assistente?

Questa è la parte che molti saltano, e poi si lamentano perché “non serve a niente”. Un assistente virtuale può essere davvero utile se è progettato per:

  • rispondere alle domande frequenti (prezzi, tempi, servizi, consegne, pagamenti)
  • consigliare la pagina giusta (“ti serve un preventivo? clicca qui”, “vuoi la scheda tecnica? eccola”)
  • filtrare richieste (contatto commerciale vs assistenza)
  • evitare che l’utente si perda nel sito
  • recuperare informazioni dai contenuti esistenti (pagine, articoli, guide)

Se l’obiettivo è solo “fare scena”, meglio evitarlo: gli utenti sono spietati e in cinque secondi capiscono se è fumo.

2) Dove lo metto: widget fisso o chat “a richiesta”?

Ci sono due approcci principali:

  • Chat bubble (in basso a destra, sempre visibile): utile se hai pubblico B2C o vuoi intercettare utenti indecisi.
  • Widget integrato in una pagina (Contatti, Servizi, Assistenza): spesso più elegante per siti aziendali, perché l’utente arriva già in modalità “ok, dimmi cosa fai”.

In generale, su progetti B2B la versione integrata funziona molto bene: meno invadente, più coerente con un tono professionale.

3) Come si integra tecnicamente (in quasi tutti i CMS)

Nei CMS moderni hai quasi sempre una di queste strade:

  • blocco “HTML personalizzato” dentro una pagina
  • modulo/widget nativo del CMS
  • plugin di terze parti
  • inserimento nel template (soluzione più pulita, ma più tecnica)

Il pattern è quasi sempre lo stesso:

  1. metti un contenitore HTML nella pagina
  2. carichi uno script
  3. lo script cattura la domanda
  4. invia la richiesta a un endpoint server
  5. mostra la risposta

Esempio concettuale:

<div id="assistente"></div>
<script src="/assets/js/mio-assistente.js"></script>

Il file JavaScript gestisce interfaccia e chiamata al server. Semplice “a parole”, ma ci sono due punti cruciali: sicurezza e contenuti.

4) No, non chiamare l’AI dal browser

Se chiami l’AI direttamente dal front-end (browser) devi mettere una chiave API nel codice. E quella chiave diventa pubblica. Fine. Quindi la regola è:

L’AI si chiama sempre dal server.

Il tuo sito deve avere un endpoint (ad esempio /api/assistente) che riceve la domanda e fa da intermediario verso il provider AI. È una scelta tecnica, ma soprattutto una scelta di sicurezza e controllo costi.

5) La qualità delle risposte dipende dai contenuti (non dalla magia)

Sfatiamo un mito: “metto un assistente virtuale e lui sa tutto del mio sito”. Non è così. Se l’assistente non ha accesso a pagine servizi, FAQ, condizioni, schede prodotto, articoli e contatti, risponderà a intuito. E l’intuito, nel business, è una pessima strategia.

Per farlo rispondere bene hai due strade:

  • Base informativa fissa: elenco servizi + link + risposte standard (rapida da impostare, ma va aggiornata).
  • Recupero contenuti dinamico dal CMS (RAG): il server cerca nei contenuti più pertinenti e li passa all’assistente prima di generare la risposta (questa è la soluzione che regge nel tempo).

Se pubblichi articoli e nuove pagine con regolarità, il recupero dinamico è la scelta sensata: l’assistente “legge” il sito mentre risponde.

6) La cosa che fa la differenza: i link corretti

Un assistente virtuale utile non è quello che “parla bene”. È quello che ti porta nel posto giusto. Io imposto sempre una regola:

Se non sei certo del link, non lo dare.

E quando un link esiste, va proposto bene, in modo naturale: “Se vuoi richiedere un preventivo, trovi il form qui…”.

In un CMS ben organizzato, l’assistente diventa una scorciatoia intelligente per la navigazione. Ed è lì che inizia a “valere”.

7) Mini-checklist per non fare errori classici

  • Performance: se il sito è lento, la chat peggiora tutto.
  • Messaggi brevi: i muri di testo non li legge nessuno.
  • Tono coerente: un sito serio con un assistente clown è imbarazzante.
  • Gestione errori: se l’API non risponde, devi dirlo chiaramente.
  • Privacy: non chiedere dati sensibili inutili.
  • Escalation: se serve un umano, il contatto deve essere immediato.

Conclusione: un assistente virtuale è utile solo se è progettato come parte del sito

Non è un giochino, e non è “metto un chatbot e via”. Se lo tratti come un pezzo dell’esperienza utente, diventa supporto, guida, filtro commerciale e acceleratore di conversioni. Se invece lo piazzi a caso, diventa rumore e gli utenti lo ignorano.

Claudia — Mediacreative