Modulo Magento 2 – Richiedi informazioni sul prodotto

MAGENTO 2 · DOMANDE · FAQ · ASSISTENTE AI

Kowal Richiedi informazioni sul prodotto

Unisci modulo di contatto, FAQ pubblicate e assistente AI opzionale. Utilizza i dati del prodotto e la base di conoscenza, trasformando le conversazioni ricorrenti in risposte disponibili per i clienti successivi.

Modulo e FAQ · Contesto prodotto · Conversazioni e feedback

COME FUNZIONA IN PRATICA

Kowal_ZapytajOProdukt è un modulo Magento 2 avanzato per la comunicazione con il cliente nella scheda prodotto. Unisce un classico modulo per le domande, FAQ strutturate e un Assistente AI in un’unica soluzione coerente.

In pratica, la scheda prodotto smette di essere soltanto il luogo in cui presentare descrizione e parametri tecnici, e diventa un punto attivo di gestione delle domande del cliente. L’utente può:

• porre una domanda classica sul prodotto,
• utilizzare risposte pronte pubblicate nelle FAQ,
• parlare con l’Assistente AI, che risponde nel contesto del prodotto attualmente visualizzato.

Il modulo è stato progettato per risolvere due problemi contemporaneamente:

• operativo, cioè ridurre il numero di domande ripetitive che arrivano al team del negozio,
• di prodotto, cioè costruire una base di conoscenza crescente e ordinata che nel tempo migliora la qualità delle risposte.

In molti negozi online una parte significativa delle domande dei clienti si ripete:

• se il prodotto è compatibile con una specifica versione di Magento,
• se funziona senza un modulo aggiuntivo,
• come avviene l’installazione,
• se supporta più lingue,
• se richiede modifiche non standard al template,
• come si comporta in uno scenario di business specifico.

Senza uno strumento di gestione dedicato, queste domande:

• sovraccaricano il supporto,
• rallentano le decisioni di acquisto,
• disperdono la conoscenza tra caselle e-mail, ticket e conversazioni commerciali,
• non tornano al negozio sotto forma di FAQ strutturata.

Questo modulo organizza il processo. Prima raccoglie domande e risposte, poi le struttura nelle FAQ e, nella fase successiva, le utilizza come contesto per l’Assistente AI e per il livello di retrieval basato su OpenAI Vector Store.

Il modulo funziona a livelli.

Nella scheda prodotto è possibile attivare un meccanismo standard per porre domande. Il cliente invia una richiesta e l’amministratore o il personale del negozio la riceve per la gestione successiva. È la forma di contatto più semplice e prevedibile.

Domande e risposte ricorrenti possono essere salvate e pubblicate come FAQ del prodotto. Le FAQ possono essere visualizzate come tab oppure come sezione separata nella pagina prodotto. In questo modo, le persone successive ricevono una risposta senza dover inviare una nuova domanda.

Sopra o sotto le FAQ standard compare un componente leggero di conversazione con AI. L’utente può:

• fare clic su una delle domande più frequenti,
• inserire la propria domanda nel campo Zapytaj Asystenta o ten produkt.,
• vedere la risposta nella stessa area di conversazione.

L’assistente non funziona come chatbot generale del negozio. È stato progettato come assistente di prodotto, il che significa che la risposta deve basarsi principalmente su:

• dati del prodotto attuale,
• FAQ pubblicate,
• cronologia della conversazione corrente,
• opzionalmente sui risultati di retrieval da OpenAI Vector Store.

Il modulo mette a disposizione un classico meccanismo di contatto con il cliente.

Elementi principali:

• pulsante o modulo Zapytaj o produkt nella pagina prodotto,
• supporto AJAX lato frontend,
• salvataggio della domanda nel database,
• possibilità di inviare una notifica e-mail,
• opzione per attivare il modulo globalmente oppure solo per prodotti selezionati.

Questa soluzione resta sensata anche quando il negozio utilizza già l’Assistente AI. Non ogni domanda dovrebbe essere gestita automaticamente. Alcune richieste richiedono una risposta commerciale, una quotazione individuale oppure una conferma da parte del team tecnico.

Le FAQ in questo modulo non sono un’aggiunta di marketing, ma un livello ordinato di conoscenza sul prodotto.

L’amministratore può:

• consultare le domande salvate,
• aggiungere risposte,
• pubblicare record selezionati,
• visualizzarli nella pagina prodotto.

Le FAQ possono essere mostrate:

