Инструменты агента

Установите приложение и подключите филиал в том же проекте. В настройках агента добавьте нужные инструменты YCLIENTS. Их восемь; включайте только действия, которые нужны вашему сценарию.

Доступные действия

Инструмент	Для чего нужен
yclients_list_services	Получить услуги филиала и их ID, чтобы предложить клиенту реальные варианты.
yclients_list_staff	Получить сотрудников и их ID.
yclients_find_days	Найти ближайшие свободные дни для выбранных услуг и сотрудника.
yclients_find_slots	Найти свободное время на конкретную дату.
yclients_create_booking	Создать запись с выбранными услугами, сотрудником, временем, именем и телефоном клиента.
yclients_get_booking	Получить актуальное состояние записи по record_id.
yclients_reschedule_booking	Изменить существующую запись по record_id, например перенести время.
yclients_cancel_booking	Отменить конкретную запись по record_id.

Порядок записи

1. Получите услуги и сотрудников. Используйте ID из результатов инструментов, а не придуманные значения.
2. Уточните услугу и мастера. Если предпочтений по дате нет, предложите ближайшие дни через yclients_find_days.
3. Для выбранного дня получите окна через yclients_find_slots. Предлагайте только время из результата, с учётом часового пояса филиала.
4. Уточните имя и телефон. Повторите услугу, мастера, дату и время; получите явное согласие.
5. Создайте запись. Сообщите об успехе только после успешного ответа и сохраните record_id для дальнейшего управления.

Поиск дней по умолчанию охватывает 14 дней; диапазон можно задать от 1 до 31 дня. Отсутствие вариантов в этом диапазоне не означает, что запись невозможна вообще.

Что написать в инструкции агента

Опишите правила общения и последовательность действий. Формат JSON и техническую обёртку вызова переписывать в инструкцию не нужно — параметры описаны в схеме инструмента.

Пример фрагмента инструкции:

Помогай записаться на услуги нашего филиала. Сначала уточняй услугу и мастера. Если клиент не назвал дату, предлагай ближайшие свободные дни, затем время. Используй только результаты YCLIENTS. Перед созданием, переносом или отменой покажи детали и попроси подтверждение. Не говори, что запись создана, пока инструмент не подтвердил успех. Если вариантов нет, предложи другой день или мастера; при технической ошибке не выдавай её за отсутствие мест.

Перенос, отмена и повторные попытки

Для проверки, переноса и отмены нужен точный record_id. Поиск всех записей клиента по имени или телефону отдельным инструментом не предоставляется. Если номер неизвестен, уточните его или передайте обращение администратору; не угадывайте.

Перед переносом прочитайте запись, найдите новое свободное время и получите согласие клиента. Перед отменой проверьте, что выбрана нужная запись и клиент вправе ей управлять. Наличие ID само по себе не подтверждает личность клиента.

При тайм-ауте создания не запускайте новое создание наугад: результат может быть ещё неизвестен. Проверьте запись, если получили её ID, либо попросите администратора проверить журнал YCLIENTS. Защита от повторной доставки одного события не заменяет проверку перед новым самостоятельным вызовом.