Documentazione SellBot

Installa, configura e sfrutta al massimo il tuo assistente alle vendite AI.

In questa pagina

1 Installazione

Installazione con un clic dallo Shopify App Store

Apri la pagina di SellBot sullo Shopify App Store.
Clicca su "Aggiungi app" e approva le autorizzazioni minime richieste da SellBot.
Scegli un piano — inizia con Gratis, oppure scegli un livello a pagamento (Starter, Crescita o Scale). Ogni piano a pagamento parte con 14 giorni di prova gratuita.
Arriverai alla checklist di onboarding di SellBot — bastano due minuti per completarla.

Suggerimento: SellBot richiede solo le autorizzazioni read_themes, read_locales, read_products e il webhook paid-order. Nessun dato cliente, nessuna cronologia ordini.

2 Configurazione iniziale

La prima volta che apri SellBot la checklist di onboarding ti guida in quattro rapidi passaggi:

1. Abilita il widget

Attiva o disattiva il widget chat. Puoi scegliere la posizione (in basso a destra o sinistra) e uno schema colori che si abbina al tuo tema.
2. Sincronizza il tuo catalogo

SellBot importa prodotti, varianti e inventario tramite l'API di Shopify. Succede automaticamente — guarda la barra di avanzamento, nessuna azione richiesta.
3. Aggiungi le policy del negozio (opzionale)

Incolla le tue policy di spedizione, resi e FAQ così l'AI risponde correttamente alle domande sulle policy. Puoi anche inserire un link a una pagina FAQ esterna.
4. Scegli un piano

Gratis include 50 chat/mese. I livelli a pagamento usano chiavi AI gestite da SellBot con un limite mensile più alto — 500 (Starter), 3.000 (Crescita) o 10.000 (Scale). Ti serve di più? Attiva Porta-La-Tua-Chiave nella scheda Avanzate per usare le tue chiavi Claude / GPT / Gemini per chat illimitate.

3 Configurazione delle funzionalità

L'admin di SellBot è organizzato in sei schede all'interno del tuo Shopify admin — nessuna dashboard esterna, nessun login aggiuntivo.

Configurazione

Abilita il widget, scegli il modello AI e imposta i canali di passaggio.

Design

Personalizza colori, posizione del widget, avatar e messaggio di benvenuto.

Messaggi

Configura messaggi di benvenuto, fallback e fuori orario. Supporta 15 lingue.

Sistema

Aggiungi le policy del negozio, abilita i Trigger intelligenti, imposta le regole di passaggio.

Posta in arrivo

Rivedi ogni conversazione, correggi risposte errate e segnala quelle da cui SellBot deve imparare.

Statistiche

Conteggio conversazioni, valutazioni di soddisfazione, ricavi stimati attribuiti alla chat.

4 Utilizzo delle tue chiavi API

Su qualsiasi livello a pagamento puoi portare le tue chiavi API per Anthropic, OpenAI o Google dalla scheda Avanzate. Paghi direttamente il provider per l'utilizzo, le chat diventano illimitate e il tuo abbonamento SellBot resta invariato.

Dove ottenere le chiavi:

Anthropic (Claude): console.anthropic.com
OpenAI (GPT): platform.openai.com
Google (Gemini): aistudio.google.com

Come aggiungerle:

Vai su SellBot admin → Configurazione → Chiavi API.
Incolla ogni chiave nel campo corrispondente e clicca Salva.
Scegli un provider predefinito. Puoi cambiare provider per conversazione in seguito dalla Posta in arrivo.

Sicurezza: Le chiavi sono criptate a riposo con AES-256-GCM prima di essere scritte nel database. La chiave di decrittazione risiede sul server dell'applicazione e non viene mai memorizzata in modo persistente. Puoi ruotare o eliminare le chiavi in qualsiasi momento.

5 Passaggio ad agente umano

Il passaggio ad agente umano colma il divario quando l'AI non può rispondere. Ecco come funziona il flusso:

1. Lo shopper chiede un umano

Un pulsante "Parla con un umano" appare dopo ogni risposta AI a bassa confidenza. Lo shopper può anche digitare "agente" in qualsiasi momento.
2. Fallback per timeout

