Troubleshooting
Risoluzione dei problemi più comuni in Hotely — date non disponibili, prezzi diversi sui portali, prenotazioni dei portali da gestire, pagamenti, feed iCal, email non ricevute, schedine Alloggiati, risposte AI, widget e accessi del team.
Questa guida raccoglie i problemi più frequenti, con le cause e i passi per risolverli. Se il tuo problema non è qui, scrivi a support@hotely.ai indicando la struttura, il codice della prenotazione (se c'è) e cosa vedi.
Le date risultano non disponibili
L'ospite cerca delle date e non trova camere, o vede "data non disponibile per il check-in".
| Causa | Dove verificare | Soluzione |
|---|---|---|
| Nessuna tariffa attiva | Vendita e prezzi → Tariffe | Una struttura senza tariffe attive non vende nessuna data: riattiva o crea una tariffa |
| Tariffa non assegnata alla tipologia | Tariffa → Camere e prezzi | Assegna la tipologia alla tariffa |
| Tariffa solo portali | Tariffa → Vendita → Distribuzione | Una tariffa "Solo portali" non compare sul sito |
| Date fuori validità | Tariffa → Valido dal / al | Estendi il periodo |
| Tipologia non in vendita sul sito | Camere → In vendita sul Booking Engine | Riattivala |
| Chiusura sulle date | Inventario | Rimuovi la chiusura (ovunque o "sul sito") |
| Chiuso all'arrivo | Inventario | La data non può essere un giorno di check-in |
| Soggiorno minimo | Inventario o tariffa | L'ospite cerca meno notti del minimo |
| Camere esaurite | Planner, blocchi, iCal | Prenotazioni, blocchi, unità fuori servizio o eventi iCal occupano tutte le camere |
| Ospiti oltre la capacità | Camere → Capacità ospiti | Verifica adulti, bambini e ospiti massimi |
| Oltre l'anticipo massimo | Impostazioni → Disponibilità e orari | Aumenta l'anticipo massimo |
I prezzi sui portali sono diversi da quelli attesi
- Apri l'Inventario con la vista del canale interessato: mostra il prezzo realmente pubblicato.
- Verifica la maggiorazione per canale in Distribuzione → Canali e che ogni portale sia mappato sulla sua tariffa dedicata, non sulla tariffa base.
- Oltre la fine del tuo listino i portali vendono al prezzo di default: carica i prezzi o attiva Non vendere le date senza un prezzo caricato.
- Se il pannello prezzi per canale segnala occupazione da correggere, imposta l'occupazione base della tariffa: altrimenti il portale può vendere la camera per più ospiti al prezzo di due.
- Le regole sulla durata del soggiorno valgono solo sul sito: ai portali arriva il prezzo per notte.
- Il portale può applicare sconti propri (es. Genius, offerte mobile): li vedi nella scheda prenotazione, sezione Conti del portale.
Una prenotazione del portale non è arrivata
- Controlla Distribuzione → Canali → Stato sync: le prenotazioni su camere o tariffe non mappate restano tra le prenotazioni da gestire finché non completi la mappatura.
- Verifica Ultimo controllo prenotazioni: deve essere recente.
- Se la struttura usava i feed iCal per quel portale, l'evento iCal compare come blocco finché arriva la prenotazione del Channel Manager.
- Se ancora non c'è, scrivi al supporto con il codice di prenotazione del portale.
Overbooking segnalato
Una prenotazione del portale è arrivata senza disponibilità (due canali hanno venduto nello stesso istante, oppure la disponibilità era stata cambiata nell'extranet). La trovi in Stato sync → Overbooking segnalati e nella prenotazione. Sposta l'ospite su un'altra camera dal planner o contatta il portale. Vedi Anti-overbooking.
Il pagamento non funziona
- Collegamento Stripe — in Operatività → Pagamenti lo stato deve essere "Stripe pronto". Se non lo è, completa l'onboarding.
- Dashboard Stripe — controlla avvisi o documenti richiesti: Stripe può sospendere pagamenti o accrediti finché la verifica non è completa.
- Errori dell'ospite
| Messaggio | Causa | Soluzione |
|---|---|---|
| Carta rifiutata | Fondi insufficienti o carta bloccata | L'ospite usa un'altra carta, o invii un link di pagamento |
| Autenticazione richiesta | La banca chiede 3D Secure | L'ospite completa la verifica nella finestra della banca |
| Importo non valido | Prezzo a zero o incoerente | Controlla i prezzi della tariffa per quelle date |
- Saldi non riusciti — in Pagamenti usa Riprova incasso, Link pagamento o Segna offline. Vedi Pagamenti e ledger.
Un feed iCal non si sincronizza
- Copia l'URL del feed e aprilo nel browser: deve scaricare un file che inizia con
BEGIN:VCALENDAR. Un errore 404 significa che l'URL è cambiato o l'annuncio è stato disattivato. - In Distribuzione → Canali → iCal (fallback) verifica che la connessione sia attiva e collegata all'unità giusta.
- Controlla l'ultima sincronizzazione: i feed vengono riletti circa ogni 15 minuti; lancia una sincronizzazione manuale se serve.
- Se hai collegato lo stesso portale al Channel Manager, il feed iCal di quel portale viene messo in pausa in automatico: è normale.
Per i portali principali preferisci il Channel Manager: è in tempo reale.
La prontezza al lancio resta bloccata
Gli elementi bloccanti sono tre: almeno una camera, almeno una tariffa attiva, Stripe collegato e pronto. Tutto il resto è consigliato. Vedi Prontezza al lancio.
L'ospite non ha ricevuto l'email
- Indirizzo — nella scheda prenotazione verifica l'email (errori come
gmial.com). Le prenotazioni dei portali spesso non hanno un indirizzo email: usa la conversazione del portale. - Cronologia — nella scheda prenotazione ogni email inviata è registrata; quelle non riuscite sono segnate in rosso con il motivo.
- Spam e Promozioni — chiedi all'ospite di controllare.
- Reinvia — con Reinvia email di conferma dalla scheda prenotazione; se c'era un errore di indirizzo, correggilo prima.
- Messaggi automatici — pre-arrivo e conferma partono sempre; i messaggi dopo il soggiorno sono spenti di default (Impostazioni → Recensioni).
La schedina Alloggiati non parte
- Verifica le credenziali in Impostazioni → Alloggiati Web e che non siano scadute.
- Controlla che tutti gli ospiti abbiano i dati obbligatori: le schedine incomplete restano da completare.
- Con l'invio automatico attivo, le schedine partono quando i dati sono completi; altrimenti inviale da Adempimenti italiani → Alloggiati Web.
Vedi Alloggiati Web.
L'agente AI non risponde ai messaggi dei portali
In Operatività → Messaggi → Risposte AI ai messaggi OTA verifica:
- il livello di automazione (Disattivate / Solo bozze / Invio automatico) e i canali automatizzati;
- che ci sia un agente selezionato;
- l'orario silenzioso e il numero massimo di risposte consecutive;
- le parole che richiedono una persona e la confidenza minima: in questi casi la risposta resta in bozza, con il motivo scritto, e il team riceve l'email "Serve una tua risposta".
Il widget non si carica sul sito
- Verifica di aver incollato lo snippet completo copiato da Distribuzione → Pagina prenotazione → Installa, e di averlo ricopiato dopo le ultime modifiche.
- Il sito deve essere in HTTPS.
- Controlla che il sito non blocchi iframe esterni (Content Security Policy).
- Prova in una finestra anonima per escludere estensioni che bloccano gli script.
Un collaboratore non vede una struttura o una pagina
Le persone con un ruolo limitato vedono solo le aree e le strutture del loro ruolo. Controlla il ruolo in Persone: l'anteprima mostra cosa vede e cosa riceve. Vedi Inviti e permessi.
L'ospite non riesce ad aprire il suo link
- Verifica che la prenotazione non sia stata cancellata.
- Il link del check-in online scade dopo 14 giorni: generane uno nuovo dalla prenotazione.
- Reinvia la conferma: contiene il link personale aggiornato.