• come tab,
• come sezione separata nella scheda prodotto.

È importante che le FAQ non servano solo al frontend. Le domande e risposte pubblicate vengono utilizzate anche come uno degli elementi più importanti del contesto per l’Assistente AI.

L’Assistente AI è l’elemento centrale dell’estensione del modulo.

Il componente è integrato nella scheda prodotto, per impostazione predefinita sotto la galleria, ed è stato preparato per:

• funzionare in modo leggero lato frontend,
• non appesantire inutilmente il primo rendering della pagina,
• essere leggibile su desktop e mobile,
• prestarsi a ulteriori estensioni.

L’utente vede:

• titolo della sezione,
• testo introduttivo,
• un singolo campo di testo per porre una domanda,
• elenco delle domande più popolari,
• area di conversazione che si espande con le domande e risposte successive.

Nella versione attuale il modulo supporta anche:

• cronologia della conversazione all’interno della sessione,
• domande popolari cliccabili,
• feedback sulle risposte AI,
• due varianti cromatiche: chiara e scura.

Sotto il campo di testo possono essere visualizzate le domande più popolari sul prodotto.

Questa soluzione svolge più funzioni contemporaneamente:

• accelera l’avvio della conversazione,
• suggerisce al cliente cosa chiedono più spesso gli altri,
• permette di utilizzare risposte FAQ pronte senza il costo di una richiesta al modello AI,
• migliora la UX e riduce il numero di interazioni vuote.

La popolarità delle domande non si basa più solo sull’ordine manuale. Il modulo raccoglie dati su clic, domande poste e feedback, quindi su questa base classifica le FAQ.

Il presupposto progettuale più importante era che l’AI non rispondesse separata dal prodotto.

La risposta può essere costruita sulla base di diverse fonti:

• dati di base del prodotto,
• short description,
• full description,
• attributi prodotto selezionati,
• FAQ pubblicate,
• cronologia della conversazione.

Inoltre il modulo consente di limitare quali attributi vengono inviati al modello, così da evitare:

• sovraccarico del prompt,
• invio di dati non necessari,
• costi dei token troppo elevati,
• trasmissione accidentale di contenuti non utili al cliente.

Uno degli elementi chiave dell’estensione è l’integrazione con OpenAI Responses API.

Negli scenari più semplici il modulo può funzionare in modalità di contesto locale del prodotto e delle FAQ. Nelle implementazioni più avanzate supporta:

• file_search,
• vector_store_ids,
• filtro per sku,
• filtro per product_sku,
• filtro per store_code,
• filtro per content_type,
• limitazione del numero di risultati retrieval,
• modalità hybrid,
• modalità retrieval-first.

Questo significa che la risposta AI può basarsi non solo sui dati trasmessi direttamente da Magento per una determinata request, ma anche su documenti già caricati in precedenza nel Vector Store.

In pratica offre due vantaggi:

• costo più basso, perché non è necessario inviare ogni volta al modello l’intero set di dati,
• migliore scalabilità, perché il retrieval può gestire una base di conoscenza più ampia rispetto a un semplice prompt con JSON locale.

Il modulo è stato predisposto per collaborare con Kowal_AiProductFeed.

Questa integrazione permette di:

• sincronizzare i dati prodotto con OpenAI Vector Store,
• utilizzare documenti di tipo product.core, product.faq, product.docs e altri,
• sincronizzare ulteriormente un prodotto selezionato prima della conversazione,
• limitare il retrieval a tipi specifici di contenuto.

Questo approccio è particolarmente utile dove:

• le descrizioni prodotto sono lunghe,
• le FAQ sono estese,
• il negozio gestisce molti prodotti tecnici,
• i dati prodotto vengono sviluppati costantemente.

Il modulo non si limita alla sola generazione della risposta.

Salva anche dati che consentono di valutare se la soluzione funziona:

• numero di clic nelle FAQ,
• numero di domande poste,
• valutazioni utile / non utile,
• cronologia delle conversazioni,
• metadati tecnici delle risposte AI,
• usage dei token,
• payload della request e della risposta, se attivi il logging diagnostico.

Questo fa sì che l’implementazione non sia una scatola nera. Il team può analizzare:

• quali domande compaiono più spesso,
• se l’AI utilizza il retrieval,
• se le risposte sono pertinenti,
• quali record vale la pena consolidare come FAQ,
• come cambiano costo e qualità dopo una modifica del prompt o della configurazione.

