Troubleshooting

Questa guida copre i problemi più frequenti che possono presentarsi durante l'utilizzo del Booking Engine di Hotely, con spiegazioni dettagliate delle cause e procedure passo-passo per la risoluzione. Se il tuo problema non è elencato qui o se le soluzioni proposte non risolvono la situazione, contatta il supporto tecnico a support@hotely.ai indicando il nome della proprietà e una descrizione dettagliata del problema.

Nessuna disponibilità mostrata

Quando un ospite cerca disponibilità per determinate date e non vengono mostrati risultati, il sistema ha verificato tutte le condizioni necessarie e almeno una non è soddisfatta. Questo è il problema più comune e può dipendere da diverse cause.

Checklist diagnostica

Segui questa checklist nell'ordine indicato. Ad ogni passo, verifica la condizione e, se non soddisfatta, applica la correzione.

1. Verifica che le tipologie camera siano attive

Le tipologie camera hanno uno stato che determina se sono visibili nel booking engine.

• Vai su Camere nella sidebar della proprietà
• Controlla che almeno una tipologia abbia lo stato Attiva
• Se tutte le tipologie sono in stato "Bozza" o "Disattivata", nessuna camera verrà mostrata nei risultati

Come attivare una tipologia:

1. Clicca sulla tipologia camera
2. Vai alla sezione "Stato"
3. Imposta su "Attiva"
4. Salva

2. Verifica che l'inventario non sia bloccato

L'inventario può essere bloccato (stop-sell) per date specifiche o per intervalli, impedendo la vendita anche se ci sono camere fisicamente disponibili.

• Vai su Inventario nella sidebar
• Naviga fino alle date cercate dall'ospite
• Controlla che non ci sia un blocco (stop-sell) attivo sulla tipologia camera per quelle date
• Se presente, rimuovi il blocco cliccando sulla cella e deselezionando "Stop sell"

Cause comuni di stop-sell inaspettato:

• Blocco manuale dimenticato dopo un evento o una manutenzione
• Regola revenue che ha attivato automaticamente lo stop-sell al superamento di una soglia di occupazione
• Import iCal che ha segnalato la camera come non disponibile

3. Verifica che i piani tariffari siano attivi e collegati

Una tipologia camera senza piano tariffario attivo e collegato non produce risultati, anche se ha disponibilità.

• Vai su Tariffe nella sidebar
• Controlla che almeno un piano tariffario sia in stato Attivo
• Verifica che il piano tariffario sia collegato alla tipologia camera in questione
• Controlla che il piano tariffario abbia prezzi impostati per le date cercate

Come collegare un piano tariffario a una tipologia:

1. Apri il piano tariffario
2. Nella sezione "Tipologie camera collegate", seleziona le tipologie desiderate
3. Salva

Come verificare i prezzi:

1. Apri il piano tariffario
2. Vai alla sezione "Prezzi"
3. Controlla che ci siano prezzi definiti per le date cercate dall'ospite
4. Se usi prezzi per data, assicurati che ogni notte del soggiorno abbia un prezzo

4. Verifica l'intervallo di date valido

Il piano tariffario può avere un intervallo di validità (data inizio e data fine). Se le date cercate dall'ospite cadono fuori da questo intervallo, la tariffa non viene mostrata.

• Apri il piano tariffario
• Controlla i campi "Data inizio validità" e "Data fine validità"
• Assicurati che le date cercate dall'ospite rientrino nell'intervallo

5. Verifica le restrizioni di soggiorno

Alcune tariffe hanno restrizioni di soggiorno minimo o massimo. Se l'ospite cerca un soggiorno di 1 notte ma la tariffa richiede un minimo di 3 notti, non verrà mostrata.

• Controlla il campo "Soggiorno minimo" nel piano tariffario
• Controlla eventuali restrizioni specifiche per data nell'inventario
• Verifica le regole revenue che potrebbero aver imposto un soggiorno minimo automatico

6. Verifica la capacità

Se l'ospite ha indicato 3 adulti ma la tipologia camera ha una capacità massima di 2, non verrà mostrata nei risultati.

