Questa è una traduzione automatica del documento originale in inglese. In caso di discrepanze tra la presente traduzione e la versione originale in inglese, prevarrà la versione inglese. Leggi la versione originale in inglese

Risoluzione dei problemi

Qualcosa non funziona? Inizia da qui.

Problemi con l'estensione del browser

L'estensione non si carica

  1. Assicurati di averla installata dal Chrome Web Store (non una versione di sviluppo)
  2. Vai su chrome://extensions e cerca messaggi di errore
  3. Prova a disabilitare e riabilitare l'estensione
  4. Riavvia completamente Chrome se il problema persiste

Il pannello laterale non si apre

  1. Clicca sull'icona di Caiioo nella barra degli strumenti (in alto a destra)
  2. Assicurati di essere su una pagina web normale (alcune pagine come le impostazioni di Chrome non consentono estensioni)
  3. Vai su chrome://extensions, trova Caiioo e clicca su "Ricarica"
  4. Prova a cliccare di nuovo sull'icona

Barra laterale vuota o corrotta dopo un aggiornamento

  • Svuota la cache del browser e ricarica l'estensione
  • Chiudi e riapri il pannello laterale
  • Se nulla aiuta, disabilita e riabilita l'estensione

Problemi di accesso

Impossibile accedere con Google / Apple / Microsoft

  1. Assicurati che il browser non blocchi i popup — OAuth richiede una finestra popup
  2. Su iOS, se l'accesso con Google si blocca, prova invece l'opzione "Accedi con Apple"
  3. Cancella i cookie per caiioo.ai e riprova
  4. Se hai cambiato password di recente, esci prima dal fornitore nel browser, poi riprova

Bloccato nella schermata di login dopo l'accesso

  • Attendi qualche secondo — l'app sta recuperando il tuo profilo
  • Se rimane bloccata, chiudi e riapri l'app (o ricarica l'estensione)
  • Assicurati che l'orologio del dispositivo sia corretto — la validazione del token OAuth fallisce se l'orario è errato

Problemi con la Chiave API

La chiave API non funziona

  1. Copia nuovamente la chiave dal sito del provider e incollala con attenzione (senza spazi iniziali o finali)
  2. Verifica che il tuo account abbia ancora crediti
  3. Prova a generare una nuova chiave e usa quella
  4. Verifica che il formato della chiave sia corretto — le chiavi OpenRouter iniziano con sk-or-

Non trovo la mia chiave API

  • OpenRouter: openrouter.ai/keys
  • Ollama: nessuna chiave necessaria — conferma che il tuo server locale sia attivo su http://localhost:11434

Consulta AI Provider e Chiavi API per maggiori dettagli.

Integrazione Google (Piano Pro)

Non riesco a connettermi a Google

  1. Vai in Impostazioni > Integrazione Google
  2. Clicca su "Accedi con Google"
  3. Assicurati di approvare tutte le autorizzazioni richieste
  4. Controlla che il tuo account risulti connesso
  5. Se ancora non funziona, disconnetti e riprova

Gli strumenti Google non funzionano

  1. Verifica che Google sia connesso (Impostazioni > Integrazione Google)
  2. Prova ad aggiornare la tua connessione Google (pulsante "Riconnetti Google")
  3. Assicurati che lo strumento specifico sia abilitato (Impostazioni > Strumenti)

Problemi con la Sincronizzazione Privata

La sincronizzazione non funziona

  1. Controlla che la sincronizzazione privata sia effettivamente abilitata (Impostazioni > Sincronizzazione Privata)
  2. Verifica che il tuo account Google sia connesso
  3. Assicurati di avere spazio di archiviazione disponibile nel tuo Google Drive
  4. Clicca su "Riconnetti Google" se il tuo token è scaduto
  5. Prova a disattivare e riattivare la sincronizzazione

I dati non si sono sincronizzati tra i dispositivi

  • La sincronizzazione privata funziona in background: attendi qualche secondo
  • Controlla di utilizzare lo stesso account Google su tutti i dispositivi
  • Assicurati che la sincronizzazione privata sia abilitata anche sull'altro dispositivo
  • Aggiorna manualmente disattivando e riattivando la sincronizzazione

Problemi di Accesso Remoto via Browser

La pagina relay.caiioo.ai/app non si connette

  • Sul tuo dispositivo principale, assicurati che Private Relay sia attivo (Impostazioni > Connessioni) e mostri "Connesso"
  • Accedi sul browser remoto con lo stesso account del tuo dispositivo principale — il relay raggiunge solo la tua istanza
  • L'estensione o l'app desktop del tuo dispositivo principale deve essere in esecuzione e online affinché il browser remoto possa controllarla
  • Al primo avvio, la pagina potrebbe mostrare un'icona di caricamento per alcuni secondi mentre stabilisce la sessione crittografata — attendi il completamento prima di ricaricare

