> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.userbot.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server. # Problemi frequenti Nove volte su dieci il problema è uno di questi, e si risolve in un minuto senza scrivere a nessuno. Cerca il sintomo, non la causa. ## Non trovo una funzione Se una voce del menu non c'è (**Automazioni**, **Mini App**, **Customer Service**, **Sviluppatore**, un pulsante dentro una pagina), quasi sempre non è un guasto. Chi amministra può spegnere intere parti di Userbot o riservarle a certi gruppi: se un collega la vede e tu no, è una questione di ruolo o di gruppo. Alcune operazioni (condividere un agente con tutti, usare una connessione condivisa, leggere il **Registro di audit**, creare chiavi API) richiedono inoltre un permesso che il tuo ruolo può non avere: vedi [ruoli e permessi](/ruoli). Il controllo da cui dipende è uno solo, **Accesso**, e sta nelle impostazioni della funzionalità: chi amministra sceglie lì chi può usarla. ![Il controllo Accesso di una funzionalità visto da chi amministra, con le opzioni per aprirla a tutta l'area di lavoro o riservarla ad alcuni: chi resta fuori non vede la voce nel menu](/_fern-img/0a40b403b6d9f611a9ee481e2232ab3da971fcd94eb1e1ef45a591ac1b182ba1.webp) Chiedendo accesso, spiega **cosa devi fare**, non quale pulsante ti manca: spesso esiste una strada già consentita. Se invece la funzione c'era fino a ieri, ricarica la pagina. ## L'AI non trova un documento che ho caricato Il sintomo più comune, e con la causa meno intuitiva. | Controlla | Perché | | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Dove sta nella Libreria** | Solo i file in una **base di conoscenza** vengono resi ricercabili. In una cartella normale il file è conservato, non cercabile. Le basi di conoscenza si creano con **Crea knowledge base** | | **Non vedi nessuno stato accanto al nome** | Non è un file rimasto indietro: l'indicazione compare solo dentro una base di conoscenza. Fuori, non c'è indicizzazione e quindi non c'è stato | | **Lo stato del file** | **In coda** e **In corso…** vogliono dire che non è ancora pronto. Quando è pronto l'indicazione sparisce | | **Se lo stato è Vuoto** | Il file non contiene testo: succede con i PDF che sono scansioni o foto | | **Se lo stato è Non indicizzato** | Una presentazione o un foglio senza contenuto da leggere. Vedi [riferimento dei formati](/riferimento-formati) | | **Se lo stato è Immagine** | Le immagini si conservano ma non si indicizzano: il testo dentro un'immagine non si trova | | **Se lo stato è Errore** | Menu **⋯**, **Reindicizza**: la voce compare solo qui, sui file in errore dentro una base di conoscenza. Se si ripete, il file è protetto, corrotto, oppure è un foglio con una cella enorme. Chi amministra ha anche **Reindicizza tutta la knowledge** sull'intera base di conoscenza | | **La ricerca è attiva** | Nel menu **+** del campo di scrittura serve **Ricerca nei documenti**, su tutte le basi di conoscenza o su quella giusta | | **Le parole della domanda** | Usa i termini che compaiono nel documento, non i sinonimi interni | | **Quanti altri documenti ci sono** | Se il file è a posto, il problema è la concorrenza: vedi qui sotto | **Il caso che resta quando tutto è a posto.** Un documento indicizzato non ha una corsia riservata. Ogni domanda recupera i **dieci passaggi migliori** fra le basi di conoscenza su cui stai cercando, e se altre raccolte contengono brani che assomigliano di più alla tua domanda, sono quelli a entrare, anche se tu stavi pensando a un altro documento. Il rimedio è restringere il campo: nel menu **+**, sotto **Ricerca nei documenti**, scegli solo la base di conoscenza che contiene il documento e rifai la domanda. Da quel momento la ricerca lavora solo lì. Nomina anche il documento nella domanda: *«nel capitolato 2026, qual è il termine di consegna?»* funziona meglio di *«qual è il termine di consegna?»*. Il ragionamento completo è in [come l'AI trova le risposte](/come-trova). ## Una risposta sembra sbagliata #### Guarda le fonti Apri la barra **Fonti** sotto la risposta e leggi il brano citato. Nella metà dei casi il documento dice davvero quello, e la domanda era ambigua. Nell'altra metà il brano non c'entra: la ricerca restituisce sempre i passaggi migliori disponibili, anche quando nessuno risponde davvero alla domanda. Una risposta con fonti che non la sostengono è una risposta sbagliata, per quanto suoni bene. ![L'anteprima di una fonte aperta sopra la risposta: il nome del file, il brano da cui arriva la frase e il collegamento Apri documento](/_fern-img/37ebeb165786bd6c8f05acb73ef8011bcaa1a56c0fdbf6263b902375dc4472f6.webp) #### Se non ci sono fonti, non è verificata Una risposta senza citazioni è costruita su quello che il modello sa, non sui vostri documenti. Riformula attivando **Ricerca nei documenti** dal menu **+**. ![Il menu + aperto con Ricerca nei documenti evidenziata e accanto l'elenco delle basi di conoscenza su cui cercare](/_fern-img/4e578baff978a6d09e04f93b984254a793ec9f1331d0acf73fcd61dc39fe8e14.webp) #### Contesta nel merito Scrivi *«nel contratto all'articolo 7 c'è scritto diversamente: ricontrolla»*. Correggere puntando al punto specifico funziona meglio di *«è sbagliato»*. #### Rigenera, o cambia modello **Rigenera** sotto la risposta, oppure **Rigenera con un altro modello** se il compito era complesso. ![Il menu aperto dalla freccia accanto a Rigenera sotto una risposta, con l'elenco dei modelli con cui rifarla](/_fern-img/1b7e81778f615d0181db565fdcb1f85105f1109d9439a8d4e5c724968d0572dc.webp) Due cause ricorrenti di risposte sbagliate: * **La conversazione è troppo lunga.** Oltre una certa lunghezza i messaggi più vecchi vengono riassunti per il modello: un vincolo dato all'inizio può essersi perso nel riassunto. Ripetilo, o apri una chat nuova. → [Contesto, utilizzo e conversazioni lunghe](/contesto-conversazione) * **Sei sotto il limite di utilizzo.** Al raggiungimento del limite le risposte passano a un modello più semplice. Controlla in [quanto sto consumando](/consumi). Il pollice giù sotto la risposta non serve solo a sfogarsi: segnala a chi gestisce Userbot quali configurazioni non funzionano. ## Un'automazione non è partita | Sintomo | Rimedio | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nessuna notifica, nessuna esecuzione | Controlla che l'automazione sia **attiva**: una in bozza non parte | | Notifica **Attività «…» non eseguita** | È stato raggiunto il limite di esecuzioni programmate o il limite anti-spam: il motivo è nel testo della notifica. Aspetta la finestra successiva o riduci la frequenza | | Notifica **Agente collegato non trovato** | L'agente usato dall'attività è stato eliminato o rinominato: l'attività è in pausa, ricollegagli un agente | | Notifica **Attività «…» fallita** | Il motivo è dentro la notifica; apri l'esecuzione in **Automazioni** per il dettaglio | | Notifica **Attività «…» in pausa** | Il testo dice perché: esecuzioni del mese finite, prova terminata o accesso alle attività programmate tolto | | Parte all'ora sbagliata | Controlla il fuso orario impostato sull'attività | | Si è fermata a metà | Un passaggio ha superato un tetto di spesa o di durata: vedi [costi e limiti](/costi-workflow) | | Un'azione su uno strumento esterno non è avvenuta | La connessione può essere scaduta: riaprila in [integrazioni](/integrazioni) | > **Info** > > Un'automazione che gira senza una persona davanti non può chiedere conferme: > le azioni configurate per chiedere il tuo via libera vengono eseguite > direttamente. Tienine conto quando trasformi in automazione qualcosa che facevi > a mano. ## Non riesco ad accedere | Sintomo | Rimedio | | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Il link via email non arriva | Guarda nello spam; verifica l'indirizzo senza spazi; riprova dopo qualche minuto | | Il link scade prima che lo apra | Aprilo sullo **stesso dispositivo** da cui l'hai richiesto, e subito | | La passkey non funziona | Sei su un dispositivo diverso da quello dove l'hai registrata: entra in un altro modo e aggiungine una qui | | L'invito è scaduto | Gli inviti durano sette giorni: chiedi a chi amministra di reinviarlo | | «Non ci sono posti disponibili in quest'area di lavoro. Contatta l'amministratore.» | Entri da solo grazie al dominio della tua email, ma l'area di lavoro non ha posti liberi: chi amministra deve liberarne o acquistarne uno | | «Troppi tentativi. Riprova tra poco.» | Hai fatto troppi tentativi di accesso in poco tempo: aspetta qualche minuto | | Entro ma vedo un'area di lavoro sbagliata | Se ne hai più di una, cambiala dal menu sul tuo nome con **Cambia area di lavoro**. Se quella giusta non c'è, controlla di aver usato l'indirizzo email con cui sei stato invitato, poi chiedi a chi amministra quell'area di lavoro di verificare che tu ci sia dentro | | Vengo disconnesso di continuo | Controlla che il browser accetti i cookie e non sia in una modalità che li cancella a ogni chiusura | Se non riconosci una sessione nell'elenco, terminala e cambia la password: vedi [sicurezza](/sicurezza-account). ![L'elenco delle sessioni attive: quella da cui stai guardando è contrassegnata Sessione corrente e non ha comandi, le altre hanno il pulsante Termina](/_fern-img/1077372ab2ad54f9dcd88171ad140a9da3a20d1ca4b5af3351e351f3d638bc29.webp) ## Prima di scrivere al supporto Ricarica la pagina. Esci e rientra. Prova in una finestra privata, o con un altro browser. Se il problema resta, segnalalo dalla linguetta **Feedback** sul bordo della pagina, che allega da sola lo screenshot e i dettagli tecnici → [Segnalare un problema o un'idea](/segnalazioni). Oppure [scrivici](/supporto) dicendo cosa stavi facendo, cosa ti aspettavi e cosa è successo, con il link della pagina.