Vai al contenuto principale
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.
Ogni errore include un ID della richiesta. Se scrivi a [email protected], indicalo. Non inviare mai il token.

Cosa contiene un errore

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.

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 [email protected].

NOT_ENTITLED

HTTP 403 · Non ripetibile Questa funzione non fa parte della configurazione Ecco del tuo hotel. Scrivi a [email protected].

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 [email protected] 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 [email protected].

ACTOR_FORBIDDEN

HTTP 403 · Non ripetibile Il tuo account non può agire su questa escalation. Usa un account con accesso alla struttura dell’escalation.