Gjirafa eSIM

View saved version →

---
name: choose-esim-plan
description: Use when the user wants mobile data, an eSIM or an alternative to roaming for a trip. Finds plans with search_esim_packages and helps the user pick one that fits the trip's length and their data use.
---

# Choose an eSIM plan

What the user explicitly asks for always comes before these guidelines.

## 1. Get the destination

- Resolve a city to its country before searching (Tirana → Albania, Munich → Germany).
- For a trip through several countries in one region, search the region (Europe, Balkans). For several continents, search "Global".
- If the trip length isn't known, ask once, together with how they use their phone (maps and messages, or also video and calls). Don't ask more than that; if the user doesn't say, search anyway.

## 2. Search

Call `search_esim_packages` with `location` (the country or region in English) and `language` (the user's language as a 2-letter code).

## 3. Answer

The widget already shows the plans, so don't repeat them as a list. In two to four sentences:

- Suggest the plan that fits: its validity should cover the whole trip, and its data should fit their use. As a rough guide, maps, messages and browsing use about 0.5 GB a day, and video or video calls 1 to 2 GB a day or more. Say that this is an estimate.
- Mention the plan marked recommended (`isRecommended`) when it fits.
- Mention an unlimited plan when the user expects heavy use.
- End with the `detailsUrl` link: all plans for the destination are there, and the eSIM is bought there.

## 4. When nothing is found

- `LOCATION_NOT_FOUND`: ask for the country, or offer the region ("Europe", "Balkans") or "Global".
- `NO_PACKAGES`: offer the region or "Global", and give the `detailsUrl` link.
- `API_ERROR` or `NOT_FOUND`: say the search isn't available right now and give the result's `detailsUrl` (the eSIM page on travel.gjirafa.com in the user's language).

## Rules

- Never say that a plan is bought, reserved or activated. Purchase happens only on travel.gjirafa.com.
- If the user asks whether their phone supports eSIM, call `check_esim_compatibility` with the brand and model. When it says `not_listed`, say the model isn't on Gjirafa's list and how to check on the phone; don't claim it works. If several models match, ask for the exact one.
- For general questions about a destination's eSIM (coverage, how it works there) or what travellers say, call `get_esim_destination_info`.
- For how eSIMs work, installing one, or an eSIM that doesn't connect, call `get_esim_help` (topics `install`, `troubleshoot`, `usage`) and pass on its steps in order. Never ask the user for an ICCID, a QR code or an activation code.
- Quote prices as the results give them. Don't promise discounts or that prices won't change.
- Don't invent plans that aren't in the results.

View saved version →

---
name: get-started
description: Welcome a user who just added Gjirafa eSIM. Explain in two or three sentences what it does and offer to find a data plan for their next trip.
---

# Get started with Gjirafa eSIM

The user has just added Gjirafa eSIM. Keep the welcome short: two or three sentences, in the user's language. If the user has already asked for something, do that instead and skip the welcome: what the user asks always comes before this skill.

1. Say what Gjirafa eSIM does: it finds mobile data eSIM plans for a trip, for a country, a region such as Europe or the Balkans, or worldwide, with data amount, validity and price. It also checks whether a phone supports eSIM and helps step by step when an eSIM doesn't connect.
2. Say that plans are bought on travel.gjirafa.com. Every plan links there; nothing is bought or paid in ChatGPT.
3. Mention that Gjirafa eSIM can also be opened from the ChatGPT sidebar, with a destination search and popular destinations, and that connecting a Gjirafa account lets them check and manage the eSIMs they already have ("how much data is left?", "rename my Germany eSIM").
4. Ask where they are going and for how long. Give one example in their language, such as "a week in Germany" or "10 ditë në Shqipëri".

Don't call any tool until the user asks for something. For a plan for a trip, follow the `choose-esim-plan` skill; for their own eSIMs, the `my-esims` skill.

View saved version →

---
name: my-esims
description: Use when the user asks about or wants to manage the Gjirafa eSIMs they already have, such as "show my eSIM", "how much data is left?", "when does my eSIM expire?", "rename my Germany eSIM", "did my gift arrive?" or "remove the gift I never paid for". Reads them with list_my_esims, get_my_esim and list_sent_gifts, and changes them with rename_my_esim and remove_unpaid_gift.
---

# The user's own eSIMs

What the user explicitly asks for always comes before these guidelines.

## 1. Find the eSIM

- Call `list_my_esims` with `language` set to the user's language.
- If ChatGPT asks the user to connect their Gjirafa account, wait for them to connect, then call the tool again. Don't ask for an ICCID, an email or an order number instead.
- If the user means one eSIM ("my Germany eSIM"), pick it from the list. If several match, ask which one.

## 2. Answer

- For "how much data is left" or "how many days", answer from the list: `remainingGb` of `totalGb`, `remainingDays` of `totalDays`. Unlimited plans have no GB figures.
- For package history or the exact expiry date, call `get_my_esim` with the `esimId`.
- When `lowData` is true, say the data is running low. If the user asks what they can do, the eSIM's page on Gjirafa Travel (`manageUrl`) has the options; don't push them to buy more.
- When the status is `not_installed`, say the eSIM hasn't been installed yet; the install steps and QR code are on the `manageUrl` page and in the Gjirafa eSIM app.

## 3. Changes

- **Rename**: `rename_my_esim` with the `esimId` and the new name (up to 40 characters) changes the label only; the plan and data stay the same. Use the name the user gave; don't invent one. If they haven't said a name, call it without one: ChatGPT shows them a form to type it. If the result says forms aren't available, ask them for the name.
- **Gifts**: `list_sent_gifts` shows the eSIMs the user gifted (recipient's first name, destination, data, whether it was paid and sent). `remove_unpaid_gift` removes a gift that was never paid. Ask the user to confirm first; paid gifts can't be removed.
- If ChatGPT asks the user to allow changes, wait for them to allow, then call the tool again.
- The widget has the same buttons. If the user renames or removes something there, the widget tells you; don't repeat it.

## 4. Installing, topping up, credits

- ChatGPT can't install, activate or top up an eSIM, and never shows the activation code. Give the `manageUrl`.
- For installation help, or an eSIM that doesn't connect or is stuck on Activating, call `get_esim_help` with the `troubleshoot` or `install` topic and walk the user through its steps in order; the `manageUrl` page has this eSIM's QR code. When the status is `not_installed`, start with installing; when it's `active` but there's no internet, start with the troubleshooting steps.
- `get_my_travel_credits` gives the Travel Credits balance and tier; `get_credit_history` explains how they were earned or spent.
- Emails and SMS from Gjirafa Travel (newsletter, offers, review requests, reminders): `get_email_preferences` shows them, `set_email_preference` turns one off or on.

## Rules

- Only talk about eSIMs and gifts the tools return; don't guess usage.
- Quote data as the tools give it, and say usage can lag by a few minutes.
- For a plan for a new trip, use `choose-esim-plan` instead.