• Controlla il campo "Capacità massima adulti" nella tipologia camera
• Controlla il campo "Capacità massima bambini" se l'ospite ha indicato bambini
• Controlla il campo "Capacità massima totale" (adulti + bambini)

7. Verifica che la proprietà sia attiva

Se la proprietà è archiviata o il punteggio di prontezza non ha raggiunto il 100% sugli elementi bloccanti, il booking engine potrebbe non essere accessibile.

• Dalla dashboard principale, verifica lo stato della proprietà
• Controlla il punteggio di prontezza nella dashboard della proprietà

Tabella riepilogativa

Pagamento non funzionante

Quando l'ospite arriva alla fase di pagamento ma riscontra errori, il problema è quasi sempre legato alla configurazione di Stripe.

1. Verifica la connessione Stripe

• Vai su Impostazioni > Pagamenti nella sidebar della proprietà
• Controlla che lo stato della connessione Stripe sia "Connesso"
• Se mostra "Non connesso", clicca su "Connetti Stripe" e completa il processo di onboarding

2. Verifica la modalità (test vs live)

Stripe opera in due modalità: test (per provare il flusso senza pagamenti reali) e live (per accettare pagamenti veri).

• Controlla che la modalità sia quella corretta per il tuo caso d'uso
• Se stai testando, usa le carte di test di Stripe (es. 4242 4242 4242 4242)
• Se sei in produzione, assicurati di essere in modalità live

3. Verifica che i payout siano abilitati

Stripe potrebbe bloccare i pagamenti se il tuo account non ha completato la verifica dell'identità o se i payout (trasferimenti sul tuo conto bancario) non sono abilitati.

• Accedi alla dashboard Stripe (stripe.com/dashboard)
• Controlla se ci sono banner di avviso o requisiti da completare
• Verifica che i dati bancari siano inseriti correttamente
• Controlla che la verifica dell'identità sia completata

4. Errori comuni durante il pagamento

5. Verifica i log dei pagamenti

• Vai su Pagamenti nella sidebar della proprietà
• Cerca la prenotazione in questione
• Controlla lo stato del pagamento e l'eventuale messaggio di errore
• Nella dashboard Stripe, sotto "Pagamenti", puoi vedere il dettaglio tecnico dell'errore

iCal non si sincronizza

La sincronizzazione iCal permette di mantenere allineato l'inventario con le piattaforme esterne (Booking.com, Airbnb, ecc.). Se la sincronizzazione non funziona, rischi overbooking.

1. Verifica che l'URL del feed sia valido

• Vai su Canali nella sidebar della proprietà
• Controlla l'URL del feed iCal importato
• Copia l'URL e incollalo in un browser: dovresti visualizzare un file con formato iCalendar (testo che inizia con BEGIN:VCALENDAR)
• Se il browser mostra un errore, l'URL non è più valido — recupera un nuovo URL dalla piattaforma esterna

Cause comuni di URL non valido:

• Il feed è stato rigenerato sulla piattaforma esterna (nuovo URL)
• L'annuncio sulla piattaforma esterna è stato disattivato
• La piattaforma esterna ha cambiato la struttura degli URL

2. Verifica che la sincronizzazione sia abilitata

• Nel canale iCal, controlla che lo switch "Sincronizzazione attiva" sia acceso
• Controlla l'intervallo di sincronizzazione (ogni 15 minuti, ogni ora, ecc.)
• Verifica che la sincronizzazione automatica non sia stata sospesa manualmente

3. Controlla l'ultimo stato di sincronizzazione

Ogni canale mostra la data e l'ora dell'ultima sincronizzazione riuscita e l'eventuale errore dell'ultimo tentativo.

4. Forza la sincronizzazione manuale

• Apri il canale iCal
• Clicca su "Sincronizza ora"
• Attendi il completamento (pochi secondi)
• Controlla il risultato: quanti eventi sono stati importati/aggiornati

5. Problemi noti con le piattaforme

Punteggio di prontezza bloccato

Il punteggio di prontezza (readiness score) indica quanto la proprietà è vicina ad essere pronta per accettare prenotazioni. Se il punteggio è bloccato sotto il 100%, ci sono elementi obbligatori da completare.

Elementi bloccanti

