search_hotels
Search hotels and rooms (smart descriptive search)
Search hotels by a descriptive natural-language query in Arabic or English. Applies star rating, bedroom count, room type, and landmark or view as filters, and shows the 4 stays VICATOO's selling rule picks (of the stays with everything asked: the cheapest, the dearest and two between; the nearest first when a place is named; when none has it all, the closest, each with what it lacks), grouped into match-quality sections (perfect match, close, alternative type, more) — each with the matched room, its photos, and a live per-night + total stay price, meal plan and cancellation policy — every card shown carries a live price bound to its displayed room. Use it for any hotel search; pass the user's full descriptive phrase as `query` (for example "5-star hotel in Paris" or "two-bedroom apartment with an Eiffel Tower view"). COUNTRY OF RESIDENCE: prices depend on the country the guest lives in - pass it as `residency`. If the guest has not said where they live, ask them first ("which country do you live in?", in their own language) before searching; never assume US or any other country. Each card's price is the quick search's price - approximate (the card says so); the hotel page it links to, which carries that country and the currency, has the current price. Call check_availability for booking-ready rates on a specific hotel. TIER MEANINGS (disclose when recommending): perfect = every stated constraint met; near = minor deviation; unit_swap = the requested unit type had no availability so a similar type is offered; wider/fallback = constraints relaxed. PRESENTATION (follow this when you talk about the results): you are VICATOO's travel concierge — always call the platform VICATOO, never name any supplier. Speak warmly and help the guest feel confident booking, but stay strictly truthful per 'Truth Before You Book': no invented urgency, no 'booked N times', no fake scarcity — only real signals. The real quality signals you may cite: review_score (out of 10) with review_cou
输入参数langquery必填roomsadultscheck_in必填check_out必填residencychildren_ages
get_hotel_details
Get full details for a hotel
Fetch full details for a single hotel by its VICATOO hotel_id (numeric hid, the hotel_id search_hotels returns, or the slug). Returns name, star rating, REAL guest rating (score/10 + review count — cite it, and call get_hotel_reviews for guest pros/cons before strongly recommending), what the hotel is known for (vibe_tags), location, check-in/out times, headline amenities, images, a description, AND the available rooms cheapest-first — each with photos, a live price (total for the stay and per night), size, view, bed type, meal plan and cancellation. PRICES ARE FOR A STAY: pass check_in, check_out, adults and children_ages (the same values as the guest's search_hotels call) so the prices are for their stay. Without dates the prices are APPROXIMATE, for a default stay the reply names (prices_for.approximate = true) — say so to the guest. When has_video is true, offer the real room-tour video via get_room_video with the returned reel_id.
输入参数langviewadultscheck_incurrencyhotel_id必填check_outresidencychildren_ages
check_availability
Check live rates for a hotel
Fetch live VICATOO rates for a hotel for the given check-in/check-out dates and occupancy. Returns up to `limit` rates with room name, price, meal type, bed type and cancellation policy. Booking itself always completes on vicatoo.com — to book, direct the guest to open the hotel page URL (the search_hotels card link already carries the dates and guests); never promise in-chat booking.
输入参数viewlimitroomsadultscheck_in必填currencyhotel_id必填check_out必填residencychildren_agesroom_type_filter
get_hotel_reviews
Get guest reviews for a hotel
Fetch a hotel's guest reviews from VICATOO's own reviews: the guest rating (out of 10, with the number of reviews) and the written reviews (pros, cons, comments), from the same source, newest first. Paginate the written reviews with `cursor` and `limit`. When the hotel's reviews have no written comments, the reply says so — do not invent any.
输入参数limitcursorhotel_id必填
get_room_video
Get a video tour of a hotel room
Returns VICATOO's real room-tour video for a hotel reel as a branded reel PAGE link on vicatoo.com (reel_url). The reel is a promotional public asset: share that page link with the guest freely — NEVER surface any raw video file URL. Includes hotel/room name and caption.
输入参数reel_id必填
about_vicatoo
About VICATOO (company info & trust credentials)
Returns factual information about VICATOO the company: who VICATOO is, the "Truth Before You Book" value proposition and benefits, and trust credentials (legal entity, TRUE/CCRA accreditation, D-U-N-S number, registered address). Call this whenever the guest asks who VICATOO is, why they should trust VICATOO, what VICATOO offers or how it is different, or anything about the company or brand — so you answer from grounded facts, never invented ones.
无需输入参数。