Шаги автоматизации

Добавьте шаг приложения YCLIENTS в схему. Входы свяжите с переменными процесса, результаты сохраните в переменные для следующих блоков. Не нужно вручную вызывать API YCLIENTS или передавать токены.

Пять шагов для новой схемы

Шаг	Что передать	Выходы
Ближайшие свободные дни — `day_choices`	`service_ids`, `staff_id`; при необходимости `date_from`, `range_days`, `page_size`, `cursor`	`has_days` — дни найдены; `no_days` — вариантов нет; `invalid_date` — дата некорректна.
Свободное время — `time_choices`	`service_ids`, `staff_id`, `date`; при необходимости `page_size`, `cursor`	`has_slots`, `no_slots`, `invalid_date`.
Поиск времени с выходами — `find_slots_v2`	`service_ids`, `staff_id`, `date` в формате YYYY-MM-DD	`has_slots` — время найдено; `no_slots` — свободного времени нет.
Создание записи с выходами — `create_booking_v2`	`service_ids`, `staff_id`, `datetime`, `client_name`, `client_phone`; необязательно `client_email`, `comment`	`created` — запись создана; `unavailable` — выбранное время уже недоступно.
Отмена записи с выходами — `cancel_booking_v2`	`record_id`	`cancelled` — запись отменена; `not_found` — запись не найдена.

service_ids — массив числовых ID услуг, staff_id и record_id — числа. Для datetime используйте полное значение из выбранного свободного окна, включая часовой пояс. Не собирайте его из текста кнопки «14:30».

Для новой схемы выбирайте шаги с выходами. В старых схемах могут встречаться find_slots, create_booking, cancel_booking с одним продолжением; их не требуется заменять только ради новой справки.

Простая схема записи

Получите выбранные услугу и мастера. В сценарии для одной услуги их реальные ID можно заранее задать в настройках; если вариантов несколько, добавьте выбор.
Покажите свободные дни, затем время выбранного дня.
Соберите имя и телефон, покажите итог и отдельную кнопку подтверждения.
После подтверждения выполните create_booking_v2.
По выходу created сохраните record_id и отправьте подтверждение. По unavailable предложите выбрать другое время.
Если клиент хочет отменить запись, получите согласие и передайте сохранённый record_id в cancel_booking_v2.

Результат поиска не удерживает место: между выбором и подтверждением его может занять другой клиент. Поэтому отдельный выход «Время недоступно» полезен даже при выборе кнопками.

Переменные процесса и ошибки

Например, сохраняйте record_id в run.yclients_record_id, а выбранное время — в run.yclients_datetime. Названия переменных задаёт автор схемы. Создайте начальные значения до первого чтения: ссылка на несуществующую переменную может остановить процесс.

Перед использованием полей учитывайте выход шага: по unavailable нет созданной записи, по not_found нельзя сообщать о подтверждённой отмене. Ошибки авторизации, связи и некорректных параметров не являются «нет свободных мест»; предусмотрите отдельное сообщение или передачу администратору.

Добавление шагов не публикует вашу автоматизацию и не назначает агента на каналы. Сначала проверьте черновик в тестовом диалоге, затем включайте сценарий по своим правилам.