orkestra-app.com

This server lets you find salons, spas and clinics and book appointments for a customer. ALWAYS follow this exact order: 1. search_businesses(...) - find the business. Results are only meaningful when tied to a place, so pass lat and lng if you know where the customer is, otherwise pass the city they named. Pass category for the kind of business and query only when you have a business name. If the customer named no place at all, call it with category alone: it returns no businesses and the list of cities that have that category, so you can ask which city and then search again. Never offer a business from a city the customer has not asked about. Returns each match with a "slug". The slug is required by every other tool. 2. get_business(slug) - get the services (each has an id, name, price, durationMinutes), staff, locations, timezone and currency. 3. get_availability(slug, serviceId, date) - get real bookable time slots for that service on that date (YYYY-MM-DD). ONLY times returned here can be booked. Never invent a time. 4. create_booking(...) - book one of those slots for the customer. Rules for create_booking: - A phone number is REQUIRED. Always ask the customer for their phone number and confirm the service, date, time and name BEFORE calling create_booking. Never invent or guess a phone number. - If get_business returns more than one location, you MUST pass locationId. If you omit it, the tool returns the list of valid locationIds to choose from. - The time must be one of the slots from get_availability for the same date. Handling the create_booking response - THIS IS IMPORTANT: - If the response has "paymentRequired": false (no checkoutUrl), the booking is CONFIRMED. Tell the customer they are booked for the given date and time. - If the response has "paymentRequired": true and a "checkoutUrl", the booking is NOT yet confirmed. A deposit is required. Tell the customer they are penciled in, that a deposit of the given amount is required to confirm, and give them the checkoutUrl link to pay it themselves. You cannot pay it for them. The slot is held until they pay. You can use get_booking_status later (with the pendingBookingId or appointmentId plus statusToken from create_booking) to check whether a deposit booking has been paid and confirmed.