plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "gjirafa-esim",
  "version": "1.7.1",
  "description": "Find mobile data eSIM plans for a trip: countries, regions such as Europe or the Balkans, or worldwide, with data amount, validity and price, check whether a phone supports eSIM, and get step-by-step help installing an eSIM or when it doesn't connect. Signed in with a Gjirafa account, see your own eSIMs with the data and days left, rename them, check the eSIMs you gifted and choose which emails you get. Plans are bought on travel.gjirafa.com.",
  "author": {
    "name": "Gjirafa",
    "url": "https://travel.gjirafa.com"
  },
  "homepage": "https://travel.gjirafa.com/en/esim",
  "keywords": [
    "esim",
    "travel esim",
    "mobile data",
    "internet abroad",
    "roaming",
    "data plan",
    "esim compatibility",
    "europe",
    "balkans",
    "kosovo",
    "albania",
    "germany",
    "turkey",
    "usa",
    "gjirafa"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Gjirafa eSIM",
        "shortDescription": "eSIM data plans for travel",
        "longDescription": "See eSIM data plans for your trip, for countries, regions like Europe or the Balkans, or worldwide.\n\nAsk in your own words, for example \"I need mobile data in Germany\" or \"data plan for a week in Europe\". Gjirafa eSIM shows each plan like the Gjirafa website does: data amount, validity, price and the most popular plan, with regional plans showing how many countries they cover. Open the full view to see every plan for the destination and filter by data, unlimited or validity. Open Gjirafa eSIM from the sidebar to search for a destination or pick a popular one, with the price per day.\n\nNot sure your phone works with eSIM? Ask \"does my iPhone 13 support eSIM?\" and Gjirafa eSIM checks it against its list of supported phones, tablets and watches. You can also ask what travellers say about a destination's eSIMs and read its FAQ.\n\nIf your eSIM doesn't connect, is stuck on Activating or you're not sure how to install it, ask: you get the Gjirafa eSIM app's step-by-step troubleshooting guide (in 11 languages) and the installation guide for iPhone and Android. Questions such as \"can I keep WhatsApp on my number?\" or \"can I share the data with my laptop?\" are answered from Gjirafa's FAQ.\n\nConnect your Gjirafa account to ask about the eSIMs you already have: \"show my eSIM\", \"how much data do I have left?\" or \"when does my eSIM expire?\". You see the data used and the days left for each eSIM and its packages, like in the Gjirafa eSIM app. You can rename an eSIM, see the eSIMs you gifted and remove a gift you never paid for, and choose which emails and SMS Gjirafa Travel sends you.\n\nEvery plan links to Gjirafa Travel, where you can see all plans for the destination, buy your eSIM, install it and top it up. Plans can be browsed in 16 languages; the views of your own eSIMs are in English, Albanian and German.",
        "developerName": "Gjirafa",
        "category": "Travel",
        "capabilities": [
          "Find eSIM data plans for a country, a region or worldwide",
          "Compare data amount, validity and price, and filter every plan in the full view",
          "Check whether a phone, tablet or watch supports eSIM",
          "Step-by-step help when an eSIM doesn't connect, from the Gjirafa eSIM app's troubleshooting guide",
          "Answer how eSIMs work: installing, keeping your number and WhatsApp, hotspot, gifts",
          "Read a destination's eSIM FAQ and travellers' reviews",
          "Show your eSIMs with data used and days left (Gjirafa account)",
          "Show an eSIM's packages: data used, validity and expiry",
          "Rename your eSIMs",
          "See the eSIMs you gifted and remove unpaid gifts",
          "Show your Travel Credits balance, tier and history",
          "Choose which emails and SMS Gjirafa Travel sends you",
          "Open the eSIM picker and your eSIMs in the sidebar"
        ],
        "websiteURL": "https://travel.gjirafa.com/en/esim",
        "supportURL": "https://travel.gjirafa.com/en/contact",
        "privacyPolicyURL": "https://travel.gjirafa.com/en/privacy",
        "termsOfServiceURL": "https://travel.gjirafa.com/en/terms",
        "defaultPrompt": [
          "I'm going to Germany for a week. Which eSIM data plan fits?",
          "Does my iPhone 13 support eSIM?",
          "eSIM p\u00ebr Shqip\u00ebrin\u00eb p\u00ebr 10 dit\u00eb"
        ],
        "brandColor": "#E0245E",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png",
        "brandColorDark": "#EC4899"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Country, asked directly",
              "prompt": "eSIM for Germany",
              "tools_triggered": "search_esim_packages",
              "expected_behavior": "Up to 8 plan cards like on travel.gjirafa.com: the flag and destination, data amount, validity, the old and current price and a View button; the recommended plan has the Most popular badge, and up to 2 unlimited plans are included. View and See all open travel.gjirafa.com/en/esim/germany (the English page); the expand button opens every plan with filters. No sign-in is needed."
            },
            {
              "description": "Indirect request: a city resolves to its country",
              "prompt": "I'm flying to Tirana next week, how do I get mobile internet?",
              "tools_triggered": "search_esim_packages",
              "expected_behavior": "The tool is called with location \"Albania\" and the widget shows Albania plans."
            },
            {
              "description": "Device compatibility: a listed phone and one that isn't",
              "prompt": "Does the iPhone 13 support eSIM? And the iPhone 7?",
              "tools_triggered": "check_esim_compatibility",
              "expected_behavior": "check_esim_compatibility is called for each phone. The iPhone 13 is on Gjirafa Travel's list of eSIM devices, so ChatGPT says it supports eSIM, adding that phones from mainland China, Hong Kong or Macau and carrier-locked phones may not. The iPhone 7 isn't on the list, so ChatGPT says it may not support eSIM and how to check in the phone's settings; it doesn't claim it works. A link to the full device list is given."
            },
            {
              "description": "The user's own eSIMs, and renaming one (reviewer test account)",
              "prompt": "Show my eSIMs, then rename the first one to Work phone.",
              "tools_triggered": "list_my_esims, rename_my_esim",
              "expected_behavior": "If the account isn't connected, ChatGPT shows the Connect button for Gjirafa (login.gjirafa.com). Once connected, the test account's eSIMs appear as cards with the destination, status, data used and days left, and a View Details button. No ICCID, QR code or activation code is shown. For the rename, ChatGPT asks to allow changes in the Gjirafa account the first time and asks the user to confirm, then calls rename_my_esim with the name Work phone. The eSIM's detail view shows the new name; only the name changes, not the plan or data."
            },
            {
              "description": "An eSIM that doesn't connect: the app's troubleshooting steps, asked in Albanian",
              "prompt": "E instalova eSIM-in p\u00ebr Turqin\u00eb por nuk lidhet me internet. \u00c7far\u00eb t\u00eb b\u00ebj?",
              "tools_triggered": "get_esim_help",
              "expected_behavior": "get_esim_help is called with the troubleshoot topic and language \"sq\". ChatGPT answers in Albanian with the Gjirafa eSIM app's steps in order: being in the covered country, turning the eSIM line on, choosing it for mobile data, turning data roaming on for it, Activating being normal before arrival, then the general fixes (airplane mode, restart, manual network). It links the installation guide on travel.gjirafa.com/sq/esim/help and asks for no ICCID, QR code or activation code."
            }
          ],
          "negative": [
            {
              "description": "A physical prepaid SIM card, not an eSIM: the tools aren't called",
              "prompt": "Where can I buy a physical prepaid SIM card at Munich airport?"
            },
            {
              "description": "The user's carrier roaming plan: the tool isn't called",
              "prompt": "What does Vodafone charge for roaming in Albania?"
            },
            {
              "description": "A phone contract at home, not a travel eSIM: the tools aren't called",
              "prompt": "Which mobile phone contract is cheapest in Germany for a year?"
            }
          ]
        },
        "demo_recording_url": "https://w3mhh8jtzt.gjirafa.net/travel/gpt-plugin/gjirafa-esim-demo.mp4",
        "commerce": false,
        "commerce_description": "No purchase, top-up or payment happens in ChatGPT. Plans are informational and link to the destination's plan page on travel.gjirafa.com, where users buy the eSIM. Signed-in users can read the eSIMs they already have, rename them, see the eSIMs they gifted and remove a gift that was never paid; installing and topping up happen on travel.gjirafa.com."
      },
      "publication": {
        "release_notes": "Plan search, phone compatibility and eSIM help work without connecting a Gjirafa account. ChatGPT asks you to connect only when you ask about your own eSIMs, gifts, Travel Credits or email preferences.",
        "translations": {
          "sq-AL": {
            "subtitle": "Plane eSIM p\u00ebr udh\u00ebtime",
            "description": "Gjej plane eSIM me internet celular p\u00ebr udh\u00ebtimin t\u00ebnd: p\u00ebr shtete, rajone si Evropa ose Ballkani, ose p\u00ebr gjith\u00eb bot\u00ebn, me sasin\u00eb e t\u00eb dh\u00ebnave, vlefshm\u00ebrin\u00eb dhe \u00e7mimin, si n\u00eb faqen e Gjirafa Travel. Hape pamjen e plot\u00eb p\u00ebr t'i par\u00eb t\u00eb gjitha planet dhe p\u00ebr t'i filtruar.\n\nPyet \"a e mb\u00ebshtet iPhone 13 eSIM-in?\" dhe Gjirafa eSIM e kontrollon telefonin n\u00eb list\u00ebn e pajisjeve t\u00eb mb\u00ebshtetura. Mund t\u00eb lexosh edhe pyetjet e shpeshta dhe vler\u00ebsimet e udh\u00ebtar\u00ebve p\u00ebr nj\u00eb destinacion.\n\nN\u00ebse eSIM-i nuk lidhet ose nuk di si ta instalosh, pyet: merr hapat e zgjidhjes s\u00eb problemeve nga aplikacioni Gjirafa eSIM dhe udh\u00ebzuesin e instalimit p\u00ebr iPhone dhe Android.\n\nLidh llogarin\u00eb t\u00ebnde Gjirafa p\u00ebr t\u00eb par\u00eb eSIM-et e tua: t\u00eb dh\u00ebnat e p\u00ebrdorura dhe dit\u00ebt e mbetura, si n\u00eb aplikacionin Gjirafa eSIM. Mund ta riem\u00ebrtosh nj\u00eb eSIM, t'i shoh\u00ebsh dhuratat q\u00eb ke d\u00ebrguar dhe t\u00eb zgjedh\u00ebsh cilat email-e merr.\n\n\u00c7do plan t\u00eb \u00e7on n\u00eb Gjirafa Travel, ku e blen, e instalon dhe e rimbush eSIM-in."
          },
          "de-DE": {
            "subtitle": "eSIM-Datentarife f\u00fcr Reisen",
            "description": "Finde eSIM-Datentarife f\u00fcr deine Reise: f\u00fcr L\u00e4nder, Regionen wie Europa oder den Balkan oder weltweit, mit Datenvolumen, Laufzeit und Preis, so wie auf der Gjirafa-Website. In der Vollansicht siehst und filterst du alle Tarife.\n\nFrag \"Unterst\u00fctzt mein iPhone 13 eSIM?\" und Gjirafa eSIM pr\u00fcft das Ger\u00e4t anhand der Liste unterst\u00fctzter Ger\u00e4te. Du kannst auch die h\u00e4ufigen Fragen und die Bewertungen anderer Reisender zu einem Reiseziel lesen.\n\nVerbindet sich deine eSIM nicht oder wei\u00dft du nicht, wie du sie installierst? Frag einfach: Du bekommst die Schritt-f\u00fcr-Schritt-Hilfe aus der Gjirafa-eSIM-App und die Installationsanleitung f\u00fcr iPhone und Android.\n\nVerbinde dein Gjirafa-Konto, um deine eSIMs zu sehen: verbrauchte Daten und verbleibende Tage, wie in der Gjirafa-eSIM-App. Du kannst eine eSIM umbenennen, deine verschenkten eSIMs sehen und w\u00e4hlen, welche E-Mails du bekommst.\n\nJeder Tarif f\u00fchrt zu Gjirafa Travel, wo du die eSIM kaufst, installierst und aufl\u00e4dst."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}