Uno dei vantaggi più importanti del modulo è la possibilità di trasformare le conversazioni in nuove FAQ.

Il processo è il seguente:

1. I clienti pongono domande.
2. Il modulo salva le conversazioni.
3. Il meccanismo di analisi individua i candidati FAQ.
4. L’amministratore esamina i candidati nel pannello.
5. Dopo l’approvazione, il candidato viene inserito nella FAQ standard del prodotto.

È un modello di lavoro molto pratico, perché la conoscenza non si perde nella cronologia delle conversazioni. A ogni iterazione successiva, il negozio costruisce un livello di risposte migliore:

• per i clienti,
• per le FAQ,
• per l’Assistente AI,
• per il retrieval futuro.

Il modulo è stato preparato in modo che il suo funzionamento possa essere controllato.

La configurazione include, tra le altre cose:

• limitazioni di accesso per gli ospiti,
• TTL delle conversazioni,
• limiti delle richieste,
• sanitizzazione dei dati di input,
• opzioni di logging diagnostico,
• configurazione reCAPTCHA,
• ambito controllato dei dati inviati al modello.

È importante, perché l’implementazione dell’AI nella pagina prodotto non dovrebbe significare perdita di controllo su:

• costo,
• dati,
• qualità delle risposte,
• carico del frontend.

Il modulo è ideale per progetti in cui:

• il catalogo è più ampio di pochi prodotti semplici,
• i clienti pongono spesso domande su compatibilità, configurazione o implementazione,
• il team vuole unire FAQ classiche a un moderno livello AI,
• l’azienda sviluppa la documentazione prodotto e vuole utilizzarla nel retrieval,
• è importante controllare cosa sa l’AI e da dove prende le risposte.

Si adatta particolarmente bene ai negozi che vendono:

• moduli Magento,
• prodotti tecnici,
• soluzioni B2B,
• strumenti che richiedono implementazione o configurazione,
• prodotti per i quali il cliente si aspetta una risposta rapida e precisa ancora prima dell’acquisto.

Kowal_ZapytajOProdukt non è più soltanto un modulo per un semplice modulo di contatto nella scheda prodotto.

È un livello completo di comunicazione di prodotto che:

• raccoglie domande,
• pubblica FAQ,
• risponde tramite AI,
• utilizza Vector Store,
• analizza le conversazioni,
• e le trasforma in una base di conoscenza del negozio sempre migliore.

Grazie a questo, la scheda prodotto diventa un luogo di reale conversazione con il cliente, non solo una pagina statica con descrizione e prezzo.

In Stores → Configuration → Zapytaj o produkt puoi iniziare dal modulo e dalle FAQ, oltre a un indirizzo e-mail aggiuntivo. Le funzioni AI si attivano separatamente: imposti provider, chiave API, modello, ambito del contesto e opzioni Vector Store. L’integrazione con Kowal_AiProductFeed è opzionale.

L’AI richiede accesso all’API e una fatturazione separata. La qualità delle risposte e il costo dipendono da contesto, modello e configurazione. Le domande che richiedono una conferma individuale possono arrivare al team del negozio tramite il modulo classico.

Il pacchetto include l’opzionale Kowal_ZapytajOProduktHyva per modulo, FAQ e assistente AI. L’adapter è disattivato per impostazione predefinita. Per Hyvä lo attivi separatamente e verifichi il posizionamento dei componenti nel tema utilizzato. Il negozio Luma utilizza il modulo di base.

Pacchetto kowal/module-zapytajoprodukt, modulo Kowal_ZapytajOProdukt. Dopo aver configurato l’accesso al repository Kowal, installa il pacchetto, attiva il modulo, aggiorna Magento e svuota la cache. In produzione, considera compilazione e deployment dei contenuti statici secondo il processo del negozio.

1. Configuri la comunicazione
Attivi il modulo, le FAQ e, opzionalmente, l’assistente AI.

2. Il cliente pone una domanda
Usa domande pronte oppure inserisce la propria.

3. Sviluppi la base di conoscenza
Rivedi le conversazioni e approvi i candidati FAQ.

Il cliente chiede informazioni sulla compatibilità del prodotto. Il supporto risponde tramite il modulo e la domanda ricorrente può essere pubblicata nelle FAQ.

L’assistente AI opzionale utilizza dati del prodotto, FAQ e Vector Store configurato. L’amministratore verifica la qualità delle conversazioni e le proposte di nuove FAQ.