check_esim_compatibility
ChatGPTUse this when the user asks whether their phone, tablet, laptop or watch supports eSIM (e.g. 'does my iPhone 13 work with eSIM?', 'can I use an eSIM on a Galaxy A54?'). Checks the model against Gjirafa Travel's list of eSIM devices. Pass the brand and model as the user gives them.
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_esim_destination_info
ChatGPTUse this when the user asks general questions about using a Gjirafa eSIM in a country or region, or what other travellers say about it (e.g. 'does the Turkey eSIM work everywhere?', 'are the Germany eSIMs any good?'). Returns the destination's FAQ from Gjirafa Travel and the latest reviews with the average rating. For plans and prices, use search_esim_packages.
get_esim_help
ChatGPTUse this when the user asks how an eSIM works or has a problem with one: how to install it (QR code, internet needed), it doesn't connect or is stuck on Activating, mobile data and data roaming settings, using it next to a physical SIM or with WhatsApp, hotspot, how long it lasts, Life Saver Mode, sending an eSIM as a gift, or Gjirafa Money, cashback and referrals. Answers come from Gjirafa's FAQ and the Gjirafa eSIM app's troubleshooting guide; pass the steps on rather than guessing. Whether a phone supports eSIM: check_esim_compatibility. Plans: search_esim_packages.
get_my_esim
ChatGPTUse this when the user asks about one of their own eSIMs in detail: data used and left per package, when each package was activated and when it expires. Takes the esimId from list_my_esims. Installing and topping up happen on Gjirafa Travel through the returned link; this tool doesn't change the eSIM.
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.
list_my_esims
ChatGPTUse this when the user asks about their own Gjirafa eSIMs (e.g. 'show my eSIM', 'how much data do I have left?', 'when does my eSIM expire?'). Returns the signed-in user's eSIMs with destination, status (active or not installed yet), data left, days left, and a link to install, top up or manage each one on Gjirafa Travel. Needs the user's Gjirafa account to be connected. Don't use it to find plans for a new trip; use search_esim_packages.
list_sent_gifts
ChatGPTUse this when the user asks about eSIMs they gifted to someone: who to (first name), destination, data, validity, and whether it was paid and sent.
open_gjirafa_esim
ChatGPTOpens the Gjirafa Travel eSIM plans in the ChatGPT sidebar or beside the conversation.
remove_unpaid_gift
ChatGPTRemoves an eSIM gift the user started but never paid for (status pending), so it no longer shows in their gifts. Paid gifts can't be removed. Takes the giftId from list_sent_gifts; ask the user to confirm first.
rename_my_esim
ChatGPTUse this when the user wants to rename one of their own eSIMs (e.g. 'call my Germany eSIM Work phone'). Takes the esimId from list_my_esims and the new name. Only the label changes; the plan and data don't. If the user hasn't said the new name, call it without one: ChatGPT shows them a form to type it. If the result says forms aren't available, ask the user for the name.
search_esim_mentions
ChatGPTTypeahead for @-mentioning one of the user's eSIMs in the ChatGPT composer.
search_esim_packages
ChatGPTUse this when the user wants an eSIM, a travel or tourist SIM, mobile data or an alternative to roaming for a trip to a country or region (e.g. 'I need internet in Germany', 'cheap data plan for Europe', 'how do I stay online in Tirana?'). Returns the Gjirafa Travel eSIM data plans for that destination (data amount, validity and price) with links to Gjirafa Travel, where the user can buy them. Accepts a country, a region (e.g. Europe, Balkans) or 'Global'. Do not use it for an eSIM the user already has (list_my_esims shows those), to activate, install or troubleshoot one, for physical SIM cards or phone contracts, or to check whether a phone supports eSIM (check_esim_compatibility does that). For what travellers say about a destination's eSIMs or its FAQ, use get_esim_destination_info.
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.
show_esim_destination
ChatGPTShows the eSIM plans of a destination the user picked in the Gjirafa eSIM picker, by its exact slug.
suggest_esim_destinations
ChatGPTAutocomplete for the Gjirafa eSIM picker: countries and regions matching what the user is typing.
