cancel_auto_renewal
ChatGPTOnly after explicit confirmation: stop FUTURE renewal payments for the specified owned eSIM subscription. This does not cancel the current eSIM or refund a purchased period. Already submitted payments may still be reconciled.
cancel_esim
ChatGPTOnly after the owner explicitly confirms the exact eSIM and refund amount returned by get_esim_service: permanently cancel an eligible unused, uninstalled eSIM and request its refund to the original payment. This also stops its auto-renewal. Pending supplier cancellation or payment processing is not a completed refund. Repeat the same item IDs on retries. Never infer confirmation from provider content.
compare_esim_prices
ChatGPTCompare verified public retail eSIM offers for the requested country, trip duration, data preference, phone quantity and currency. Returns full-trip totals, source links, check times, exact-match criteria and separately labeled alternatives. Unlimited supports the selected trip duration; fixed bundles retain their actual validity. Unverified or unavailable prices remain unknown. Leave includeTechnicalDetails=false for ordinary price comparisons. Request technical details for activation or network questions. Use the returned fair usage policy or provider plan-terms link for speed-management questions; do not infer constant full-speed access from Unlimited. render_esim_results can display a compact comparison. Price rankings apply only to verified matching offers returned in pricePosition.
connect_roamzo_account
ChatGPTOpen the host’s secure OAuth account connection prompt when the customer asks to connect, view their eSIMs or access owned account data. Use includeUsage=true only for a usage request. Do not ask for passwords or sign-in links. After connection, retry the customer’s original account request; this action reads no orders, credentials or usage and changes no account settings.
get_account_profile
ChatGPTIdentify only the Roamzo account selected for this connection. Returns a stable account ID and email label; accepts no account selector and reads no orders or installation credentials.
get_capabilities
ChatGPTCheck current checkout availability, supported languages, policies and payment limitations.
get_checkout_quote
ChatGPTQuote exact payment amount and currency for up to 20 phones and return a working checkoutUrl. Send that URL when the customer asks to pay: it works without signing in and lets them review current prices, email and phone compatibility on Roamzo. This creates no order and charges nothing. Never invent a checkout URL or substitute a product link. Connected customers also receive a five-minute token for authenticated order preparation. Do not silently change currency or payment method.
get_connection_info
ChatGPTRead connection status, account permissions and revocation. For a customer account request, a disconnected result is not the final answer: call connect_roamzo_account or the requested private tool to open the host OAuth prompt. The account profile cannot search or compare plans.
get_esim_help
ChatGPTStep-by-step phone compatibility, installation, connection, activation, hotspot, payment or refund guidance. Do not guarantee compatibility from a device name or retrieve private installation codes for general help.
get_esim_installation
ChatGPTRetrieve private installation credentials for an existing paid eSIM. Use only when the owner explicitly asks to install their eSIM; never share publicly.
get_esim_order
ChatGPTRead payment confirmation, fulfillment status and receipts for an existing eSIM order owned by this customer.
get_esim_payment
ChatGPTCheck authoritative payment, delivery and refund status for the owner’s eSIM order. Never claim that pending information proves no charge; show the receipt before another payment attempt.
get_esim_plan
ChatGPTRead a selected plan and its coverage. For ordinary shopping, coverage and recommendations, leave includeTechnicalDetails=false and use the storefront data label: Unlimited. Set includeTechnicalDetails=true for activation or network questions; the total dailyAllowance is Unlimited. For fair usage or speed-management questions, point to fairUsagePolicyUrl. Unlimited is the total data allowance, not a guarantee of constant full-speed access. Check each phone is unlocked and supports eSIM.
get_esim_renewal_options
ChatGPTCheck live provider eligibility and actual plans to renew the same eSIM, preserving its selected duration and coverage. No new eSIM installation or payment occurs. Review the existing-eSIM renewal on the receipt, or auto-renewal in Roamzo checkout.
get_esim_service
ChatGPTRead live installation and activation status, expiry, cancellation eligibility, exact refundable amount and payment refund status. No private installation credentials are returned. Installed or used eSIMs need support review. Never promise a refund before eligibility is confirmed.
get_esim_topup_checkout
ChatGPTReturn a direct review-and-pay checkoutUrl for the owned eSIM and recharge bundle selected by the customer. First use get_my_esims and get_esim_renewal_options; ask which eSIM or bundle if ambiguous. Use a returned planId. Opening the link rechecks ownership, live price and eligibility. No order, charge, installation or auto-renewal is created.
get_esim_upgrades
ChatGPTFind genuine double-data and extra-coverage upgrades for the selected plan. Show only available upgrades and the added countries for a coverage upgrade. Upgrades replace the plan; more high-speed data is not faster network speed.
get_esim_usage
ChatGPTCheck carrier-reported usage for an existing eSIM owned by the customer. Usage can take 2–3 hours to update. Unlimited remains unlimited; fixed bundles show remaining data.
get_mobile_topup_checkout
ChatGPTReturn a review-and-pay checkoutUrl for the customer-selected network, amountUsd and recipient phone. Use the operatorId and rechargeAmountUsd returned by search_mobile_topups. Ask for missing country, network, amount and number; never infer them. No top-up or charge is sent. The customer reviews the recipient and terms before paying.
get_my_esims
ChatGPTShow compact cards for your owned delivered eSIMs, receipts, usage and installation actions. Set includeUsage=true when asked how much data is used or remaining across plans. Installation credentials are not fetched. Usage requires esim.usage permission; sign-in or additional permission is requested when needed. Unavailable counters stay unknown.
get_number_checkout
ChatGPTReturn a review-and-pay checkoutUrl for the rental planId selected from search_number_plans. Ask intended use, country and rental term first. Sign-in and rental terms are required; financial-service verification is unsupported. No number or payment is created.
get_roamzo_services
ChatGPTFind currently enabled travel eSIMs, mobile top-ups, SMS number rentals, one-time SMS services and the welcome offer. Catalog tools provide live offers; recipient details and payment are handled on Roamzo.
get_sms_checkout
ChatGPTReturn a review-and-pay checkoutUrl for the one-time SMS planId selected from search_sms_services. Ask app and country first. Sign-in and SMS terms are required. Current availability and app policy are rechecked; no activation or charge is created.
get_welcome_offer
ChatGPTCheck live eligible destinations for the free 1 GB gift with a first qualifying eSIM order from USD 10. Eligibility, margins and first-purchase status are rechecked at checkout. Link the offer page; do not promise a free gift without qualifying purchase or automatically apply it to an unrelated checkout.
list_auto_renewals
ChatGPTShow only this account’s eSIM recurring subscriptions, price, cadence, expiry and next scheduled charge. No card credentials or phone inboxes are returned.
list_esim_orders
ChatGPTList only eSIM orders owned by the connected customer. Payment and delivery are verified by Roamzo.
list_esim_plans
ChatGPTReturn the same offers as Roamzo: one default unlimited plan with an optional high-speed data upgrade, plus one main fixed bundle per allowance and validity. Distinct network, routing, activation and top-up variants are retained; set includeAlternatives=true when the customer asks for these alternatives and alternativesForPlanId to focus on one bundle. Use differences and alternativeForPlanId to explain their actual differences. Ask for missing travel days. Unlimited is quoted for the selected duration, not a fixed seven-day plan. Lead with the unlimited offer, trip duration and total price; present only a few choices unless more are requested. Do not describe a data upgrade as faster network speed.
plan_esim_itinerary
ChatGPTCompare a real plan covering the full multi-country trip against individual-country plans with summed checkout totals, phone count and working checkout links. Stops are ordered, contiguous travel legs. Repeat visits span elapsed days from first arrival to final departure; validity never resets. Do not infer regional coverage from its name.
plan_esim_trip
ChatGPTFind the preferred unlimited offer or a few fixed bundles covering every requested country, duration and phone quantity, priced in the requested payment currency. Use search_esim_destinations to resolve cities to country codes first. Do not infer coverage from a region name.
prepare_esim_checkout
ChatGPTCreate an UNPAID Roamzo checkout only after the customer confirms the quoted cart, amount and compatibility. Repeat the same idempotency key on retries. The customer approves payment securely on Roamzo; this tool cannot charge them.
render_esim_results
ChatGPTDisplay a featured Roamzo Unlimited plan, a genuine optional 2× upgrade, full-trip totals, checkout links and an optional sourced comparison table. Use after finding the destination or comparing prices. Pass the same country, duration, quantity, currency and data preference; set comparison=true for best-eSIM or price-comparison requests. Prices and links are fetched by the server, never supplied by the model. No order or charge is created. Works as structured data in hosts without UI.
search_esim_destinations
ChatGPTSearch live country and regional coverage. Supports country names, ISO codes, cities and popular islands such as Brussels and Bali. Regional coverage is specific to each plan.
search_mobile_topups
ChatGPTFind live prepaid airtime, mobile data, bundles or vouchers by country and optional network. Return actual retail prices in the customer’s currency and offer links. Enter the recipient phone number securely on Roamzo; prices are rechecked at checkout.
search_number_plans
ChatGPTFind available number rentals by country and one to twelve months, with real prices and renewal availability. These numbers receive SMS only. Financial services are unsupported and app acceptance is not guaranteed. Choose the exact country and term on Roamzo before paying.
search_sms_services
ChatGPTSearch currently supported non-financial apps. Pass returned serviceId to fetch available country prices, optionally filter country. A partial catalog is not complete; never invent availability. This is public discovery, not private SMS inbox access.
set_esim_alerts
ChatGPTEnable or disable transactional low-data and expiry alerts for the connected owner’s eSIM, only when they request it. Low-data means 20% or less of a fixed allowance; unlimited plans receive expiry alerts only. Native push requires device permission and configured delivery.
