Chat Pilot Documentation

Documentazione di Chat Pilot

Documentazione del potente assistente AI progettata per aiutarti a configurare, personalizzare e gestire Chat Pilot con facilità nel tuo negozio Shopify.

Guida iniziale e di configurazione

Benvenuti su Chat Pilot

Quando apri l'app per la prima volta, ti verrà mostrata la schermata di inizializzazione. Qui inizia il tuo percorso con l'assistente per gli acquisti basato sull'IA.

Come procedere:

  1. Esamina le informazioni sulla schermata iniziale.
  2. Fai clic sul pulsante Inizia in fondo alla finestra modale per avviare la configurazione.

Sincronizza i tuoi prodotti

Per garantire che il tuo agente AI possa rispondere con precisione alle domande dei clienti, mostrare collezioni e consigliare prodotti durante la chat, deve conoscere l'inventario del tuo negozio.

Come procedere:

  1. Clicca sul pulsante Sincronizza prodotti evidenziato al centro.
  2. Attendi qualche istante che l'app importi in modo sicuro il tuo catalogo Shopify.
  3. Una volta aggiornato lo stato della sincronizzazione, clicca su Continua per passare al passaggio successivo.

Personalizza la tua finestra di chat

Adatta l'aspetto, lo stile e il tono del tuo widget di chat all'identità del tuo brand. Le modifiche apportate qui si rifletteranno immediatamente sul tuo negozio.

