Errori e soluzioni
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.
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 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.