Se nessun agente risponde entro la finestra configurata (default 5 minuti) SellBot chiede l'email dello shopper e promette un follow-up — lo shopper non resta mai bloccato.
3. Notifica al merchant

Ricevi un'email con il contesto della conversazione così puoi rispondere anche senza accedere a Shopify.
4. Rispondi dalla Posta in arrivo

Rispondi direttamente dalla Posta in arrivo di SellBot. Lo shopper vede il tuo messaggio nella chat live; quando hai finito, l'AI riprende il controllo.

6 Trigger intelligenti

SellBot offre sette tipi di Trigger intelligenti. Quanti puoi attivarne dipende dal tuo piano — da 1 su Gratis fino a illimitati su Scale. Ognuno può essere attivato/disattivato e personalizzato dalla scheda Sistema.

Carrello inattivo

Si attiva quando uno shopper ha articoli nel carrello ma non si muove da 60 secondi. Offre aiuto o un codice sconto.

Permanenza sulla pagina

Si attiva quando uno shopper resta su una pagina prodotto per oltre 45 secondi. Invito proattivo "Domande su questo prodotto?".

Intento di uscita

Solo desktop. Si attiva quando il cursore si avvicina al pulsante chiudi/indietro. Ultima occasione per la chat.

Visitatore di ritorno

Si attiva su una visita ripetuta entro 7 giorni. Saluta lo shopper e offre di riprendere da dove aveva lasciato.

Scroll profondo

Si attiva al 75% della profondità della pagina. Perfetto per PDP lunghi o pagine collezione — intercetta gli shopper coinvolti.

Visualizzazione PDP

Si attiva alla terza pagina prodotto aperta da uno shopper in una singola sessione. Suggerisce Smart Match per aiutarli nella scelta.

Abbandono checkout

Si attiva se uno shopper visita il checkout e poi torna al negozio senza acquistare. Offre di rispondere a domande dell'ultimo minuto.

7 Risoluzione dei problemi

Il widget chat non appare sul mio negozio

Assicurati che il widget sia abilitato nella scheda Design e che il tuo tema sia Online Store 2.0. Se usi un tema personalizzato, verifica che gli embed delle app non siano disabilitati a livello di tema.

L'AI continua a dire "Non lo so"

Di solito significa che il catalogo non ha finito di sincronizzarsi, o che la descrizione del prodotto è scarna. Attendi che la barra di avanzamento della sincronizzazione sia completa, poi aggiungi policy e FAQ nella scheda Sistema così l'AI ha il contesto per rispondere.

I prezzi sono mostrati nella valuta sbagliata

SellBot utilizza Currency.Wiki in background. Installa l'app Shopify di Currency.Wiki insieme a SellBot e l'AI indicherà automaticamente i prezzi nella valuta dello shopper.

Le risposte AI sono lente

Passa a un modello più veloce in Configurazione → Modello AI (Gemini Flash è spesso il più rapido). Con Porta-La-Tua-Chiave, assicurati che le tue chiavi API abbiano abbastanza quota mensile — le richieste limitate vengono messe in coda.

L'AI consiglia i prodotti sbagliati

Apri la Posta in arrivo, trova la conversazione e clicca su "Correggi questa risposta". Scrivi la risposta corretta una volta e SellBot non ripeterà l'errore.

8 Disinstallazione e cancellazione dati

Puoi disinstallare SellBot in qualsiasi momento dal tuo admin Shopify. Ecco cosa succede:

La fatturazione si interrompe immediatamente — non ti verrà più addebitato nulla.
Shopify invia il nostro webhook shop/redact. Cancelliamo tutti i dati di merchant e shopper entro 30 giorni.
Se reinstalli in seguito, riparti da zero — nessuna conservazione nascosta delle vecchie conversazioni.

Nota: Vuoi prima i tuoi dati? Scrivi al supporto prima di disinstallare e ti invieremo un'esportazione JSON delle tue conversazioni e impostazioni.

Ancora bloccato?

Il nostro team di supporto risponde a ogni email entro un giorno lavorativo.

[email protected] Torna a SellBot