Olvio risponde ai tuoi acquirenti con i modelli Claude di Anthropic, usando la tua chiave API Anthropic. Anthropic fattura direttamente al tuo account Anthropic le richieste che Olvio effettua con la chiave, separatamente dal tuo piano Olvio.

La pagina Chiave API compare nel menu dell'app dopo che hai scelto un piano. Se la guida alla configurazione è ancora visibile nella Dashboard (clicca su Olvio nel menu dell'app), il suo passaggio Aggiungi la tua chiave API Anthropic rimanda alla pagina con Aggiungi chiave. Una volta salvata una chiave, il passaggio viene spuntato e il suo pulsante diventa Gestisci chiave.

Se dai alla chiave una data di scadenza, sostituiscila in Olvio prima di quella data. Anthropic rifiuta le chiavi scadute e Olvio non può rispondere agli acquirenti finché non ne connetti una nuova. Anthropic invia un'email a chi ha creato la chiave prima della scadenza, a meno che la chiave non sia stata creata con una durata inferiore a 7 giorni.

A meno che Anthropic non fatturi mensilmente la tua organizzazione, l'utilizzo dell'API Claude si paga con crediti prepagati. Prima di salvare la chiave in Olvio, assicurati che la tua organizzazione abbia dei crediti. In caso contrario, accedi alla Claude Console con un ruolo Admin o Billing, apri Settings → Billing e clicca su Buy credits. Senza crediti, Anthropic rifiuta la richiesta di test di Olvio e la chiave non può essere salvata. Per evitare che il saldo si esaurisca, clicca su Edit nella sezione Auto-reload e attiva l'opzione.

Prima di salvare, Olvio rimuove spazi, interruzioni di riga, caratteri invisibili e virgolette tipografiche, e trasforma i trattini lunghi in trattini normali. Questi caratteri possono infilarsi quando una chiave viene copiata da un documento formattato. Poi verifica la chiave inviando ad Anthropic una richiesta di test molto piccola con il modello selezionato, che Anthropic fattura come qualsiasi altra richiesta.

Se la verifica va a buon fine, Olvio cifra e salva la chiave. Vedi Impostazioni salvate, il campo si svuota e il badge Stato passa da Non configurata a Connessa. Connessa significa solo che una chiave è salvata. La pagina non verifica di nuovo la chiave con Anthropic, quindi il badge mostra ancora Connessa se in seguito la chiave scade, il saldo dei crediti si esaurisce o viene raggiunto il tuo limite di spesa Anthropic. Scarta cancella ciò che hai digitato e riporta il modello al valore salvato.

Quando una verifica non riesce, non viene salvato nulla e Olvio mostra brevemente un messaggio di errore in fondo alla pagina. Se scompare prima che tu riesca a leggerlo, clicca di nuovo su Salva nella barra di salvataggio. Tra i messaggi che potresti vedere:

Per gli altri messaggi e le soluzioni passo passo, consulta Errore "Invalid Anthropic key" al salvataggio.

Il menu Modello Claude offre tre modelli: Claude Haiku 4.5 — il più veloce, costo più basso (consigliato), Claude Sonnet 5 — equilibrio tra qualità e costo e Claude Opus 5 — migliore qualità, costo più alto. Come indica la pagina, il modello selezionato viene utilizzato per ogni chat, suggerimento e turno dell'advisor. Anthropic fattura ogni richiesta alla tariffa del modello utilizzato; consulta i prezzi di Anthropic.

Per cambiare, seleziona un altro modello e clicca su Salva. Olvio verifica prima la chiave salvata con il nuovo modello, quindi non devi incollare di nuovo la chiave. Se non hai ancora salvato una chiave, incollane una prima di salvare. Per scegliere un modello e capire a cosa serve, consulta Scegli il tuo modello Claude.

Anthropic ti permette di fissare un tetto alla spesa mensile per l'API, così sei protetto se un periodo intenso porta più conversazioni del previsto.

Quando l'utilizzo raggiunge il limite, Anthropic rifiuta le nuove richieste fino alla data indicata, o finché non aumenti o rimuovi il limite. Durante questo periodo Olvio non può rispondere agli acquirenti, quindi lascia un certo margine. Olvio smette di rispondere anche se il saldo dei crediti si esaurisce prima che venga raggiunto il limite. Puoi seguire l'utilizzo nella pagina Usage della Claude Console, e Cosa usa la tua chiave API di Anthropic e cosa no elenca gli usi che Olvio fa della chiave.

Sostituisci la chiave quando ne crei una nuova, ad esempio dopo averla ruotata o quando passi a un altro account Anthropic.

Olvio verifica la nuova chiave con Anthropic prima di salvarla. Se la verifica va a buon fine, la nuova chiave sostituisce quella vecchia e il tuo negozio online la usa entro circa un minuto. Se non riesce, la chiave attuale resta al suo posto. Quando la nuova chiave funziona, puoi disattivare o eliminare quella vecchia nella Claude Console.

Clicca su Elimina chiave nella pagina Chiave API. Il pulsante compare solo quando c'è una chiave salvata e non c'è alcuna richiesta di conferma: la chiave viene rimossa immediatamente, vedi Chiave rimossa e lo stato torna a Non configurata. La scelta del modello viene mantenuta per quando connetterai di nuovo una chiave.

Senza chiave, Olvio non può rispondere agli acquirenti. La modifica ha effetto sul tuo negozio online entro circa un minuto. Il widget continua a comparire nelle tue pagine prodotto, ma senza domande suggerite, e ogni messaggio riceve la risposta Siamo spiacenti, si è verificato un errore. Riprova. (o la sua traduzione su un negozio online in un'altra lingua). Nei piani Growth e Scale, anche Olvio Advisor non può rispondere.

Eliminare la chiave in Olvio non la revoca presso Anthropic. Se non ti serve più, disattivala o eliminala nella Claude Console.

Olvio cifra la tua chiave con AES-GCM (256 bit) prima di archiviarla, legandola al dominio del tuo negozio in modo che la chiave cifrata non possa essere usata per un altro negozio. La chiave non viene mai più mostrata: il campo Chiave API mostra dei puntini al suo posto. Quando disinstalli Olvio, la chiave viene eliminata insieme al resto dei dati del tuo negozio circa 48 ore dopo. Per saperne di più, consulta Come viene cifrata la tua chiave API Anthropic.