cancel_booking
ChatGPTCancels one of the user's own bookings and refunds it to the original payment method, under the booking's Flex terms. Can't be undone. Call it without a confirmationCode: ChatGPT then shows the user a form with the refund, and the booking is cancelled only if they confirm there. If the result says confirmation forms aren't available, call preview_cancel_booking, show the user the refund, and once they confirm call cancel_booking with its confirmationCode.
create_reservation
ChatGPTLegacy tool. Booking is no longer possible inside ChatGPT: returns a link to Gjirafa Travel, where the user can book. It doesn't create a reservation.
find_return_trip
ChatGPTUse this when the user wants to travel back after one of their own bookings (e.g. 'when can I come back?', 'book my return'). Returns the buses on the way back: how many a day, the first and last departure, the price from, and the next dates, with a link to Gjirafa Travel, where the user picks a bus and books.
get_credit_history
ChatGPTUse this when the user asks how they earned or spent their Gjirafa Travel Credits (e.g. 'why do I have €4 in credits?'). Returns the latest credit movements: earned, spent, expired or reversed, with amounts and dates.
get_email_preferences
ChatGPTUse this when the user asks which emails or SMS Gjirafa Travel sends them, or wants to stop or start them (newsletter, offers, trip review requests, reminders about unfinished bookings, SMS). Booking confirmations and tickets always arrive and aren't listed. Needs the user's Gjirafa account to be connected.
get_my_travel_credits
ChatGPTUse this when the user asks about their Gjirafa Travel Credits: balance, cashback tier, how many purchases to the next tier, and when the credits expire. Needs the user's Gjirafa account to be connected.
get_my_trip
ChatGPTUse this when the user asks about one of their own bookings in detail: legs and stations, departure and arrival times, passengers, what was paid, the Flex option, and what can still be done (cancel, fix passenger names, resend the ticket, rate the trip). Takes the booking ID from list_my_trips or from the user. This tool doesn't change the booking; the preview_… and action tools do, and date changes happen on Gjirafa Travel.
get_route_info
ChatGPTUse this when the user asks about a bus route in general rather than a specific day: how many buses a day, the first and last departure, the usual price and travel time, the distance, which companies drive it, where the stations are, and what other travellers say (e.g. 'how long is the bus from Pristina to Munich?', 'which companies go to Skopje?', 'where does the bus to Tirana leave from?'). Same Balkans scope as search_bus_lines. For buses on a given date, use search_bus_lines.
get_travel_help
ChatGPTUse this when the user asks how Gjirafa Travel works or what its rules are, rather than about a route or one of their own bookings: how to book and pay (cards, Apple Pay, Google Pay; no paying on the bus), tickets (no need to print, seats are given on the bus), what Travel Flex is and how many hours before departure each option allows cancelling or changing, refunds when the operator cancels a trip, changing a date or a name, open returns, the student discount, the service fee, the account, or how to contact Gjirafa Travel. Answers come from Gjirafa Travel's FAQ; pass them on rather than guessing. For the user's own booking, use the booking tools.
get_trip_notices
ChatGPTUse this when the user asks whether there are delays, changes or announcements for one of their own trips (e.g. 'any delays for my bus tomorrow?'). Returns the operators' notices for that booking's legs on its dates.
get_weekly_departures
ChatGPTUse this when the user asks which days buses run between two places, or wants to compare days before picking one (e.g. 'which days is there a bus to Munich?', 'is there a bus on Sunday?'). Returns, for the date and the 6 days after it, how many buses run and how many can be booked online. For the buses on one day, use search_bus_lines.
list_my_trips
ChatGPTUse this when the user asks about their own Gjirafa Travel bus bookings or trips (e.g. 'show my bookings', 'when does my bus to Tirana leave?', 'my upcoming trips', 'my past trips'). Returns the signed-in user's bookings like My bookings on Gjirafa Travel: newest purchase first, each one active (the bus hasn't left yet, or an open return can still be booked), completed, cancelled or refunded, with route, departure and arrival, operator, transfers, passengers, purchase date and a link to manage it. when='upcoming' gives only active ones, soonest first (for 'when does my bus leave?'); when='past' the others. Needs the user's Gjirafa account to be connected. Don't use it to find new routes; use search_bus_lines.
open_gjirafa_travel
ChatGPTOpens the Gjirafa Travel bus search in the ChatGPT sidebar or beside the conversation.
preview_cancel_booking
ChatGPTUse this when the user asks what they'd get back if they cancelled one of their own bookings, or when cancel_booking says confirmation forms aren't available. Doesn't cancel anything: it shows whether the booking can be cancelled now, how much is refunded to the original payment method and what isn't (service fee and add-ons such as Flex), and returns a confirmationCode. To cancel, show the user the refund and ask them to confirm before calling cancel_booking with that code.
preview_passenger_names
ChatGPTUse this when update_passenger_names says forms aren't available and the user wants to correct a passenger's name on one of their own bookings. Doesn't change anything: it checks that the booking's Flex allows it, shows each name before and after, and returns a confirmationCode. Passenger N is the Nth name in get_my_trip. Ask the user to confirm, then call update_passenger_names with the same changes and the code.
rate_trip
ChatGPTUse this when the user wants to rate or review one of their own finished trips. Takes a rating from 1 to 5, an optional comment, and optionally what could be better (ids from reviewOptions in get_my_trip). Only after the trip has ended, and once per booking. Ask the user for the rating; don't make one up.
report_route_problem
ChatGPTUse this when the user says a bus line shown on Gjirafa Travel is wrong or something went wrong on a trip: wrong schedule or departure point, a different price, the bus didn't come or was late, or other wrong information. Sends the report to Gjirafa Travel's team, who check and correct the line; it doesn't change a booking or get a refund. Report only what the user told you, and tell them before sending.
resend_ticket_email
ChatGPTUse this when the user asks to get their ticket or booking confirmation email again for one of their own bookings. Sends it to the email address of the signed-in Gjirafa account (it can't be sent anywhere else), once per booking.
search_bus_lines
ChatGPTUse this when the user wants buses between two places on a day: departure and arrival times, timetables, bus or coach tickets, operators, prices, or 'is there a bus from X to Y'. Covers routes within the Balkans (Kosovo, Albania, North Macedonia, Montenegro) and between the Balkans and the rest of Europe, such as Germany, Switzerland or Austria to Kosovo or Albania. Do not use it when neither place is in the Balkans, or for flights, trains, driving or general travel advice. For a route in general (usual travel time, companies, stations, reviews) use get_route_info; for which days buses run, get_weekly_departures. If the user didn't give a date, use today; if the date is ambiguous, ask first. When there are no buses that day, the result says the next day with buses. Results link to Gjirafa Travel, where the user sees every route and books. Set 'language' to the user's language (en, sq, de, fr, es, it; default en). Give city names in Albanian only when 'language' is 'sq'; otherwise in English with correct spelling (e.g. 'Pristina', 'Tirana', 'Skopje').
search_trip_mentions
ChatGPTTypeahead for @-mentioning one of the user's upcoming bookings in the ChatGPT composer.
set_email_preference
ChatGPTTurns one kind of Gjirafa Travel message off or on for the signed-in user: newsletter, promotional (offers), review (trip review requests), reminders (unfinished bookings) or sms. Use the type the user asked about; for 'stop all marketing' call it once per type. SMS can be turned off here; turning it on needs a phone number, on Gjirafa Travel.
suggest_bus_locations
ChatGPTAutocomplete for the Gjirafa Travel search form: cities and stations matching what the user is typing.
update_passenger_names
ChatGPTCorrects passenger names on one of the user's own bookings, within its Flex limits. Call it without a confirmationCode: ChatGPT then shows the user a form with every passenger's names to correct and save (pass the corrections you already know as changes to fill it in). If the result says forms aren't available, call preview_passenger_names and, once the user confirms, update_passenger_names with the same changes and its confirmationCode.