BIG Charity Law

Use this when the user asks a specific question that requires an explanatory answer from the business knowledge base. Requires a query input and returns an AI-generated answer with follow-up suggestions. Use this tool for requests like: 'What is your return policy?', 'How does this service work?', 'Do you offer financing?'. If no relevant knowledge is configured, this tool returns a safe fallback response. Do NOT use for browsing product/service listings (use show_products tool instead). DO NOT use for basic business profile fields like phone/address/website (use show_business_info tool instead).

ask_question

Use this when the user wants to schedule a call or meeting with the business. Displays an interactive booking calendar widget with available dates and times. Use customerName, customerEmail, customerPhone, date (YYYY-MM-DD), and time (HH:MM) for both prefill and direct booking. Direct booking occurs only when customerName, customerEmail, date, and time are provided together; otherwise the widget opens for interactive scheduling. When direct booking succeeds, the widget opens in confirmation state. Use this tool for requests like: 'I want to book a call', 'I want to schedule a meeting', 'Book me for Tuesday at 3 PM'. Do NOT use for submitting general inquiries (use submit_contact_form tool instead). DO NOT use for listing products/services (use show_products tool instead).

book_appointment

Use this when the user asks for general business profile information. Displays a read-only business information widget with business name, description, email, phone, address, and website. Use this tool for requests like: 'Tell me about your business', 'What is your phone number?', 'What is your website?'. Do NOT use for detailed policy/procedure questions (use ask_question tool instead). DO NOT use for map/location exploration (use show_locations tool instead).

show_business_info

Use this when the user asks about business locations, addresses, nearby branches, directions, or which locations offer specific services. Displays an interactive locations map widget with map pins, location details (address, phone, services), and available providers at each location. Use optional inputs location_id (focus a specific location) and service_type (filter locations by service). Users can review location-specific provider availability and continue to directions or contact follow-up from the map context. Use this tool when the user asks queries like: 'Where are you located?', 'Which location offers grooming?', 'Find a nearby branch', or 'Show your locations on a map'. Do NOT use for general business profile details (use show_business_info tool instead). DO NOT use for browsing the full products/services catalog (use show_products tool instead).

show_locations

Use this when the user wants to browse what products or services the business offers. Displays an interactive product catalog widget with names, descriptions, pricing, images, and product actions. Catalog browsing is read-only; purchases are not completed through this tool. Use optional filters to narrow results: search, category, min_price, and max_price. Use this tool for requests like: 'What products do you sell?', 'Show me services under $300', 'Do you have running shorts?'. If the user requests a general catalog view, call with no filters to return all available products/services. Do NOT use for submitting inquiries (use submit_contact_form tool instead). DO NOT use for scheduling appointments (use book_appointment tool instead).

show_products

Use this when the user wants to contact the business or send a direct inquiry. Displays an interactive contact form widget that collects name, email, phone (optional), and message. This tool supports two modes: interactive form display and explicit submission. Use name, email, phone, and message for both context-derived prefill and explicit submission. Submission mode is triggered only when name, email, and message are provided together; otherwise the widget opens for interactive completion. Form submission is explicitly triggered by the user in the widget or by an explicit user request to submit now. Use this tool for requests like: 'I want to contact you', 'I want to discuss this', 'Send this message to the business'. Do NOT use for booking appointments (use book_appointment tool instead). DO NOT use for listing products/services (use show_products tool instead).

submit_contact_form