search-venues
Search venues
Search Bronjoy's catalogue of service businesses in Uzbekistan by keyword,
city and category.
WHEN TO USE: the user is looking for a place ("barbershop in Tashkent",
"dentist near Chilanzar", "car wash open now"). Start here — every other
tool takes the `slug` this returns.
Results are ranked, compact, and include `is_bookable`, which decides what
you can offer next: bookable venues can go through check-availability →
request-booking-code → book-appointment, the rest can only be described and
phoned. Names and addresses come back in Russian or Uzbek; quote them as-is.
輸入參數citylimitquerycategorybookable_only
Full public profile for one venue: address, opening hours, what it offers,
amenities, payment methods, website and whether it can be booked online.
WHEN TO USE: after search-venues, when the user asks anything about a
specific place — "are they open on Sunday", "do they do colouring", "where
exactly is it", "how much".
This is the right tool for the ~99% of the catalogue that is not bookable:
it carries everything needed to answer a question or send the user there in
person. The phone number is masked here — call reveal-phone only when the
user actually wants to ring them.
輸入參數slug必填
reveal-phone
Reveal venue phone
The venue's real phone number.
WHEN TO USE: the user wants to call — typically because the venue is not
bookable online, or they want to ask something no profile field answers.
Deliberately a separate call from get-venue, which returns a masked number.
Reveals are rate limited per caller: request them one at a time, for a venue
the user has actually chosen, never in bulk across search results.
輸入參數slug必填
check-availability
Check venue availability
Bookable services and open time slots for a venue on a given date.
WHEN TO USE: the user has picked a venue with `is_bookable: true` and wants
a time. Call without `service_id` first to see the services and their
prices, then again with one to get its slots.
Returns an explicit refusal for venues that are not set up for online
booking — do not try to work around it, offer the phone number instead.
Slot times are in the venue's timezone and are exactly the values
book-appointment expects.
輸入參數date必填slug必填service_id
request-booking-code
Send booking confirmation code
Send the user a 6-digit confirmation code, which book-appointment then
requires.
WHEN TO USE: the user has chosen a venue, a service and a slot, and has
given you their email address or phone number. Call this before
book-appointment — a booking without a code is rejected.
YOU DO NOT RECEIVE THE CODE. It goes to the user's own inbox or phone; ask
them to read it back to you. That is the point: it proves the contact
belongs to the person booking, so a business does not get appointments from
numbers nobody answers. The code lasts 5 minutes and covers one booking.
Only a few codes may be sent to one contact — do not loop.
輸入參數slug必填emailphone
book-appointment
Book an appointment
Book a slot, using the code the user received from request-booking-code.
WHEN TO USE: last step, once the user has confirmed the venue, service and
exact time AND has read you their 6-digit code.
Requires the same contact the code was sent to. The booking is created as
"pending": the business still confirms it, so tell the user it is requested
and they will hear back — not that it is guaranteed. If the venue takes
prepayment, the response carries a link the user must open to pay; the slot
is not held indefinitely.
Only works for venues with `is_bookable: true`.
輸入參數name必填slug必填emailnotesphoneservice_id必填start_time必填verification_code必填
