Guida alla risoluzione dei problemi 🛠️
ChatGPT 
Claude 
AI Mode 
Perplexity Questa guida ti aiuta a risolvere i problemi più comuni che puoi incontrare usando l'app NutriScan. Se hai un problema, trova qui sotto la sezione che fa al caso tuo.
Soluzione rapida per la maggior parte dei problemi
Prima di provare soluzioni specifiche, fai questi tre passaggi:
- Riavvia l'app
- Aggiorna all'ultima versione
- Riavvia il dispositivo
Problemi di avvio e configurazione 📱
Problemi con la schermata iniziale
| Problema | Possibili soluzioni |
|---|---|
| L'app resta bloccata sulla schermata iniziale | • Aspetta 30 secondi • Chiudi l'app a forza e riaprila • Controlla se ci sono aggiornamenti • Verifica che il dispositivo abbia spazio sufficiente |
| La schermata iniziale personalizzata non compare | • Controlla la connessione a internet • Gli aggiornamenti da Firebase possono arrivare in ritardo • Prova a riavviare l'app |
Problemi con l'introduzione
- Non riesco ad andare oltre l'introduzione: scorri tutte le schermate fino in fondo oppure tocca "Salta", se disponibile
- L'introduzione non compare dopo una nuova installazione: reinstalla l'app o cancella i dati dell'app
Problemi generali di prestazioni
App lenta o che non risponde
- Controlla la connessione: assicurati che la rete sia stabile. Passa dal Wi-Fi ai dati mobili per fare una prova.
- Riavvia l'app: chiudila del tutto e riaprila.
- Aggiorna l'app: verifica di usare l'ultima versione disponibile nell'App Store o nel Play Store.
- Svuota la cache: vai nelle impostazioni del telefono e svuota la cache dell'app, se l'opzione è disponibile.
- Reinstalla: se il problema continua, disinstalla e reinstalla l'app.
- Controlla lo spazio sul dispositivo: poco spazio può rallentare l'app, libera memoria se serve.
- App in background: chiudi le altre app che consumano molte risorse.
Arresti anomali ed errori imprevisti
- Forza l'arresto: usa il gestore attività del dispositivo per forzare l'arresto dell'app, poi riavviala.
- Segnala l'errore: annota i messaggi di errore che compaiono e segnalali con il modulo di feedback nell'app.
- Compatibilità del dispositivo: controlla che il dispositivo rispetti i requisiti minimi di sistema (Android 12+ o iOS 13+).
- Aggiorna il sistema operativo: assicurati che il sistema operativo sia aggiornato.
- Problemi di memoria: prova a liberare RAM chiudendo le altre app.
Problemi con la versione dell'app
Se nella schermata Home vedi una notifica di download per una nuova versione dell'app:
- Tocca il pulsante di download per essere indirizzato all'App Store o al Play Store
- Per gli aggiornamenti tramite patch Shorebird, segui le indicazioni oppure riavvia l'app
Problemi con le autorizzazioni 🔒
Problemi comuni con le autorizzazioni
| Autorizzazione | Problemi | Soluzioni |
|---|---|---|
| Fotocamera | • La scansione non funziona • Schermata nera quando scatti una foto | • Vai su Impostazioni > App > NutriScan > Autorizzazioni > Fotocamera > Consenti • Riavvia l'app dopo aver attivato l'autorizzazione |
| Foto | • Non riesco ad accedere alla galleria • Non riesco a salvare le immagini dei pasti | • Verifica che l'autorizzazione a Foto/Archiviazione sia concessa • Su iOS, controlla l'accesso "Lettura e scrittura" |
| Posizione | • Accesso con numero di cellulare non disponibile • Le analisi sulla mappa non compaiono • Mappa della città mancante | • Attiva la posizione precisa nelle impostazioni del dispositivo • Va concessa per l'accesso con numero di cellulare in India • Necessaria per la mappa della città nelle analisi |
| Microfono | • L'input vocale non funziona • L'assistente IA Monika non risponde | • Controlla che l'autorizzazione al microfono sia attiva • Prova il microfono con un'altra app per assicurarti che funzioni |
| Notifiche | • Avvisi mancanti • Nessuna notifica dei referral | • Controlla le impostazioni delle notifiche sia del dispositivo sia dell'app • Su iOS, verifica che le notifiche siano consentite in Impostazioni |
| Monitoraggio attività (iOS) | • Esperienza meno personalizzata | • Vai su Impostazioni iOS > Privacy > Tracciamento • Attiva "Consenti alle app di richiedere di tracciarti" |
Autorizzazione negata
Se hai negato un'autorizzazione e l'app non te la chiede più:
- Vai nelle impostazioni del dispositivo
- Trova NutriScan nell'elenco delle app
- Apri Autorizzazioni
- Attiva a mano ogni autorizzazione necessaria
Problemi di accesso e account 🔑
Problemi di accesso
Problemi con l'accesso tramite numero di cellulare
L'opzione non è visibile:
- Verifica di aver concesso l'autorizzazione alla posizione (necessaria per rilevare la posizione in India)
- Controlla di trovarti fisicamente in India, perché questo metodo di accesso è limitato per area geografica
Non ricevo l'OTP:
- Controlla di aver inserito il numero correttamente, con il prefisso internazionale giusto
- Verifica la connessione (prova a passare dal Wi-Fi ai dati mobili o viceversa)
- Usa "Invia di nuovo OTP" quando il conto alla rovescia termina
- Controlla che la casella degli SMS non sia piena
- Assicurati che il tuo operatore non blocchi gli SMS di verifica
Il riempimento automatico dell'OTP non funziona:
- Su Android: controlla che le autorizzazioni dell'API SMS Retriever siano attive
- Su iOS: assicurati che il riempimento automatico da SMS sia attivo nelle impostazioni
- Se il riempimento automatico non funziona, inserisci il codice a mano
Problemi con l'accesso tramite Google o Apple
L'accesso con Google non funziona:
- Verifica di avere una connessione a internet funzionante
- Aggiorna Google Play Services
- Controlla che l'account Google sia configurato correttamente sul dispositivo
- Esci dal tuo account Google sul dispositivo e rientra
L'accesso con ID Apple non funziona:
- Verifica di usare iOS 13 o successivo
- Controlla che l'ID Apple sia configurato correttamente in Impostazioni
- Aggiorna all'ultima versione di iOS
- Esci dal tuo ID Apple e rientra
L'app non ricorda il metodo di accesso:
- Se l'app non ricorda il metodo di accesso, svuota la cache dell'app e riprova
- Assicurati di aver completato l'accesso almeno una volta fino in fondo
Problemi con il profilo
- Non riesco ad aggiornare il profilo: esci e rientra, poi prova a modificarlo di nuovo
- Le modifiche non vengono salvate: assicurati di avere una connessione a internet stabile mentre aggiorni il profilo
- Le preferenze alimentari non vengono applicate: completa l'invio del modulo toccando "Salva"
Problemi con l'abbonamento 💳
Problemi con i pagamenti
- Problemi con la verifica del pagamento:
- Assicurati che i dati del metodo di pagamento siano validi
- Controlla se la tua banca richiede una verifica aggiuntiva
- Alcuni metodi di pagamento potrebbero non supportare le autorizzazioni per gli abbonamenti
Schermate di stato del pagamento
- Schermata di successo: puoi usare le funzioni Premium
- Schermata di attesa: aspetta fino a 15 minuti per il completamento dell'elaborazione
- Schermata di errore: annota il codice dell'errore e prova con un altro metodo di pagamento
Gestione dell'abbonamento
| Problema | Soluzione |
|---|---|
| Non riesco a passare a un altro piano | • Controlla la connessione a internet • Verifica che il metodo di pagamento sia valido • Prova con un altro metodo di pagamento |
| Il piano non si attiva dopo il pagamento | • Aspetta 15 minuti per l'elaborazione • Controlla se hai ricevuto l'email di conferma • Contatta l'assistenza con i dettagli della transazione |
| Annullare l'abbonamento | • Vai su Profilo > Gestisci abbonamento > Annulla abbonamento • Concludi la procedura nell'App Store o nel Play Store |
| Cambiare tipo di piano | • Vai su Profilo > Gestisci abbonamento • Scegli il nuovo piano e conferma |
Problemi con la scansione e l'analisi dei pasti 📸
Problemi con fotocamera e scansione
Problemi con lo scatto delle foto
La fotocamera non si avvia:
- Controlla che l'autorizzazione alla fotocamera sia concessa
- Riavvia l'app e riprova
- Assicurati che un'altra app non stia usando la fotocamera
Lo scatto non riesce:
- Libera spazio sul dispositivo
- Assicurati che l'obiettivo della fotocamera sia pulito
- Prova con una luce migliore
Problemi con la schermata di ritaglio:
- Se i comandi di ritaglio non rispondono, riavvia l'app
- Usa il pulsante per scattare di nuovo se la qualità dell'immagine è scarsa
- L'input di testo o audio non funziona? Controlla le autorizzazioni corrispondenti
Errori di elaborazione
Errore "Non è un alimento":
- Assicurati che nell'immagine ci sia chiaramente del cibo
- Migliora l'illuminazione e riprova
- Evita impiattamenti astratti
Errore JSON o errore di rete:
- Controlla la connessione a internet
- Prova a passare dal Wi-Fi ai dati mobili o viceversa
- Ripeti la scansione dopo qualche minuto
Filtro dei contenuti del modello linguistico attivato:
- Assicurati che l'immagine del cibo non contenga contenuti inappropriati
- Prova a scansionare i singoli alimenti invece del pasto completo
Tempi di elaborazione lunghi:
- Controlla la velocità della tua connessione
- I pasti grandi e complessi possono richiedere più tempo per l'analisi
- Annulla e riprova con un'immagine più chiara e semplice
Risultati migliori con la scansione
- Usa una buona illuminazione (la luce naturale del giorno funziona meglio)
- Scatta le foto direttamente dall'alto
- Assicurati che tutti gli alimenti siano visibili e riconoscibili
- Per i piatti misti, quando puoi, separa i vari alimenti
Problemi con i dettagli nutrizionali
Valori nutrizionali imprecisi:
- Usa la funzione di modifica per correggere le porzioni
- Aggiungi a mano gli alimenti mancanti
- Rimuovi gli alimenti sbagliati
Non riesco a modificare il titolo o il nome del pasto:
- Assicurati di toccare direttamente il campo del nome
- Controlla di avere una connessione a internet stabile
Non riesco a condividere lo screenshot:
- Verifica di aver concesso all'app l'autorizzazione a condividere contenuti
- Prova prima a salvare l'immagine, poi condividila dalla galleria
Micronutrienti mancanti:
- Per impostazione predefinita l'app mostra solo i primi 4 micronutrienti
- Tocca "Dettaglio nutrizionale e altre domande" per vedere tutti i valori
Le domande sul NutriScore non funzionano:
- Assicurati di avere una connessione a internet attiva
- Prova ad aggiornare la pagina o a riavviare l'app
Problemi con NutriBites e l'assistente IA 🤖
Problemi con NutriBites
| Problema | Soluzione |
|---|---|
| La schermata introduttiva non compare | • Compare solo la prima volta • Se serve, prova a cancellare i dati dell'app |
| Le domande non funzionano | • Controlla la connessione a internet • Assicurati di aver scansionato almeno un pasto |
| L'input vocale non rileva la voce | • Verifica l'autorizzazione al microfono • Parla chiaramente, vicino al dispositivo • Se la voce non funziona, prova a scrivere |
| Le schede dei pasti non compaiono | • Assicurati di avere uno storico dei pasti • Prova a fare domande specifiche sui pasti che hai registrato |
| Non riesco ad aprire i dettagli del pasto | • Tocca direttamente l'immagine della scheda del pasto • Prova a vedere il pasto dalla cronologia nella schermata Home |
Problemi con l'assistente IA Monika
Il pulsante di chiamata non funziona:
- Il piano Free include 4 chiamate a Monika a settimana; se le hai esaurite, la prossima chiamata si riapre dopo il reset settimanale (Premium non ha limiti)
- Controlla che l'autorizzazione al microfono sia concessa
- Riavvia l'app se il pulsante non risponde
Monika non risponde:
- Controlla la connessione a internet
- Parla chiaramente e aspetta l'elaborazione
- Se ancora non funziona, riavvia l'app e riprova
Le domande su pasti specifici non funzionano:
- Cerca di essere più preciso su quale pasto intendi
- Indica nella domanda la data o l'orario del pasto
- Assicurati di aver registrato dei pasti a cui l'IA possa fare riferimento
Problemi con il piano alimentare 🍽️
Funzione Premium
Il piano alimentare è disponibile solo con un abbonamento Premium. Prima di cercare una soluzione, assicurati che l'abbonamento sia attivo.
Problemi con la creazione del piano alimentare
Problemi con l'invio del modulo
Non riesco a completare il modulo:
- Assicurati di aver compilato tutti i campi obbligatori
- Ogni passaggio deve essere convalidato prima di proseguire
- Se ti blocchi su una schermata, torna indietro e inserisci di nuovo i dati
I dati del modulo non vengono salvati:
- Controlla la connessione a internet
- I dati dovrebbero salvarsi in automatico mentre procedi
- Se il problema persiste, esci e rientra
Errore di elaborazione durante la creazione del piano:
- È un'operazione complessa che richiede una buona connessione a internet
- Aspetta almeno 5 minuti prima di pensare che ci sia un errore
- Se non riesce, riprova quando hai una connessione stabile
Problemi con un piano alimentare esistente
- Non vedo le opzioni dei pasti: aggiorna la pagina o riavvia l'app
- Il piano non compare nonostante l'abbonamento Premium:
- Verifica di aver completato tutto il questionario del piano alimentare
- Contatta l'assistenza se la creazione del piano continua a non riuscire
- I dettagli dei pasti non si caricano: controlla la connessione a internet
- Non riesco a rinnovare il piano dopo 28 giorni: vai su Modifica piano alimentare e compila di nuovo il modulo
- Le schede del piano alimentare non cambiano:
- Assicurati di toccare direttamente i nomi delle schede (Piano alimentare, Integratori, Stile di vita)
- Prova a riavviare l'app se l'interfaccia non risponde
- Controlla se ci sono aggiornamenti dell'app che risolvono i problemi dell'interfaccia
Problemi con le funzioni avanzate 🌟
Programma Invita e guadagna
- Il link non viene generato: controlla la connessione a internet e riprova
- Il referral non viene conteggiato:
- Assicurati che il tuo amico si registri usando esattamente il tuo link
- I nuovi utenti devono completare la registrazione perché il referral conti
- Non ho ricevuto il premio Premium:
- I premi vengono applicati dopo che l'amico ha completato la registrazione
- Concedi fino a 24 ore per l'applicazione dei premi
- Controlla il centro notifiche per la conferma
- Il conteggio dei referral non corrisponde:
- Il contatore dei referral può impiegare un po' ad aggiornarsi
- Verifica che gli amici invitati abbiano completato tutta la registrazione
- Contatta l'assistenza se le differenze persistono dopo 48 ore
Gestione dei pasti
Non riesco a eliminare i pasti:
- Assicurati di tenere premuto sul pasto
- Completa il passaggio di conferma
- Se l'opzione di eliminazione non compare, prova a forzare l'arresto dell'app e a riavviarla
"Copia su oggi" non funziona:
- Assicurati di tenere premuto sul pasto
- Funziona solo con i pasti già registrati
- Verifica di avere una connessione a internet stabile
- Aspetta il messaggio di successo che conferma il completamento dell'azione
Pannello delle analisi
Il calendario non mostra dati:
- Serve almeno una scansione di un pasto per vedere i dati
- Prova a cambiare periodo (Mese/7 giorni/Oggi)
- Scorri verso il basso per aggiornare il pannello
La mappa della città non è visibile:
- L'autorizzazione alla posizione deve essere concessa
- La funzione richiede almeno una scansione di un pasto
- In alcune regioni i dati della mappa possono essere limitati
- Se la mappa compare ma non mostra dati, prova a fare zoom avanti o indietro
I colori del NutriScore non corrispondono a quello che mi aspetto:
- I colori si basano su un algoritmo nutrizionale complesso
- Leggi la sezione "Scopri il NutriScore" per capire come funziona il punteggio
- Assicurati di aver inserito tutti gli alimenti per avere un punteggio preciso
Problemi con valutazioni e feedback ⭐
La richiesta di valutazione non compare:
- Compare dopo aver scansionato 2 pasti
- Se hai già risposto, non compare più
- Puoi comunque valutare l'app direttamente nell'App Store o nel Play Store
Non riesco a inviare il feedback:
- Assicurati di aver compilato tutti i campi obbligatori del modulo Contattaci
- Controlla la connessione a internet
- Prova a inviare un feedback più breve se il modulo non accetta testi lunghi
Problemi con le notifiche 🔔
Notifiche mancanti:
- Controlla che l'autorizzazione alle notifiche sia concessa
- Verifica che le notifiche siano attive nelle impostazioni dell'app
- Su Android: controlla che l'ottimizzazione della batteria non limiti l'app
- Su iOS: assicurati che le notifiche non siano silenziate o raggruppate
Toccando una notifica non si apre la schermata giusta:
- Aggiorna all'ultima versione dell'app
- Se il problema persiste, prova a svuotare la cache dell'app o a reinstallarla
Domande frequenti ❓
Come trovo i miei pasti precedenti?
Tutti i pasti che hai registrato compaiono nella schermata Home. Scorri verso il basso per vedere lo storico dei pasti per data. Puoi toccare un pasto qualsiasi per vederne i dettagli nutrizionali.
Perché non riesco ad accedere con il numero di telefono?
L'accesso con numero di cellulare è disponibile solo in India e richiede che l'autorizzazione alla posizione sia concessa. Se ti trovi fuori dall'India o hai negato l'autorizzazione alla posizione, questa opzione non è visibile. Usa invece l'accesso con Google o con ID Apple.
Come annullo il mio abbonamento?
Vai su Profilo > Gestisci abbonamento > Annulla abbonamento. Si apre la schermata di gestione degli abbonamenti del tuo dispositivo (App Store o Play Store), dove concludi l'annullamento.
Qual è la differenza tra il piano Free e il piano Premium?
Entrambi includono le domande e risposte di NutriBites e la nutrizionista IA (Monika). Il piano Free comprende 5 registrazioni di pasti a settimana (foto, voce o testo, tutte conteggiate insieme) e 4 chiamate a Monika a settimana. Premium toglie questi limiti e aggiunge piani alimentari personalizzati e analisi avanzate. Consulta la nostra guida alle alternative per il confronto delle funzioni più aggiornato.
Perché l'app richiede così tante autorizzazioni?
Ogni autorizzazione ha uno scopo preciso:
- Fotocamera: per scansionare i pasti
- Foto: per accedere alle immagini di cibo salvate
- Posizione: per le analisi sulla mappa e per l'accesso con numero di cellulare (India)
- Microfono: per l'input vocale e l'assistente IA
- Notifiche: per promemoria e aggiornamenti Tutte le autorizzazioni tranne Fotocamera e Foto sono facoltative, ma migliorano il funzionamento dell'app.
Contatta l'assistenza 📞
Se il problema persiste dopo aver provato le soluzioni qui sopra:
Assistenza nell'app:
- Vai su Profilo > Contattaci
- Compila tutti i campi obbligatori
- Descrivi il problema nel modo più preciso possibile e indica:
- La versione dell'app (in fondo alla schermata Profilo)
- Il modello del dispositivo e la versione del sistema operativo
- I passaggi per riprodurre il problema
Assistenza via email: [email protected]
Community: Community WhatsApp
Social media: