--- title: Glossario: significato dei termini nell'interfaccia description: Definizioni brevi dei termini di Commerce Agents: dall'agente e dal catalogo alle modifiche staged, ai limiti, ai pixel e a BYOK. Per chi non vuole affidarsi al contesto. section: guide keywords: glossario Commerce Agents, termini Commerce Agents, cos'è un agente AI, catalogo prodotti AI, gestione lead AI, BYOK significato, PWA Commerce Agents, webhook spiegazione, pixel tracciamento, modifiche staged, Commerce Agents glossario, terminologia AI sales, agente conversazionale termini, vocabolario Commerce Agents updated: 2026-09-06 --- Glossario di una pagina. I termini sono in ordine alfabetico, le definizioni sono brevi: una o due frasi e un link a un'analisi dettagliata, se disponibile. ## Agente Un programma che gestisce la conversazione con il cliente: comprende la domanda, trova la risposta nel tuo catalogo e nelle tue condizioni, mostra i prodotti, raccoglie l'ordine e accetta il pagamento. A differenza di un bot con pulsanti, agisce in base alla situazione, non seguendo un albero di scenari predefinito. ## Agente del proprietario Il secondo agente nell'area personale, che lavora con te e non con i clienti: calcola le statistiche, cerca lacune nel catalogo e propone modifiche. Maggiori dettagli — [Agente del proprietario](/wiki/it/owner-agent). ## Audit del catalogo Una verifica delle schede prodotto per assenza di prezzo, descrizione, foto e categoria, duplicati e nomi strani. Si avvia con il pulsante nella sezione «Catalogo». ## Widget La finestra di chat nell'angolo del tuo sito, che si installa con una singola riga di codice. Maggiori dettagli — [Widget e link](/wiki/it/widget). ## Vetrina Il tuo negozio all'interno del servizio: catalogo, condizioni, configurazione dell'agente e indirizzo della pagina. Un account ha una sola vetrina. ## Allegato Una foto, un video o un messaggio vocale che il cliente ha inviato in chat. Viene analizzato da Gemini: l'agente vede cosa viene mostrato e cosa viene detto. ## Webhook Un messaggio che il sistema di pagamento invia al nostro server quando un cliente ha pagato un ordine. La firma viene verificata, quindi non è possibile falsificare la notifica di pagamento. ## Analisi approfondita Una modalità di analisi dei social media in cui i video vengono scaricati e ascoltati. Più costosa in termini di limiti, ma estrae prezzi e dettagli menzionati a voce. L'opposto è l'analisi rapida, che legge solo le didascalie. ## Richiesta Un record su un cliente che ha lasciato un contatto, ha iniziato la procedura d'ordine o ha acquistato. Si trova nella sezione «Richieste», ha un tipo e uno stato. ## Fonte del catalogo Il luogo da cui l'agente preleva i prodotti: sito web, Instagram, TikTok, YouTube o canale Telegram. Maggiori dettagli — [Connessione fonti](/wiki/it/sources). ## Catalogo Un elenco di schede di prodotti e servizi con nomi, prezzi, descrizioni e fotografie. Viene compilato automaticamente dalle fonti, modificato manualmente o tramite file. ## Chiave API Una stringa tramite cui il servizio accede al modello per tuo conto. La chiave Anthropic (Claude) gestisce le conversazioni, la chiave Google Gemini si occupa dell'analisi di video e allegati. Sono conservate in forma crittografata. ## Limite Una restrizione sul volume mensile: quanti post e minuti di video possono essere analizzati e quante risposte darà l'agente. Dipende dal piano tariffario, il saldo è visibile nella pagina principale dell'area personale. ## Copertina di anteprima L'immagine che viene mostrata quando il link all'agente viene inviato in un'app di messaggistica. Viene generata automaticamente dal logo, dal colore e dalle foto dei prodotti, oppure puoi caricarne una tua. ## Pixel Un contatore del sistema pubblicitario: Meta, TikTok o Google. Si imposta nelle impostazioni e invia eventi dalla tua pagina agente: visualizzazione, aggiunta al carrello, richiesta. Necessario per il retargeting. ## Codice promozionale Un codice che riduce il costo dell'abbonamento o offre accesso gratuito. Si inserisce nella finestra dell'offerta del piano tariffario o nella pagina «Tariffa». ## Segnale Un'indicazione nel dialogo che il cliente ha fatto qualcosa di importante: ha scritto di un acquisto, ha lasciato il telefono, ha chiesto il prezzo, è arrivato alla fase di checkout. Lo stato del cliente si compone di questi segnali. ## Slug L'indirizzo breve della tua vetrina nel link all'agente, ad esempio `shop-a1b2c3` in `comag.vibevox.pro/c/shop-a1b2c3`. Si forma dal nome del negozio. ## Condizioni del negozio Il testo su spedizione, pagamento, resi, garanzia e registrazione — l'unica fonte da cui l'agente risponde a domande sulle condizioni. Ciò che non è scritto, non lo prometterà. ## Baseline: modifiche in staging Modifiche al catalogo che l'agente del proprietario ha preparato ma non ha applicato. Aspettano il tuo pulsante «Applica». Il meccanismo protegge da errori di massa nei prezzi. ## BYOK Dall'inglese bring your own key — «con la tua chiave». Da noi è il piano tariffario «La tua IA»: l'agente lavora con le tue chiavi Claude e Gemini, l'abbonamento costa meno, i token li paghi direttamente. ## GDPR Il regolamento europeo sulla protezione dei dati personali. Nel servizio, a esso corrispondono il banner di consenso, i pixel disattivati fino al consenso e il link alla tua politica sulla privacy. ## PWA Una tecnologia grazie alla quale la pagina dell'agente si installa sul telefono del cliente come un'applicazione: icona con il tuo logo, modalità a schermo intero e notifiche push. ## Notifica push Un messaggio che arriva sul telefono del cliente, anche quando la chat è chiusa. Si invia manualmente dal dialogo: immediatamente o secondo una programmazione. ## Domande frequenti ### Qual è la differenza tra catalogo e vetrina La vetrina è l'intero tuo negozio nel servizio, comprese le impostazioni e la configurazione. Il catalogo è solo l'elenco di prodotti e servizi al suo interno. ### Cosa è più importante: il catalogo o le condizioni Le condizioni. L'agente compilerà il catalogo dai tuoi post, ma nessuno scriverà le condizioni: spedizione, pagamento e resi li prenderà esclusivamente dal tuo testo. ### Ho bisogno di una chiave Gemini se non giro video Sarà utile per gli allegati: i clienti inviano foto e messaggi vocali, ed è Gemini a elaborarli. Con il piano «Tutto incluso» non serve una chiave, usiamo le nostre.