car_toggle_addon_selection
ChatGPTPersist a plan's optional-addon (benefit) selection server-side for an existing quote_uid, so the external Buy Now checkout page opens with the same selection applied. Called by the plans widget when the user checks/unchecks an optional benefit; it does not itself change the displayed price (the widget recalculates that locally). Not a normal entry point — the model should not need to call this directly.
create_car_insurance_quote
ChatGPTSubmit vehicle and driver details to create a car-insurance quote. Writes user data and creates an external quote record. This expects already-resolved reference ids (make, model, nationality, emirate, etc.) the way the intake form produces them, and is called by that form on submit — it is not a normal entry point. If the user wants a quote, call show_car_quote_intake_form instead.
get_car_makes
ChatGPTList available car manufacturers for a UAE car-insurance quote. This is a widget-internal lookup used by the intake form's vehicle picker. To start a quote, call show_car_quote_intake_form instead — do not call this directly.
get_car_models
ChatGPTList car models for a given make. Widget-internal lookup used by the intake form's vehicle picker. To start a quote, call show_car_quote_intake_form instead — do not call this directly.
get_car_quote_plans
ChatGPTFetch and display the available insurance plans for an existing quote_uid in an interactive widget. Use this when a quote_uid exists and the user wants to see, compare, or revisit its plans, including right after create_car_insurance_quote succeeds. If an earlier call for the same quote_uid already returned plans (total_plans > 0), answer follow-up questions from that result instead of calling again. If an earlier call returned 0 plans, insurers were still rating the quote; when the user next asks about that quote's plans or prices, call this tool again with the same quote_uid, since the count may have changed. If the user refers to a vehicle (e.g. "my Corolla") rather than a quote_uid, use the quote_uid shown for that vehicle earlier in this conversation; if more than one or none clearly matches, ask which quote they mean. Never guess a quote_uid. Read-only: does not create or change the quote.
get_car_reference_lists
ChatGPTFetch reference data: nationalities, emirates, UAE license durations, and manufacture years. Widget-internal lookup used by the intake form. To start a quote, call show_car_quote_intake_form instead — do not call this directly.
get_car_trims
ChatGPTList trims for a given car model and year. Widget-internal lookup used by the intake form's vehicle picker. To start a quote, call show_car_quote_intake_form instead — do not call this directly.
get_quote_advisor
ChatGPTFetch the insurance advisor assigned to an existing quote_uid. The advisor is assigned asynchronously (~2-3 minutes after the lead is created), so this may return no advisor immediately after quote creation. Intended for the plans widget to poll until the advisor is assigned; does not create or modify anything.
search_vehicles
ChatGPTSearch make, model and trim together for a UAE car-insurance quote. Widget-internal lookup used by the intake form's vehicle search field. To start a quote, call show_car_quote_intake_form instead — do not call this directly.
show_car_quote_intake_form
ChatGPTOpen the interactive intake form for a new UAE car-insurance quote. Use this when the user clearly asks to start a new quote. If the request is ambiguous about starting a new quote, ask one concise clarifying question before calling this tool. Do not use it for renewals, claims, changes to an existing policy, or merely because car insurance was mentioned or this tool was used earlier. If a quote_uid already exists, use get_car_quote_plans or get_quote_advisor for the user's existing quote instead of opening a new intake form. All parameters are optional free text — pass along anything the user has already given, by voice, text, or a document you read (name, nationality, date of birth, email, mobile number, emirate of registration, how long they've held a UAE licence, and the vehicle's make/model/trim/year). Pass exactly what was said or written (e.g. "Pakistani", "Dubai", "Toyota Corolla 2020") — do not invent or guess a value the user never gave, and do not attempt to resolve these to internal ids yourself; the form does that and will tell you what still needs the user's confirmation. Do not ask the user to repeat details already given in this conversation.