Accesso effettuato ma la pagina remota rimane sulla schermata di login

  • Attendi qualche secondo — l'app si avvia solo una volta stabilita la sessione crittografata
  • Se rimane bloccata, conferma che il tuo dispositivo principale sia online e che Private Relay sia connesso, quindi ricarica la pagina

Problemi di prestazioni

Le risposte sono lente

  1. Controlla se il provider di IA ha problemi (controlla la loro pagina di stato)
  2. Prova a usare un modello più veloce ed economico (come Gemini Flash o Mistral)
  3. Archivia le vecchie conversazioni se ne hai centinaia
  4. Controlla la tua connessione internet

Le conversazioni richiedono un'eternità

  • L'IA sta lavorando—cerca l'indicatore di caricamento
  • Alcuni modelli sono più lenti di altri. Passa a uno più veloce se hai fretta
  • Se richiede più di qualche minuto, l'IA potrebbe essersi bloccata. Clicca su Stop e riprova

Abbonamento e fatturazione

Non riesco a vedere "Gestisci piano"

  • Assicurati di aver effettuato l'accesso con l'account che possiede l'abbonamento
  • Se ti sei abbonato su iOS, il pulsante Gestisci piano rimanda alle impostazioni degli abbonamenti Apple
  • Se ti sei abbonato sul web, rimanda al portale di fatturazione Stripe
  • Esci e rientra per aggiornare lo stato dell'abbonamento

"Gestisci piano" apre il posto sbagliato

  • Gli acquisti In-App iOS si gestiscono in Impostazioni > Apple ID > Abbonamenti — non su caiioo.ai/account
  • Gli abbonamenti Stripe si gestiscono tramite il link del portale in Impostazioni > Profilo o su caiioo.ai/account
  • Caiioo reindirizza automaticamente in base a dove ti sei abbonato: è il comportamento previsto

Aggiornato ma ancora sul vecchio livello

  • Gli aggiornamenti Stripe richiedono un minuto per propagarsi: ricarica l'app
  • Gli acquisti in-app Apple possono richiedere fino a 24 ore per la verifica. Tocca "Ripristina acquisti" in Impostazioni > Profilo per velocizzare
  • Se hai già un abbonamento su un'altra piattaforma, il pulsante Abbonati ti dirà di gestirlo lì

Altri Problemi

Schermata vuota nell'app desktop o mobile

  • Riavvia completamente l'app
  • Controlla di essere connesso a internet
  • Prova a svuotare la cache dell'app (varia in base alla piattaforma)
  • Aggiorna all'ultima versione

Gli strumenti non funzionano

  1. Vai in Impostazioni > Strumenti e controlla che lo strumento sia abilitato
  2. Alcuni strumenti richiedono permessi o configurazione (come l'integrazione Google per gli strumenti Google)
  3. Se vedi un errore "permesso necessario", riconnetti il provider in Impostazioni > Integrazione Google (o il provider corrispondente) e riapprova i permessi

L'estensione non riesce a connettersi all'app desktop

  • Se usi sia l'estensione del browser che l'app desktop, l'estensione si connette all'app desktop tramite un WebSocket locale (bridge di funzionalità, non sincronizzazione)
  • Riavvia l'app desktop e poi ricarica l'estensione
  • Assicurati che non siano in esecuzione altre copie dell'app desktop — più istanze vanno in conflitto

Avviso "Browser non connesso" su macOS anche se un browser è aperto

  • Caiioo ora riconosce Chrome, Safari, Edge e Firefox — l'avviso scompare nel momento in cui uno di essi si connette
  • Safari si connette tramite un canale diverso e può diventare brevemente inattivo quando non è l'app in primo piano; rimane connesso e Caiioo lo sveglia automaticamente quando un comando lo richiede
  • Se l'avviso persiste, porta il browser in primo piano una volta, poi riprova

Gli allegati del messaggio non vengono caricati

  • Controlla che il formato del file sia supportato (PDF, immagini, documenti Word, fogli di calcolo, presentazioni)
  • Prova con un file più piccolo
  • Assicurati di avere una connessione internet

Ottenere aiuto

  • Risposte rapide: Clicca sull'icona ? nell'intestazione
  • Impostazioni e risoluzione problemi: Clicca sull'icona dell'ingranaggio
  • Questa guida: Impostazioni > Documentazione e Legale

Vedi anche

This guide is maintained by the Caiioo team using Slate, our built-in editor.