> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryecco.com/llms.txt > Use this file to discover all available pages before exploring further. # Codici di errore > Cosa significa ogni codice di errore Ecco e cosa fare, per le integrazioni AI e gli altri collegamenti a Ecco. Quando Ecco rifiuta una richiesta del tuo assistente AI, restituisce un breve errore con un **codice**. Di solito è l'assistente a spiegartelo. Cerca il codice qui sotto per capire cosa è successo e cosa fare. > [!NOTE] > > Ogni errore include un **ID della richiesta**. Se scrivi a [support@tryecco.com](mailto:support@tryecco.com), indicalo. Non inviare mai il token. ## Cosa contiene un errore | Campo | Significato | | - | - | | `code` | Il codice di errore elencato in questa pagina. | | `status` | Lo stato HTTP, ad esempio 401 o 429. | | `detail` | Cosa è andato storto, in una frase (in inglese). | | `fix` | Il passo successivo (in inglese). | | `retryable` | `true` se la stessa richiesta può riuscire più tardi senza modifiche. | | `request_id` | L'identificativo che il supporto usa per trovare la tua richiesta. | ## Collegamento e accesso ### unauthenticated **HTTP 401** · Non ripetibile Il token manca, è stato copiato male, è scaduto o è stato revocato. Controlla il suo stato in **Configurazione → Integrazioni AI**. Se è scaduto o revocato, crea un nuovo token e ripeti la configurazione come descritto in [Integrazioni AI](/it/come-usare-ecco/integrazioni-ai#collega-il-tuo-assistente). ### insufficient\_scope **HTTP 403** · Non ripetibile Il token non include il permesso richiesto, ad esempio il testo delle conversazioni con gli ospiti. Crea un nuovo token con le opzioni giuste, oppure chiedi a un owner o admin della struttura. ### forbidden **HTTP 403** · Non ripetibile Il tuo account non può vedere questo elemento. Usa un account che vi ha accesso, oppure chiedi a un owner o admin di aggiornare il tuo ruolo. ### property\_scope\_required **HTTP 403** · Non ripetibile Questa richiesta richiede l'accesso a tutte le strutture dell'hotel e il tuo account ne vede solo alcune. Usa un account con accesso a tutte le strutture. ### not\_found **HTTP 404** · Non ripetibile L'elemento non esiste oppure il tuo account non può vederlo. Chiedi all'assistente di elencare di nuovo gli elementi e scegline uno dalla lista. Se succede a ogni richiesta, scrivi a [support@tryecco.com](mailto:support@tryecco.com). ### NOT\_ENTITLED **HTTP 403** · Non ripetibile Questa funzione non fa parte della configurazione Ecco del tuo hotel. Scrivi a [support@tryecco.com](mailto:support@tryecco.com). ### rate\_limited **HTTP 429** · Ripetibile Troppe richieste nell'ultimo minuto per questo token o questa struttura. Attendi i secondi indicati in `Retry-After`, poi chiedi di nuovo. Raggruppare più richieste in una sola domanda aiuta. ## Richieste ### invalid\_input **HTTP 400** · Non ripetibile La richiesta non è nel formato previsto, ad esempio una data non valida. Riformula la domanda con una data o un periodo chiaro. ### result\_too\_large **HTTP 400** · Non ripetibile La risposta sarebbe troppo lunga per arrivare in una volta. Chiedi un periodo più breve, una sola struttura o un solo giorno. ### human\_confirmation\_required **HTTP 403** · Non ripetibile Questa azione modifica qualcosa in Ecco e deve essere confermata da una persona. Apri il link mostrato dall'assistente e completa l'azione nella dashboard Ecco. ### agent\_not\_configured **HTTP 409** · Non ripetibile L'agente Ecco non è ancora configurato per questo hotel o canale. Completa la configurazione nella dashboard Ecco, poi chiedi di nuovo. ## Servizio ### upstream\_unavailable **HTTP 503** · Ripetibile Un sistema da cui Ecco legge i dati, come il tuo PMS, non ha risposto in tempo. Riprova tra un minuto. ### internal\_error **HTTP 500** · Ripetibile Si è verificato un problema imprevisto lato Ecco. Riprova più tardi. Se continua, scrivi a [support@tryecco.com](mailto:support@tryecco.com) con l'ID della richiesta. ## Azioni della dashboard Questi codici arrivano dalle azioni su arrivi, pulizie ed escalation. Di solito significano che l'elemento è già cambiato: rileggilo prima di agire. ### LATE\_ARRIVAL\_ALREADY\_CONFIRMED **HTTP 409** · Non ripetibile L'arrivo tardivo è già confermato. Non serve fare altro. ### LATE\_ARRIVAL\_NOT\_PENDING **HTTP 409** · Non ripetibile Non c'è nessun arrivo tardivo da confermare: nessuno è previsto tra le 22:00 e le 06:00, l'ospite è già arrivato oppure la notte è finita. Controlla di nuovo la lista di oggi. ### CHECKIN\_EXCEPTION\_NOT\_PENDING **HTTP 409** · Non ripetibile La prenotazione non ha problemi di check-in aperti in quel giorno: il check-in online è completato o sconosciuto, l'ospite è arrivato oppure si tratta di un altro giorno. Controlla di nuovo la lista di oggi. ### CLEANING\_TASK\_ALREADY\_DONE **HTTP 409** · Non ripetibile La pulizia è già stata completata. Non serve fare altro. ### WORK\_ITEM\_NOT\_FOUND **HTTP 404** · Non ripetibile L'escalation non è stata trovata. Elenca di nuovo le escalation e scegline una dalla lista. ### WORK\_ITEM\_ALREADY\_CLOSED **HTTP 409** · Non ripetibile L'escalation è già chiusa. Non serve fare altro. ### WORK\_ITEM\_ALREADY\_OPEN **HTTP 409** · Non ripetibile L'escalation è già aperta. Non serve fare altro. ### WORK\_ITEM\_VERSION\_CONFLICT **HTTP 409** · Ripetibile Qualcuno ha modificato l'escalation dopo che è stata letta. Rileggila, poi ripeti l'azione. ### WORK\_ITEM\_REQUEST\_KEY\_REUSED **HTTP 409** · Non ripetibile La stessa richiesta è già stata usata per un'azione diversa. Rileggi l'escalation e ripeti l'azione come nuova richiesta. ### WORK\_ITEMS\_DISABLED **HTTP 409** · Non ripetibile Le escalation non sono disponibili per questo account. Scrivi a [support@tryecco.com](mailto:support@tryecco.com). ### ACTOR\_FORBIDDEN **HTTP 403** · Non ripetibile Il tuo account non può agire su questa escalation. Usa un account con accesso alla struttura dell'escalation. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.