Gjirafa Travel

Typeahead for @-mentioning one of the user's upcoming bookings in the ChatGPT composer.

search_trip_mentions

Use 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.

list_my_trips

Use 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.

preview_passenger_names

Use 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.

rate_trip

Use 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.

report_route_problem

Use 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.

resend_ticket_email

Use 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.

find_return_trip

Use 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_route_info

Use 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_bus_lines

Autocomplete for the Gjirafa Travel search form: cities and stations matching what the user is typing.

suggest_bus_locations

Use 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_travel_credits

Use 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_trip_notices

Corrects 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.

update_passenger_names