Hootel

Cerca strutture ricettive convenzionate in un luogo. Usalo appena il viaggiatore chiede dove dormire in un posto preciso. Se nomina un hotel specifico, anche con nome approssimativo, usa find_hotel invece di cercare strutture nella zona. Non usare questa ricerca per rispondere a domande sui servizi o sulle policy di un hotel nominato. Interpreta tu il luogo: indica place_type e country_code; per region anche area_name nella lingua locale; per city, neighbourhood, landmark e address anche latitude, longitude e city. Le aree turistiche non amministrative (Costa Azzurra, Chianti, Riviera dei Ciclopi) non sono supportate: chiedi al viaggiatore una citta o proponine una. Per le metropoli molto estese preferisci un quartiere a tutta la citta. Le date sono facoltative: senza date i prezzi sono indicativi "a partire da" e vanno dichiarati come tali. Se con le date nessuna struttura e libera, i risultati propongono le date vicine libere (alternativeStays): non ripetere la ricerca con altre date. Budget, servizi obbligatori, tipologie, categoria e distanza massima sono filtri rigidi. Se nessuna struttura rispetta budget, servizi, tipologie e categoria, la risposta propone alternative nella stessa zona (relaxedCriteria non vuoto) e alternativeReason dice cosa non rispettano: presentale come alternative, non ripetere la ricerca togliendo i filtri. Restituisce solo strutture convenzionate, non tutta l offerta della zona. Il widget mostra gia tutte le strutture: dopo il widget scrivi solo un breve riepilogo, senza altre liste di schede, foto o link ai siti. Per prenotare usa esclusivamente bookingUrl o get_booking_link, mai contacts.website.

search_hotels

Uso interno del componente dell'app, non per il modello. Equivale a search_hotels.

widget_search_hotels

Trova le prime date libere di una struttura per un numero di notti dentro un periodo, con il totale per ciascuna. Usalo quando il viaggiatore chiede quando la struttura e libera ("quando c e posto per 3 notti a ottobre?") o quando le sue date non sono disponibili e vuole alternative in un periodo. Una sola chiamata copre tutto il periodo: non provare le date una a una con check_availability. Per le offerte complete di una delle date trovate usa get_hotel_details con quelle date.

find_available_dates

Elenca paesi, regioni e localita in cui la rete ha strutture convenzionate, con il numero di strutture. Usalo quando il viaggiatore chiede dove e disponibile il servizio, oppure quando una ricerca non trova risultati e serve proporre alternative reali. Sono le uniche destinazioni coperte: non ipotizzarne altre.

list_destinations

Restituisce il profilo completo di una struttura: descrizione, servizi, policy, foto, vantaggi della prenotazione diretta e camere. Usalo quando il viaggiatore chiede piu informazioni su una struttura specifica gia comparsa nei risultati. Se conosci solo il nome, usa prima find_hotel. Se find_hotel ha gia restituito il profilo, non riaprire la scheda per rispondere a una semplice domanda sui servizi. Se indichi anche le date, include le offerte disponibili per quell itinerario. Rispondi alle domande sulla struttura solo con questi dati: se un dato manca, dillo e mostra i contatti.

get_hotel_details

Uso interno del componente dell'app, non per il modello. Equivale a get_hotel_details.

widget_get_hotel_details

Restituisce il link per prenotare sul sito ufficiale della struttura, con date e ospiti gia compilati quando il suo sistema lo permette. Usalo quando il viaggiatore vuole procedere con la prenotazione o manca bookingUrl nei risultati. Usa esattamente url nella risposta, senza sostituirlo con contacts.website o con il dominio di destinazione. Avvisa sempre che il link porta fuori dalla conversazione, sul sito della struttura. Restituisce anche i contatti diretti, da usare se il link non e utilizzabile.

get_booking_link

Uso interno del componente dell'app, non per il modello. Equivale a get_booking_link.

widget_get_booking_link

Verifica prezzi e disponibilita di una struttura per date precise e una composizione di ospiti. Usalo quando il viaggiatore ha scelto una struttura e chiede se e libera in date precise e quanto costa. Restituisce tutte le combinazioni camera + tariffa disponibili, oppure il motivo preciso dell indisponibilita e le date vicine libere. Non chiamarlo piu volte per provare date diverse: per "quando e libero?" usa find_available_dates. Il prezzo e il totale del soggiorno, IVA inclusa; la tassa di soggiorno e indicata a parte e si paga in struttura. Mostra un widget con offerte e pulsanti di prenotazione. Nel testo aggiungi solo un breve riepilogo; usa bookingUrl per prenotare, mai il sito nei contatti o un URL ricostruito.

check_availability

Uso interno del componente dell'app, non per il modello. Equivale a check_availability.

widget_check_availability