# YCLIENTS

Перед настройкой действий подключите YCLIENTS.

# Получение данных

• Получить филиалы — определяет филиал; можно заранее выбрать только те филиалы, которые разрешено возвращать боту.
• Получить сотрудников — возвращает мастеров или сотрудников филиала.
• Получить услуги — возвращает услуги и сотрудников, которые могут их оказать. Переключатель Получать только доступные к онлайн-записи исключает услуги без онлайн-записи.
• Получить категории услуг — помогает сузить список услуг.
• Получить график работы сотрудника — возвращает расписание выбранного сотрудника с учётом услуги или без неё. Услугу и сотрудника можно выбрать вручную, передать через переменную либо включить Определять автоматически. Включите Сверять с графиком ресурса, чтобы оставить только интервалы, свободные одновременно у сотрудника и ресурса; для этого бот должен передать ID ресурса.
• Получить ресурсы — возвращает кабинеты, оборудование и другие ресурсы филиала.
• Получить график ресурса — возвращает расписание ресурсов. Можно ограничить список определёнными ресурсами или исключить выбранные.

Для графика сотрудника и ресурса выберите режим передачи времени:

• Свободное время сотрудников — все свободные интервалы без учёта продолжительности услуги;
• Только доступное к записи время — только интервалы, в которые помещается выбранная услуга;
• Сетка слотов по длительности услуги — готовые непересекающиеся интервалы, рассчитанные по длительности выбранной услуги.

Для сетки слотов услуга обязательна: выберите её, вставьте переменную или разрешите боту определить значение. При необходимости включите Буфер между слотами и укажите количество минут. Буфер добавляется после каждого предложенного интервала, поэтому количество доступных вариантов может уменьшиться.

В результате каждый слот содержит разные значения начала и окончания: сначала start, затем end. Интервал, который не помещается в свободное время полностью, в результат не включается.

# Работа с записью

• Оформить запись — создаёт запись после выбора филиала, услуги, сотрудника и времени. Для каждого параметра можно оставить Определять ботом или выключить переключатель и выбрать значение либо переменную через @. Чтобы занять кабинет или оборудование, включите Записывать на ресурс и передайте идентификатор, заранее полученный действием Получить ресурсы.
• Подтвердить запись — меняет статус записи на подтверждённый.
• Отменить запись и Удалить запись — отменяют или удаляют найденную запись. Для удаления ID может определить бот; при ручном режиме укажите ID или переменную.
• Изменить запись — позволяет определить филиал и ID автоматически либо вручную, а затем отдельно включить изменение даты, сотрудника и услуги.
• Получить записи клиента — возвращает последнюю активную запись или список записей. Для списка задайте лимит; значение по умолчанию — 10.

# Сценарий оформления

1. Получить филиал.
2. Определить услугу и подходящего сотрудника.
3. Если для услуги нужен ресурс, получить список ресурсов.
4. Получить график сотрудника и при необходимости график ресурса.
5. Предложить доступные варианты.
6. Собрать телефон и другие обязательные данные.
7. Повторить выбранные параметры и получить подтверждение.
8. Вызвать Оформить запись.

После изменения или создания записи сообщите пользователю итоговые дату, время, услугу и сотрудника.