add_product
ChatGPTAdd an Orient Electric product to the signed-in customer's account (their mobile number is used automatically — do NOT ask for it). dop: date of purchase in DD-Mon-YYYY format, e.g. 15-Nov-2025. product_category_id: cat_id from list_service_products or list_installation_products. product_name: product description from the catalogue. No serial number needed.
browse_category
ChatGPTList the subcategories of one Orient Electric product category as tiles. Use it when someone wants to see a whole category without a budget or any narrowing qualifier. Trigger phrases: "show me fans", "what fans do you have", "browse coolers", "your lighting range", "see water heaters", "pankhe dikhao", "what do you sell in lighting". If the customer named something narrower, such as a feature, a room or a budget, use search_products instead: this tool returns only subcategory links and does not rank products. category: one of fans, lighting, water-heaters, air-coolers, appliances, switchgear. Returns the category's subcategories as tiles, each linking to that subcategory on the website.
get_call_status
ChatGPTGet the signed-in customer's open service and installation requests, with their status. Use it whenever someone asks what is happening with a request they have already raised. Trigger phrases: "check call status", "check status", "status check", "track my request", "status of my complaint", "where is my technician", "is my request done". The verified mobile number is used automatically — do NOT ask for it. call_id: optional — filter to a specific call, blank for all open calls. Returns {"found": false} when no calls exist.
get_installation_address_step
ChatGPTWork out the NEXT address question to ask for an installation request. Read-only — it books nothing and saves nothing, so use it for the WHOLE address conversation. Call it with no arguments first, ask the customer the ONE thing its 'instruction' says, then call it again with their answer. Repeat until it returns next_step='ready', then call register_installation_call ONCE with the values it hands back. address_choice: "registered" or "new" (leave blank on the first call). pincode / area / house_street: only for a NEW address, added one at a time as this tool asks for them. 'area' must be one the customer picked from the options this tool returns.
get_product_defects
ChatGPTGet known defects and issues for an Orient Electric product. Use a returned defect string as the remarks when registering a service call.
list_categories
ChatGPTList all Orient Electric product categories (fans, lighting, water heaters, air coolers, appliances, switchgear) with their website URLs. Returns an object keyed by category slug, each with a display name and a URL to that category on orientelectric.com. Call this when the user wants an overview of what Orient Electric sells, before drilling into a specific category with browse_category or search_products.
list_installation_products
ChatGPTList Orient Electric products eligible for installation requests.
list_service_products
ChatGPTList all Orient Electric products in the service catalogue grouped by category. Use the description field as product_name and cat_id when calling add_product.
lookup_customer
ChatGPTLook up the signed-in customer and the products registered to their account. This is the first step of any service, repair, installation, registration or status request, because the rest of those flows need the customer record and their product list. Trigger phrases: "register a complaint", "my fan isn't working", "raise a service request", "i want installation", "book a technician", "register me", "service request", "complaint darj karo". The verified mobile number is used automatically — do NOT ask the user for it. Returns customer details + registered products with their customerProductIds. Returns {"found": false} when not registered (then do inline registration) — never raises.
lookup_pincode
ChatGPTGet valid area names for a 6-digit Indian PIN code. Always call this before registering or updating a customer address. Returns areaList with state, city, and area options for the user to choose from.
register_customer
ChatGPTRegister a new customer in Orient Electric's service system under the signed-in mobile number (used automatically — do NOT ask for it). Call lookup_pincode first to get a valid area name. customer_type: Customer or Dealer (default Customer).
register_installation_call
ChatGPTActually FILE the installation request for the signed-in customer (their mobile number is used automatically — do NOT ask for it). Call this ONCE, at the END, after get_installation_address_step has returned next_step='ready' — pass the address_choice (and, for a new address, the exact pincode/area/house_street) it handed back. Do the whole address conversation with get_installation_address_step, not with this tool. (If called with an incomplete address it still falls back to driving the address questions itself, one at a time, exactly like that tool — but prefer the read-only tool for the questions so the customer isn't asked to approve each step.) address_choice: "registered" or "new" (leave blank on the first call). pincode / area / house_street: only for a NEW address, supplied across turns as the tool requests them. 'area' must be one the customer picked from the lookup options this tool returns. Returns success:true and callId only once the installation is actually filed.
register_service_call
ChatGPTRegister a service or repair request for the signed-in customer's product (their mobile number is used automatically — do NOT ask for it). product_id: customerProductId from lookup_customer, e.g. C4. remarks: problem description — use a defect from get_product_defects. Returns success: true/false and callId on success. CRITICAL: only confirm to the user if success is true.
search_products
ChatGPTSearch the Orient Electric product catalogue and return matching products as cards. Use it when someone is looking for an Orient Electric product, or asks about the price, features or availability of one. Also use it when a customer shares an electricity bill and asks how much Orient products could save them: search for the products that would replace their current appliances, and base the savings estimate on the power ratings this tool returns. category: the customer's description of what they want, passed as they worded it. Descriptive wording affects the ranking, so keep it rather than reducing it to a bare category name. Examples: 'bldc ceiling fans', 'table fan with remote', 'desert cooler for a large room'. max_price: upper price limit in INR (0 = no limit). min_price: lower price limit in INR (0 = no limit). Set these only when the customer gave a budget. limit: how many products to return, up to 8. Returns up to 8 products as cards, each with its price and a link, plus a link to the full range on the website. Where Orient publishes them, a product also carries power_watts (or power_watts_options when variants differ) and star_rating; a product without power_watts has no published power rating. If the result carries a note, pass that on to the customer.
update_customer
ChatGPTUpdate a customer's address details in Orient Electric's service system (the signed-in mobile number is used automatically — do NOT ask for it). The service system dispatches a technician to the address held on the customer record and register:call carries no address of its own, so an installation at a new address has to be saved here first.