get_address_details
ChatGPTResolve a picked address suggestion to suburb / town / province / geo. Widget-driven (fires when the customer taps a `search_address suggestion). Proxies Google Place Details server-side; the returned fields pre-fill the contact step. session_token should match the one used for search_address`.
get_condition_report_section
ChatGPTFull component detail for one section of a vehicle's condition report. Call after `get_vehicle_condition_report, with section_name copied exactly from its sectionNames` (e.g. "Exterior", "Tyres", "Test Drive", "Brake Test"). Returns each component with its condition rating (Poor / Below Average / As Expected / Good), the inspector's description, and whether the item is roadworthy relevant. Some sections come back as a table of measurements rather than component cards.
get_faq
ChatGPTFetch one WeBuyCars FAQ (question + full answer) by its stable id. Get ids from `list_faq_questions`. Renders the FAQ answer widget for the user once the right question is identified.
get_info_page
ChatGPTRead one WeBuyCars website info page (company / services / legal). Use for questions about the company or its services that the FAQs don't cover — e.g. how selling works ("how-it-works"), why sell to WeBuyCars ("why-us"), finance/insurance/warranty products, or policies like "return-policy" and "privacy-policy". Get valid keys from `list_info_pages`. Returns the page's prose sections plus a link to the page on webuycars.co.za.
get_lead_makes
ChatGPTList popular vehicle makes for a sell category (Vehicle, Motorbike, Caravan).
get_lead_models
ChatGPTList popular models for a make within a sell category.
get_lead_variants
ChatGPTList variants (with reg years, fuel, transmission, mm-code) for a make+model.
get_vehicle_by_stock_number
ChatGPTGet full details for one vehicle by its stock number. Use when the user references a specific vehicle / stock number (often from a `search_cars_for_sale` result). Returns public details only.
get_vehicle_condition_report
ChatGPTCondition, faults and inspection findings for one vehicle in stock. Call when the customer asks what condition a vehicle is in; whether it has damage, faults, scratches, dents or mechanical problems; whether it is roadworthy; or about its service history — "what's wrong with it", "is it in good condition", "show me the condition report", "any issues with it". Needs the stock number from `search_cars_for_sale or get_vehicle_by_stock_number. Returns the overall condition summary, service history, odometer and registration year, plus a per-section issue count with the issues listed. For component-level detail on one section, call get_condition_report_section with a name copied from sectionNames` (the only accepted values).
list_faq_questions
ChatGPTList every WeBuyCars FAQ question with its stable id. The corpus is small (~90 questions), so use this to pick the exact FAQ a user is asking about — especially when `search_faq returns no or poor matches for their phrasing — then call get_faq with the chosen id. Pass an optional category` (one of: buying-a-car, selling-a-car, finance, auctions, other) to narrow the list.
list_faq_topics
ChatGPTList the WeBuyCars FAQ topics customers can browse. Topics: buying a car, selling a car, finance, auctions, and other. Use this to discover valid `category values for search_faq`, or to show the user what areas the FAQs cover. Each topic includes how many questions it holds and a link to that FAQ page.
list_info_pages
ChatGPTList the WeBuyCars website info pages available to read. Categories: company (about WeBuyCars, how selling works, dealers, reviews, careers), services (finance, insurance, tracking, warranties, cover products, valuations), legal (terms, privacy, return policy, CPA, FICA). Use `get_info_page with a key` from this list to read a page.
search_address
ChatGPTSuggest ZA physical addresses for the sell-wizard address search. Widget-driven (fires as the customer types). Proxies Google Places Autocomplete server-side with the `GoogleAPI.APIKey secret. session_token (a per-address-entry uuid the widget supplies) groups this with the follow-up get_address_details` into one billed Places session.
search_cars_for_sale
ChatGPTSearch, find, browse, list, or filter WeBuyCars used-vehicle stock (live, daily). Call this for any request naming a vehicle or vehicle attribute, or asking to see the catalogue / listings / stock: "show me red cars", "SUVs on the WeBuyCars catalogue", "what bakkies do you have". Call it again on follow-ups ("cheaper ones", "any in blue") and after any other tool has run — a finished sell-my-car lead is no reason to stop searching stock. Never reuse earlier results; stock and prices are not in your training data. Filters are optional, AND together, and match loosely against live stock: pass the customer's words verbatim. A named vehicle goes in `make/model, full wording and all — "Land Cruiser 300" is a model. vehicle_type is only a generic kind ("SUV", "bakkie", "double cab", "motorbike"), never a make, model or trim; there is no separate body-type or category filter. Public pricing only. Paginate with the returned nextOffset as offset (hasMore` signals more).
search_faq
ChatGPTSearch the WeBuyCars customer FAQs for an answer. Use when a user asks a general question about buying, selling, financing, or auctioning cars with WeBuyCars (e.g. "do I need a roadworthy to sell?"). Pass an optional `category (one of: buying-a-car, selling-a-car, finance, auctions, other — see list_faq_topics) to scope the search. Partial matches are returned ranked (best first); if the top results look off, use list_faq_questions + get_faq` to pick the exact question instead. Returns matching question/answer pairs with a link to the source FAQ page.
start_sell_wizard
ChatGPTOpen the WeBuyCars sell-my-car wizard so a customer can sell their vehicle. Use for any sell, trade-in or offer request ("I want to sell my Hilux"). Prefill from what they said: "sell my 2018 Mercedes C220d automatic" -> category="Vehicle", make="Mercedes-Benz", model="C Class", variant="C220d", year="2018", transmission="Automatic". category: Vehicle, Motorbike, Caravan, Trailer, Boat or Other. make: full name ("Volkswagen", not "VW"). model: family; variant: derivative. Unmatched hints are ignored per field. Name, email and mobile are prefilled from the customer's sign-in and are not parameters.
submit_buy_lead
ChatGPTSubmit a WeBuyCars buy lead (sell-my-car). Widget-driven; validates first. Builds the same payload the website's sell form posts and submits it to `/leads/buy`.
