book_flight
ChatGPTGenerate a booking link to complete a flight booking on happyfares.in. After searching for flights, use this tool to get a direct link where the user can enter passenger details and pay. The link pre-fills the flight selection so the user does not need to search again. You need the origin, destination, date, and airline from the search results.
check_route_availability
ChatGPTCheck which flight routes are available and what dates they operate on. Useful for checking if a specific route exists before searching.
create_price_alert
ChatGPTSet a price alert: notify the user when a flight fare drops to or below a target price. Use when user says 'alert me if it drops to ₹X' or 'notify when cheaper'. Requires a contact identifier (email or phone) so HappyFares can notify the user when the alert triggers.
flight_hold_fare
ChatGPTLock the current flight fare for 24 hours by paying a small service fee (₹199). Useful when the customer is not ready to book immediately but wants to protect today's price from increasing. The ₹199 is credited back toward the final fare if they complete the booking within 24h. If the fare price drops, the customer pays the lower price and keeps the credit benefit. If the fare jumps by more than 5%, we refund the ₹199. DISAMBIGUATION RULES: Only call this AFTER search_flights when a SPECIFIC flight is identified (a single fareToken from a prior search result). If the customer says 'hold this fare' AFTER a multi-flight result without naming which one, FIRST ASK them to specify, e.g. 'Sure! Which one: the cheapest (IndiGo 6E-357, ₹7,760), the fastest, or a specific airline/time?' Do NOT silently pick one for them. If they say 'the cheapest' or 'any', then pick the lowest-fare flight from the most recent search_flights result and call this tool with that fareToken, and your confirmation reply MUST state which flight was held ('Holding IndiGo 6E-357 19:30 → 22:00 at ₹7,760'). Also require customer_email and customer_mobile before calling; ask if not provided.
flight_initiate_payment
ChatGPTOpen a secure payment link for a provisional flight booking. Call this AFTER flight_provisional_book returns a provisional_booking_id. Returns a payment URL the user clicks to pay via UPI / card / Net Banking / wallet / BNPL. On successful payment, our webhook automatically issues the real ticket and emails the PNR.
flight_redeem_hold
ChatGPTCheck for an active fare hold for a customer and prepare to redeem it. Use when the user returns within 24h of paying a hold fee and wants to complete the booking. Returns the locked fare details + a comparison to the current live fare + a recommendation (book at locked price, book at current price if lower, or refund if fare jumped >5%).
get_addons
ChatGPTGet available add-on services for a flight: meals, extra baggage, and seat selection options. Requires the search_key and flight details from a previous search_flights result.
get_booking_status
ChatGPTCheck the status of a HappyFares flight booking. You can look up by booking ID or PNR number. Returns booking details including passenger names, flight info, ticket status, and payment status.
get_fare_rules
ChatGPTGet cancellation, date change, and refund policies for a specific flight fare. Requires the search_key and flight_key from a previous search_flights result, plus the fare_id of the fare you want rules for.
get_flexible_dates
ChatGPTFind cheaper flight dates near a target travel date (±7 days). Returns a heatmap of fares by date so users can identify the cheapest day to fly. Use when user is flexible on dates or asks 'when is the cheapest day to fly DEL to BOM in June?'.
get_price_prediction
ChatGPTPredict whether flight prices will rise, fall, or stay stable for a route on a given date. Uses HappyFares' AI price model trained on 39 lakh actual bookings. Returns recommendation (buy now vs wait), expected price change %, deal label (Best Buy / Fair Price / Overpriced), and reasoning. Use this when user asks 'should I book now?' or 'will prices drop?'.
get_ticket_details
ChatGPTGet detailed ticket information including e-ticket numbers, fare breakdown, and itinerary for a specific booking.
interpret_flight_intent
ChatGPTUse this FIRST when the user describes a flight trip in natural language without giving explicit origin, destination, or date. Examples that need this: 'I want to go home for Diwali', 'plan a long weekend trip', 'visit my parents next month', 'beach trip with kids', 'surprise my wife on our anniversary', 'Christmas in Goa'. The tool reads the natural language, looks up Indian festivals and long weekends, infers destinations from vibe hints, and returns structured search parameters plus a clarifying question if any required info is missing. After getting the structured params, call search_flights with them. If clarifyingQuestion is non-empty, ask the user that question FIRST before calling search_flights. Currently routes to flight product only. Future versions will route to hotels/packages/activities/visa.
list_saved_travellers
ChatGPTLook up the customer's saved traveller profiles by email. Use this when the user is starting a booking AND has identified themselves (provided an email). Returns a list of past travellers (name, gender, DOB if saved) the user can pick from instead of re-typing. If the customer is new (no saved travellers), returns an empty list; proceed with normal collection. Always confirm with the user before reusing details: 'Same details as last trip? Shanti Jain · M · +91...'
low_fare_calendar
ChatGPTGet a fare calendar showing the cheapest flight prices across multiple dates for a route. Great for finding the cheapest day to fly. Provide a travel date and it will show fares for dates around that period.
price_insight
ChatGPTGet price intelligence for a specific route and date. Tells you if the current price is cheap or expensive compared to historical data, whether prices are trending up or down, and whether you should BUY NOW, WAIT, or BOOK SOON. The more searches you do through HappyFares, the smarter this tool gets.
recall_customer
ChatGPTRecall what HappyFares remembers about a returning customer. Use this when the user mentions their email or phone number, asks 'do you remember me?', or says things like 'I booked with you before'. Returns a short natural-language summary of their travel history and preferences (home airport, preferred airline, past bookings). Returns an empty result for first-time customers: present that as 'no history yet, but happy to help you find a flight'.
route_analytics
ChatGPTGet analytics on route popularity, trending searches, and demand patterns. Shows which routes are being searched most through HappyFares AI, and price trends for tracked routes. Internal tool for business intelligence.
search_flights
ChatGPTSearch for flights between two Indian cities. Returns all available flights with prices, airlines, timings, and stops — typically 10-20 options. Supports departure-time filtering (e.g., 'before 2pm', 'after 6am'). Use 3-letter IATA airport codes (DEL=Delhi, BOM=Mumbai, BLR=Bengaluru, MAA=Chennai, CCU=Kolkata, HYD=Hyderabad, GOI=Goa, COK=Kochi, JAI=Jaipur, AMD=Ahmedabad, LKO=Lucknow, PNQ=Pune, GAU=Guwahati). Dates can be in YYYY-MM-DD or DD-MM-YYYY format.
smart_search
ChatGPTAI-powered smart flight search that goes beyond basic search. Automatically checks: (1) Your exact date, (2) Nearby dates (+/- 2 days) for cheaper fares, (3) Alternate nearby airports that might have cheaper flights. Returns the best options with savings highlighted. Use this instead of search_flights when you want the best deal, not just a list.
suggest_flight_routes
ChatGPTUse this when the user wants suggestions for WHERE to fly (not WHEN/HOW MUCH). Returns ranked flight route suggestions for exploratory queries like 'where can I go from Delhi this weekend', 'suggest some beach destinations', 'popular routes from Mumbai', or partial typing input like 'Del to G'. Returns 3-10 suggested destinations with rationale (why each route is suggested) and current popularity. After the user picks one, call search_flights with the chosen origin + destination + date. Use interpret_flight_intent INSTEAD if the user described a trip with festivals/relationships ('going home for Diwali'). Use search_flights DIRECTLY if origin, destination, and date are all explicit.