Gli elementi bloccanti impediscono alla proprietà di andare live. Finchè non sono tutti completati, la pagina di prenotazione non è accessibile al pubblico.

Elementi raccomandati (non bloccanti)

Questi elementi non impediscono il lancio ma sono fortemente consigliati:

• Foto delle camere (almeno una per tipologia)
• Descrizione della struttura
• Politica di cancellazione definita
• Email di conferma personalizzata
• Informazioni di contatto

Come verificare il punteggio

1. Accedi alla dashboard della proprietà
2. Il punteggio di prontezza è mostrato in alto nella pagina
3. Clicca sul punteggio per vedere il dettaglio degli elementi
4. Gli elementi bloccanti sono evidenziati in rosso
5. Completa ogni elemento e il punteggio si aggiorna automaticamente

L'ospite non ha ricevuto l'email

Quando un ospite segnala di non aver ricevuto l'email di conferma o altre comunicazioni, segui questa procedura diagnostica.

1. Verifica l'indirizzo email

• Vai su Prenotazioni nella sidebar
• Cerca la prenotazione dell'ospite
• Apri il dettaglio e controlla l'indirizzo email registrato
• Verifica che non ci siano errori di battitura (es. gmial.com invece di gmail.com, spazi prima o dopo l'indirizzo)

2. Controlla la cartella spam

Chiedi all'ospite di controllare:

• La cartella Spam o Posta indesiderata
• La cartella Promozioni (Gmail spesso sposta le email transazionali qui)
• La cartella Altro o Notifiche (Outlook e altri client)

Suggerisci all'ospite di aggiungere noreply@hotely.ai ai contatti per evitare il problema in futuro.

3. Verifica lo storico invio nella prenotazione

Ogni prenotazione tiene traccia di tutte le email inviate, con data, ora e stato di consegna.

• Apri il dettaglio della prenotazione
• Scorri fino alla sezione Storico comunicazioni o Email inviate
• Controlla lo stato di ogni email:

4. Reinviare l'email

Se l'email è stata inviata correttamente ma l'ospite non la trova:

1. Apri il dettaglio della prenotazione
2. Clicca su "Reinvia conferma" o seleziona il tipo di email da reinviare
3. Verifica l'indirizzo email prima dell'invio
4. Clicca "Invia"

Se l'indirizzo email originale era errato:

1. Correggi l'indirizzo email nei dati dell'ospite
2. Salva la modifica
3. Reinvia l'email al nuovo indirizzo

5. Email non inviate automaticamente

Se le email automatiche non partono per nessuna prenotazione:

• Controlla le Impostazioni > Email della proprietà
• Verifica che le email automatiche siano abilitate (conferma, pre-arrivo, post-stay)
• Controlla che i template email non siano in stato "Bozza"

Altri problemi comuni

Il widget non si carica sul sito

• Verifica che il codice snippet sia stato inserito correttamente nell'HTML del sito
• Controlla la console del browser (F12 > Console) per errori JavaScript
• Assicurati che il sito non blocchi script esterni con Content Security Policy
• Testa su un browser diverso o in modalità incognito per escludere estensioni che bloccano gli script

I prezzi mostrati non sono corretti

• Verifica i prezzi nel piano tariffario per le date specifiche
• Controlla se ci sono override nell'inventario che sovrascrivono il prezzo base
• Verifica le regole revenue che potrebbero modificare il prezzo in base all'occupazione
• Controlla le tasse e i supplementi configurati

Le prenotazioni non appaiono nella lista

• Verifica i filtri attivi nella lista prenotazioni (stato, date, ricerca)
• Controlla di essere nella proprietà corretta (se gestisci più proprietà)
• Se la prenotazione è stata fatta da pochi secondi, ricarica la pagina

L'ospite non riesce ad accedere al portale di gestione

• Verifica che il link inviato sia corretto e non sia scaduto
• Prova a generare un nuovo link di accesso dal dettaglio della prenotazione
• Controlla che la prenotazione non sia stata cancellata

Per qualsiasi problema non coperto in questa guida, contatta il supporto tecnico a support@hotely.ai fornendo il nome della proprietà, il codice della prenotazione (se applicabile) e una descrizione dettagliata del problema riscontrato.