--- title: Errori e soluzioni description: Messaggi di errore esatti visualizzati nella dashboard e la soluzione per ciascuno: chiavi Claude e Gemini, Instagram, TikTok, YouTube, Telegram, pagamento, piano tariffario e allegati. section: guide keywords: errore, non funziona, chiave rifiutata, Instagram non si connette, TikTok non funziona, agente non risponde, risoluzione problemi, problemi comuni, guida errori, Claude errore, Gemini errore, pagamento fallito, tariffa non attiva, allegati non caricati updated: 2026-09-06 --- Qui trovi i messaggi che puoi visualizzare nel pannello di controllo, con le formulazioni esatte, così puoi cercarli facilmente sulla pagina. Se il tuo caso non è qui, scrivici su Telegram e lo aggiungeremo. ## L'agente non risponde ### «L'assistente non è ancora connesso» Visibile nell'anteprima e sulla pagina dell'agente. Significa una di queste due cose: la chiave Anthropic non è stata impostata o il piano non è attivo. Cosa fare: apri «Impostazioni» → «Chiavi e modelli» e controlla la scheda Anthropic. Se vedi «non impostata», inserisci la tua chiave o attiva il piano «Tutto incluso» — le nostre chiavi funzionano con questo piano. ### «Chiave Anthropic non impostata: aggiungila in Impostazioni» Lo stesso, ma all'avvio dell'analisi delle fonti. L'analisi non inizierà finché la chiave o il piano non saranno attivi. ### «Per avviare questa operazione, attiva un piano: i primi 7 giorni sono gratuiti» Il pannello di controllo è aperto senza un piano, ma le azioni a pagamento sono bloccate: analisi delle fonti, risposte dell'agente, attivazione del widget. Clicca sul pulsante nella finestra dell'offerta — dopo l'attivazione, l'azione interrotta riprenderà automaticamente. ### «L'agente ha messo in pausa: il limite di risposte è stato esaurito per questo piano» Questo è ciò che vede il cliente. Il limite è mensile, il saldo è visibile nella pagina principale del pannello di controllo. Ci sono due soluzioni: attendere il mese successivo o passare a un piano con un limite maggiore. Con «La tua IA», la restrizione è praticamente rimossa. ## Chiavi Claude e Gemini ### «Questo è un token OAuth di Claude Code / abbonamento, non una chiave API» L'errore più comune. Il token di abbonamento Claude e la chiave API sono cose diverse. Serve la chiave da console.anthropic.com → Settings → API keys → Create key, che inizia con `sk-ant-api`. ### «Questa è una chiave API Admin, non può richiamare i modelli» La chiave è stata creata nella sezione Admin keys. Crea una chiave normale in API keys. ### «Anthropic ha rifiutato la chiave (401)» La chiave non è stata copiata per intero, è stata revocata o appartiene a un altro account. Copia di nuovo, per intero, senza spazi ai bordi. ### «La chiave non ha i permessi per i modelli (403)» I permessi della chiave sono limitati o il pagamento non è stato confermato sull'account. Verifica nella console Anthropic, sezione Billing. ### «La chiave è corretta, ma l'account Anthropic non ha fondi» Ricarica il saldo o collega una carta nella console Anthropic. Non paghiamo per i token con il piano «La tua IA» — lì il consumo è a tuo carico diretto. ### «Chiave accettata, ma il modello non è disponibile per questo account (404)» Seleziona un altro modello nel campo sottostante. L'elenco dei modelli viene caricato in base alla tua chiave. ### «Non sembra una chiave Gemini: inizia con AIza» È stata inserita la chiave sbagliata o il browser ha compilato una password salvata. La chiave si trova su aistudio.google.com/api-keys. ### «Google ha rifiutato la chiave» La chiave è stata revocata, non è stata creata in AI Studio o l'accesso all'API Gemini non è abilitato per il progetto. ## Instagram ### «Instagram non è connesso o la sessione è scaduta» La sessione ha una durata limitata e Instagram la resetta in caso di attività sospette. Accedi di nuovo nella sezione delle fonti. ### «Instagram richiede la conferma dell'accesso: inserisci il codice» Comportamento normale al primo accesso dal server. Il campo per il codice appare direttamente nel pannello di controllo, il codice arriva via SMS, email o nell'app di autenticazione. Inseriscilo entro un minuto. Se il codice non arriva o l'accesso non va a buon fine, specifica il tuo proxy nel campo «Proxy» — l'accesso avverrà da una regione abituale per l'account. ### «Il gateway Instagram non è disponibile, riprova più tardi» Un problema temporaneo da parte nostra o di Instagram. Di solito si risolve in pochi minuti; se persiste per più di un'ora, scrivici. ### «Non ci sono post nel profilo» Il profilo è privato, vuoto o Instagram non ha fornito il feed. Verifica che l'account sia pubblico e contenga pubblicazioni. ## TikTok ### «Specifica il nome del profilo TikTok: @profilo o link» Campo vuoto o errato. Sono accettati sia `@shop`, sia `shop`, sia il link completo al profilo. ### «Impossibile leggere il profilo» Il profilo è privato, è stato rinominato o TikTok non sta fornendo temporaneamente l'elenco. Verifica l'indirizzo, apri il profilo nel browser senza effettuare l'accesso — se non si apre, nemmeno l'agente potrà vederlo. ### «Il profilo non ha video pubblici, il profilo è privato o TikTok non sta fornendo temporaneamente l'elenco» Molto spesso si tratta di un blocco temporaneo della visualizzazione. Riprova tra dieci-quindici minuti. ### «Non c'è nulla di più vecchio del video N — tutto è già stato analizzato» Non è un errore, ma un messaggio di fine archivio: hai raggiunto il video più vecchio. ## YouTube ### «Specifica YouTube: @canale, link al canale, playlist o video» Campo vuoto o indirizzo non riconosciuto. Sono accettate tutte le forme: `@channel`, link al canale, playlist, singolo video. ### «Video lunghi saltati (più di 45 min)» I video più lunghi di quarantacinque minuti non vengono elaborati: il costo dell'elaborazione non è sostenibile. Nel report è visibile quanti di questi sono stati saltati. ### «Limite di analisi per avvio esaurito, video senza contenuto: N» Un singolo avvio non funziona per più di tre ore. Il resto verrà recuperato se si avvia nuovamente l'analisi in seguito. ### «Video non trascritti: chiave Gemini non impostata» Discorso e scritte nei video vengono letti da Gemini. Aggiungi la tua chiave o attiva un piano che utilizzi le nostre. ## Telegram ### «Canale non trovato o non ha un'anteprima web (canale privato)» L'agente legge solo i canali pubblici. Canali privati e gruppi non sono disponibili. ### «Il canale non ha post con testo o media» Il canale è vuoto o contiene solo inoltri da cui non c'è nulla da raccogliere. ## Pagamento e piano ### «Non hai un abbonamento Stripe — attiva un piano nella pagina dei piani» L'azione richiede un abbonamento attivo: passaggio tra piani, codice promozionale, annullamento. Attiva un piano e riprova. ### «Prima salva le chiavi Claude e Gemini» Il passaggio al piano «La tua IA» è possibile solo quando entrambe le chiavi sono state salvate e verificate. ### «Prezzo del piano non trovato in Stripe» Un errore raro da parte nostra: i prezzi non sono sincronizzati in Stripe. Scrivici, si risolve in un minuto. ### «Questo codice promozionale non esiste o non è più valido» Controlla la disposizione della tastiera e le maiuscole/minuscole. I codici promozionali possono avere una durata limitata e un numero limitato di attivazioni. ### «Verifica fallita» per la chiave Stripe o Monobank La chiave non è stata copiata per intero, è stata presa dalla modalità di test invece che da quella di produzione o è stata revocata. Per Stripe serve una chiave segreta del tipo `sk_live_`, per Monobank — il token di acquisizione dal pannello di controllo personale. ## Allegati del cliente ### «Il file supera i 20 MB: inviane uno più corto» C'è un limite per singolo allegato. Per i video, è consigliabile tagliarli o ridurne la qualità. ### «Questo tipo di file non è supportato: servono foto, video o audio» L'agente non accetta documenti, archivi o tabelle. ### «Il limite di allegati per questo piano è esaurito» Ogni allegato è conteggiato come un post analizzato. Il saldo residuo è visibile nella pagina principale dell'area personale. ## Analisi interrotta ### «Analisi interrotta (il server è stato riavviato). Avvia di nuovo» Abbiamo rilasciato un aggiornamento durante l'analisi. I progressi vengono salvati: un nuovo avvio riprenderà dal punto in cui si era interrotto, e i post già analizzati non verranno ricalcolati. ## Se nulla ha funzionato Scrivi [su Telegram](https://t.me/GuruAppSheet) e allega due cose: il testo esatto del messaggio e l'ora in cui è apparso. Con questi dati, troviamo la causa nei log in un paio di minuti. ## Domande frequenti ### Perché l'agente risponde «chiedo al proprietario» Significa che nelle tue condizioni e nel catalogo mancano i dati per la risposta. Non è un errore, ma una protezione: l'agente non inventa prezzi e tempistiche. Aggiungi le informazioni mancanti alle condizioni del negozio, e la risposta apparirà. ### L'analisi è lenta, è normale Cinquanta post richiedono tre-sei minuti, i video di più. Se il progresso non avanza per più di venti minuti, riavvia: ciò che è stato analizzato non andrà perso. ### Perché nel catalogo sono apparsi recensioni e annunci invece di prodotti Questo può succedere durante l'analisi dei post. Elimina le schede superflue nella sezione «Catalogo»: un'analisi successiva non le riporterà. Anche un audit del catalogo tramite l'agente del proprietario può essere d'aiuto. ### Dove sono finiti i miei dati dopo la cancellazione dell'abbonamento Vengono conservati per 15 giorni dopo la chiusura dell'accesso, poi eliminati. Entro questo termine, l'abbonamento può essere riattivato e tutto tornerà al suo posto.