Booka

Города, в которых есть специалисты и места Booka. Вызывай, когда пользователь не назвал город или назвал его неоднозначно; результат передавай в find_places как city.

list_cities

Создать запись к специалисту на выбранные услуги, дату и время. Вызывай один раз на запись: ответ ok=true — запись создана, повторный вызов с теми же данными вернёт её же (alreadyCreated=true). Перед вызовом подтверди у пользователя имя, телефон, специалиста, услуги, дату и время — после создания запись подтверждается салоном, клиенту приходит WhatsApp. Время берётся из get_available_times.

create_booking

Полный прайс специалиста или площадки: id услуг (нужны для get_available_times и create_booking), цены, длительность, адрес, ссылка на страницу записи.

get_place

Отменить запись, созданную в этом разговоре через create_booking. Нужна ссылка manageUrl из ответа create_booking (https://booka.life/c/…). Перед вызовом подтверди у человека, какую запись отменить. Записи без такой ссылки отменить нельзя: отмена — ответом на WhatsApp-сообщение о записи или у специалиста, помощь — https://booka.life/support.

cancel_booking

Перенести запись, созданную в этом разговоре, на другую дату или время к тому же специалисту. Нужна ссылка manageUrl из ответа create_booking. Порядок: get_booking (masterId и serviceIds записи) → get_available_times на нужную дату → предложи человеку свободные окна → после его выбора и подтверждения — reschedule_booking. Записи без такой ссылки перенести нельзя.

reschedule_booking

Найти специалиста или место для записи в Booka: салоны красоты и мастера (маникюр, барбер, брови, массаж), психологи и психотерапевты, врачи и клиники, тренеры и спортивные площадки, школы и курсы, аренда. Ищет по услуге, специальности, имени специалиста, названию места или улице (например «психолог», «маникюр», «стоматолог», «Нурай», «Nuraika», «маникюр Ахунбаева»). Несколько слов — место должно подходить под каждое; латиница и кириллица ищутся обе, падежи тоже («психолога», «маникюра»). Возвращает до 20 карточек с id мастера, местом, адресом, рейтингом и примерами услуг с ценами. city=null у карточки — город у места не указан. Для записи нужен masterId из ответа.

find_places

Свободные времена начала на выбранную дату для специалиста и набора услуг. Время — в часовом поясе заведения. Пустой список times — на эту дату записаться нельзя (выходной, отпуск или всё занято).

get_available_times

Статус записи по ссылке manageUrl из ответа create_booking: ждёт подтверждения специалиста, подтверждена, отменена, состоялась или истекла; дата, время, специалист, услуги и можно ли ещё отменить. Вызывай, когда человек спрашивает, что с его записью, — в том числе после того, как он сам отменил или подтвердил её по ссылке.

get_booking