Opzioni di configurazione:

  • Nome del bot: Dai alla tua IA una personalità distintiva (ad es. Assistente IA, Guida dello shop o il nome personalizzato del tuo brand).
  • Messaggio di benvenuto: Scrivi una frase di apertura accattivante per salutare i clienti quando cliccano sull'icona della chat (ad es. Ciao! Come posso aiutarti oggi?).
  • Colore del brand: Inserisci il codice colore HEX principale del tuo brand (ad es. #1D4ED8) per colorare l'intestazione del widget e le principali call-to-action.
  • Colore di sfondo: Scegli un colore di sfondo pulito per il layout principale della bolla di chat (il predefinito è #FFFFFF).

Come procedere:

  1. Compila tutti i campi relativi all'identità del brand.
  2. Clicca su Salva e continua.

Aggiungi una pagina con le informazioni sul negozio

Fornisci al tuo assistente AI un contesto immediato relativo alle regole operative del tuo negozio, ai tempi di spedizione e alle procedure standard, inserendo il link a una pagina con informazioni essenziali.

Come procedere:

  1. Individua il campo di inserimento URL della pagina web.
  2. Incolla il link a una delle pagine delle politiche attive del tuo negozio (ad esempio, https://yourstore.com/policies/returns, una pagina delle FAQ o una pagina Chi siamo).
  3. Clicca su Aggiungi e continua.
    (Nota: potrai aggiungere facilmente altre fonti alla base di conoscenza in seguito, direttamente dalla dashboard di configurazione dell'app).

Abilita sulla tua vetrina (attivazione live)

L'ultimo passaggio consiste nel rendere il widget visibile ai visitatori del tuo negozio abilitandolo nelle impostazioni del tema tramite le App Embed.

Come procedere:

  1. Clicca sul pulsante blu Abilita il widget della chat. Questo aprirà automaticamente l'editor del tema Shopify attivo in una nuova scheda del browser.
  2. L'editor del tema si aprirà con Chat Pilot pre-selezionato nella scheda App Embed nella barra laterale sinistra.
  3. Sposta l'interruttore su ON, quindi clicca su Salva nell'angolo in alto a destra dell'editor del tema Shopify.
  4. Torna alla dashboard di Chat Pilot: il tuo assistente AI è ora ufficialmente online!

Chat Pilot – Documentazione delle funzionalità e guida utente

Panoramica della dashboard

La Dashboard funge da centro di controllo principale. Ti offre una panoramica immediata delle prestazioni principali del tuo agente AI negli ultimi 30 giorni e monitora i progressi della tua checklist.

Metriche principali monitorate:

  • Conversazioni: Il numero totale di interazioni con i clienti gestite dall'IA.
  • Messaggi: Lo scambio cumulativo di singoli messaggi all'interno di quelle chat.
  • Intenti avviati: Il numero totale di volte in cui l'IA ha riconosciuto con successo un obiettivo specifico del cliente (ad esempio, tracciare un ordine o chiedere informazioni sui resi).

Da qui, puoi monitorare i passaggi di configurazione completati, visualizzare a colpo d'occhio le conversazioni recenti in corso o cliccare su Visualizza chat dal vivo / Modifica agente per apportare rapidi aggiustamenti operativi.

Configurazione e addestramento del chatbot

Nel pannello Configurazione puoi addestrare l'IA e definire come interagisce con i clienti. Questo assicura che il tuo assistente risponda in modo accurato utilizzando i dati esclusivi del tuo brand.

Funzionalità e impostazioni:

  • Stato dell'addestramento dell'IA: Visualizza una barra di stato in tempo reale che mostra l'avanzamento della sincronizzazione delle conoscenze.
  • Base di conoscenza: Gestisci gli URL e le risorse che l'IA legge. Clicca su + Aggiungi fonte per indicizzare ulteriori pagine web (come FAQ personalizzate, link al blog o pagine delle policy).
  • Flussi automatizzati: Attiva o disattiva facilmente i flussi di lavoro predefiniti per i clienti.Traccia ordine: Recupera lo stato dell'ordine in tempo reale direttamente da Shopify.Politica di reso / Cambio articoli: Guida i clienti senza interruzioni attraverso i resi o i cambi di prodotti in base alle tue linee guida.

A. Indicizzazione di una pagina web

Usa questa opzione per addestrare l'IA su un singolo layout web live (come griglie di spedizione personalizzate, tabelle di taglie standard o pagine di destinazione dinamiche e autonome).

Come aggiungere una pagina web come origine:

  1. Apri la dashboard di Configurazione e clicca sul pulsante + Aggiungi origine.
  2. Seleziona l'opzione Una pagina web nella parte superiore della finestra modale.
  3. Incolla l'URL assoluto esatto nel campo URL della pagina web (ad es. https://yourstore.com/pages/returns).
  4. (Facoltativo) Aggiungi un'etichetta riconoscibile nel campo Nome visualizzato per monitorare facilmente questa risorsa all'interno dei log di amministrazione.
  5. Clicca su Aggiungi nuova origine per avviare l'indicizzazione in background del sistema.

B. Caricamento di file PDF

Se il tuo negozio utilizza documenti statici—come manuali di prodotti all'ingrosso, lookbook del brand, schede tecniche o schede informative dettagliate e ricche di testo sulle policy—puoi caricarli direttamente.

Come aggiungere una fonte PDF:

  1. All'interno del menu di selezione modale, passa all'opzione PDF.
  2. Fai clic all'interno dell'area di rilascio per il file PDF denominata "Fai clic per scegliere un PDF".
  3. Seleziona e carica il file .pdf desiderato (assicurati che il documento sia caricato nella directory File del tuo Shopify per una lettura continua dei dati).
  4. Fornisci un titolo descrittivo nel campo Nome visualizzato in modo da poter gestire o eliminare il documento in seguito.
  5. Fai clic su Aggiungi nuova fonte per incorporare le informazioni del documento nel motore principale dell'IA.

C. Coppie di domande e risposte manuali (stile FAQ)

Per richieste specifiche e prevedibili dei clienti che richiedono risposte precise del brand (ad esempio codici sconto precisi, slogan del brand o orari personalizzati del negozio), utilizza blocchi strutturati di domande e risposte.

Come creare coppie di domande e risposte manuali:

  1. Seleziona la scheda stile FAQ all'interno del layout della finestra modale della sorgente.
  2. Assegna alla tua raccolta un nome di intestazione di categoria chiaro nel campo di input Nome visualizzato (ad esempio, FAQ sulla spedizione).
  3. Sotto il blocco COPPIA 1, digita la richiesta prevista del visitatore all'interno del contenitore di testo DOMANDA.
  4. Redigi la politica di risposta esatta che desideri che l'agente AI enunci parola per parola all'interno del campo RISPOSTA.
  5. Per creare più risposte contemporaneamente, clicca sul link + Aggiungi coppia di domande e risposte in basso per aprire un nuovo blocco di coppia vuoto.
  6. Una volta terminato di creare il tuo database di richieste, clicca su Aggiungi nuova sorgente per pubblicarli.

Gestione del catalogo prodotti

La scheda Prodotti mostra il tuo database dell'inventario Shopify completamente integrato, consentendoti di controllare quali prodotti il tuo agente AI consiglia ai clienti durante la chat.

Metriche delle prestazioni del catalogo:

  • Totale prodotti: Il totale dei tuoi prodotti attivi attualmente disponibili su Shopify.
  • Indicizzati: Articoli completamente analizzati, compresi e pronti per la ricerca e la raccomandazione tramite AI.
  • Esauriti: Prodotti che vengono automaticamente esclusi dalle raccomandazioni per evitare esperienze negative ai clienti.
  • Fissati / Esclusi: Sovrascritture personalizzate del commerciante per mettere in evidenza o nascondere manualmente i prodotti.

Azioni di massa:

  • Usa Seleziona prodotti per curare manualmente gli articoli.
  • Usa Importa tutto per avviare una sincronizzazione manuale del tuo catalogo prodotti in qualsiasi momento.

Aspetto avanzato del widget

Personalizza con precisione il design visivo e il layout della chat box visibile ai clienti nel pannello Aspetto.

Strumenti di personalizzazione:

  • Identità del bot: Aggiorna il nome ufficiale del bot e il messaggio di benvenuto personalizzato.
  • Impostazioni colore: Imposta codici esadecimali personalizzati per il Colore principale del brand e lo Sfondo del widget.
  • Tipografia: Modifica le famiglie di font (ad es. Inter) e le dimensioni base del carattere (14 px) per adattarle al design del tema del tuo negozio.
  • Anteprima in tempo reale: Un elemento di anteprima dinamico sul lato destro si aggiorna in tempo reale mentre modifichi le configurazioni, mostrando esattamente ciò che vedranno i clienti prima di salvare.

Posta in arrivo della chat dal vivo e banchi di assistenza

La scheda Posta in arrivo offre una visione diretta delle interazioni in tempo reale con i clienti. Consente al personale di assistenza umana di monitorare le conversazioni o di intervenire quando è necessario un tocco personale.

Funzionalità principali della Posta in arrivo:

  • Profilo dell'operatore: Clicca su Modifica profilo operatore per impostare un nickname pubblico amichevole per gli operatori di assistenza umana.
  • Filtri dello stato della conversazione: Filtra rapidamente i ticket di assistenza per stato: Aperto, In sospeso, Risolto, Chiuso o Non letto.
  • Barra laterale della chat dal vivo: Visualizza le conversazioni attive dei clienti con tag corrispondenti alle categorie di intenzione (ad es. Tracciamento ordini, Sconto prezzi), insieme al monitoraggio del tempo trascorso dall'ultimo messaggio.

Dettagli della conversazione e intervento umano

1. Seleziona una conversazione attiva

Nella colonna delle conversazioni, scegli una sessione contrassegnata con un'etichetta di stato attivo (ad es. Aperta). Cliccando su una sessione, la finestra principale dello spazio di lavoro a destra viene immediatamente popolata con la trascrizione completa dei messaggi.

2. Esamina i tag contestuali dell'intento dell'IA

I registri della chat suddividono chiaramente i dettagli della conversazione, mostrando i timestamp esatti e i tag contestuali (come Tracciamento ordini o Sconto prezzi) che identificano l'oggetto della richiesta del cliente prima che tu risponda.

3. Usa il campo di risposta manuale

In fondo alla finestra della conversazione si trova il blocco di testo Rispondi come:

  • Digita la tua risposta personale o una soluzione personalizzata all'interno del campo.
  • Premi Ctrl + Invio (o Cmd + Invio su Mac) per inviare istantaneamente il tuo messaggio al widget del negozio.

⚠️ Nota importante sul comportamento dell'IA: L'invio di una risposta testuale manuale sospende automaticamente l'agente IA per quella specifica conversazione con il cliente. Ciò garantisce che il bot automatizzato non interrompa o sovrascriva il flusso della conversazione umana.

4. Risoluzione e chiusura dei ticket

Una volta risposto completamente alla domanda del cliente, utilizza le azioni di gestione in alto a destra:

  • Clicca su Risolvi o Chiudi per archiviare la sessione e rimuoverla dalla coda attiva delle conversazioni non lette della dashboard.
  • Clicca sull'icona Aggiorna/Ripristina per cancellare le variabili locali della sessione, se necessario.

Analisi e report

L'area di lavoro Analisi e report monitora i dati di conversione, le tendenze delle prestazioni e i vettori del sentiment dei clienti.

Dettaglio delle analisi:

  • Esportazione dati: Clicca su Esporta dati nell'angolo in alto a destra per scaricare metriche dettagliate sulle conversazioni e sulle intenzioni in un file Excel o CSV.
  • Tendenze delle chat nel tempo: Un grafico cronologico visivo che monitora i cali e i picchi del coinvolgimento complessivo dei clienti su filtri personalizzati di 30 giorni.
  • Principali richieste dei clienti: Una barra percentuale dei dati che illustra esattamente ciò che interessa di più ai tuoi clienti (ad es. Domande sui prodotti, Tracciamento ordini, Sconti sui prezzi).

Impostazioni account

La visualizzazione Impostazioni consente di gestire in modo sicuro i livelli di fatturazione, i dati di integrazione e il ripristino del sistema.

Sezioni della dashboard:

  • Informazioni sull'account: Visualizza l'identificatore principale del dominio del tuo negozio e registra un'email di assistenza dedicata.
  • Livello del piano: Monitora i tuoi limiti di volume (ad es. Piano gratuito – Fino a 100 conversazioni al mese). Clicca su Gestisci piano per aumentare le tue soglie di volume.
  • Integrazioni: Conferma le connessioni API attive con Shopify o attiva Passaggio alle email per inoltrare automaticamente le segnalazioni complesse a una casella di posta di assistenza condivisa.
  • Zona di pericolo: Accedi allo strumento Ripristina configurazione iniziale per eliminare le variabili di configurazione locali e riavviare da zero la procedura guidata di configurazione iniziale dell'app.

Hub integrato di aiuto e assistenza

La scheda centralizzata Aiuto e supporto funge da centro di riferimento ad accesso rapido, indirizzandoti direttamente alle dashboard specifiche del backend per risolvere istantaneamente i problemi.

Mappa di navigazione per la configurazione rapida:

  1. Installa e connetti il negozio: Verifica della connessione automatica principale con Shopify.
  2. Configura il tuo agente AI: Pulsante di accesso diretto al portale per la dashboard Configurazione.
  3. Importa il catalogo prodotti: Vai direttamente alla griglia dei prodotti indicizzati (Vai a Prodotti).
  4. Personalizza il widget di chat: Accesso immediato alla formattazione del carattere e della palette del brand (Vai a Aspetto).
  5. Abilita il widget nel tuo tema: Link diretto per tornare al layout principale di attivazione (Vai alla Dashboard).
  6. Monitora conversazioni e analisi: Apri istantaneamente la coda di risposta della chat dal vivo (Vai alla Posta in arrivo).