Best eSIM Plans
esim-plans-comparison-toolFull Description
Use this tool when users are looking to find the best eSIM plan for a trip abroad or compare the best travel eSIM providers. This tool provides a carousel listing the best eSIM plans for a given destination (a country, a list of specific countries or a region). The list can be customized based on the user's needs. The most important parameter is the duration of the user's trip, to only show eSIM plans that are valid for the full duration of the trip. If not specified by the user, you can infer a default duration based on the context of the conversation and the destination and ask a follow-up question to the user to validate the trip duration. Another important parameter is how much data the user needs for the trip. If the user specifies a minimum amount of GB, the tool will list the top 10 cheapest plans matching that minimum amount of GB. If not provided by the user, the tool will by default show the cheapest plan for a range of data packages (5GB, 10GB, 20GB, 50GB, Unlimited). In that case, you can ask follow-up questions and help the user figure out how much data they will need for their trip to get them to select the best plan. Use the user's language for the lang parameter, the supported languages are en, es, fr, de, it, pt, ro, pl, tr, ru, uk. Examples of prompts that should trigger this tool (Golden Prompts): "Best eSIM for {destination}", "Cheapest eSIM for {destination} ({duration_days} days, {data_gb} GB)", "Compare {provider A} vs {provider B} in {destination}", "Europe multi-country eSIM for {duration_days} days", "5G eSIM with tethering in {destination}", "Unlimited data in {destination}—fair use limits?", "Show esim plans for {destination}", "Under {budget} for {destination} (light use)", "{destination} + {destination} + {destination} eSIM—best value", "How to install my {provider} eSIM for {destination}?". Do not use the tools for generic questions about what eSIMs are, or for comparing plans for usage in the home country of the user. This tool should only be used for the use case of travel eSIM.
Parameters (4 required, 6 optional)
destinationCountriesarrayArray of destination country code (ISO 2) (e.g., FR, US) for which to compare eSIM plans. It could be a single country or multiple countries.
loadingSummarySentencestringBrief summary of the requested comparison in the user's language, to be displayed while loading (searching for the data). E.g., "Searching available eSIM plans for a trip to Tanzania". You can add context emojis. Do not add information about the user's specific providers.
summarySentencestringBrief summary of the comparison in the user's language. E.g., "Comparing eSIM plans for a trip to Tanzania". Do not add context emojis. Do not add information about the user's specific providers.
tripDurationintegerEstimated trip duration in days, used to suggest the best eSIM plans based on the length of stay in the destination country. If not specified by the user, you can infer a default duration based on the context of the conversation and the destination and ask a follow-up question to the user to validate the trip duration. Use value 88888 to indicate an unlimited trip duration.
budgetnumberThe maximum budget for the eSIM plan, expressed in the same currency as the "currency" parameter.
currencystringThe currency in which the user wish to see the pricing. It can be inferred from the context of the user or from the user's prompt. The widget will use USD by default if no currency is provided.
USDincludeCallsbooleanif true, the comparison will only include plans that comes with a phone number and the possibility to make and receive local calls.
FalselangstringLanguage code for localized content (supported languages: en, es, fr, de, it, pt, ro, pl, tr, ru, uk)
enesfrdeitptropltrruukenminGBnumberMinimum data allowance in GB for the eSIM plan. If not provided. Use the value 99999 to indicate unlimited data plans.
providersarrayBy default, the widget list the best plans based on their cost, this property can be used to also add some plans of the specific providers the user wants to see in the comparison carousel (accepted inputs airalo, holafly, ubigi, flexiroam, gigsky, nomad, saily, yesim, airhub, roamless, alosim, gomoworld, instabridge, etravelsim, travelsim, esim-me, sim-local, global-yo, worldsim, iroamly, mobilesim, jetpac, esim4travel, kolet, maya, turksim).