Действие YCLIENTS: Создать событие
Назначение
Действие «Создать событие» используется для создания записи клиента на услугу в CRM-системе YCLIENTS.
Когда используется
Функция вызывается, если пользователь подтверждает запись, например:
«Запишите меня на 15:00»
«Хочу записаться к Анне на стрижку»
«Запишите на маникюр завтра в 12»
Функция должна вызываться только после получения ИИ-агентом обязательных параметров функции
Этапы настройки функции
Шаг 1. Имя и описание функции
Рекомендуемое имя функции: book_appointment
Использование данного имени рекомендуется, так как с ним протестирована корректная работа ИИ-агента.
Рекомендуемое описание функции: Забронировать время. Не бронируй сразу всех специалистов.
Такое описание помогает агенту корректно интерпретировать назначение функции.
Шаг 2. Добавление параметров функции
Параметры функции
Для базовой настройки нужно добавить 4 параметра функции.
Параметр
Тип
Рекомендуемая инструкция для параметра
Обязательный
start_booking_datetime
Текстовый
Дата и время начала записи. Формат ISO 8601 (YYYY-MM-DDTHH:mm)
Да
client_name
Текстовый
Имя клиента
Да
client_phone_number
Текстовый
Телефон клиента, например +79991234567
Да
service_name
Текстовый
Название услуги (если услуг несколько, то запиши все через |).
Да
Дополнительные параметры (по желанию)
Если требуется расширенная логика записи, можно добавить:
Параметр
Тип
Обязательный
specialist_name
Текстовый
Нет
comment
Текстовый
Нет
client_email
Текстовый
Нет
specialist_name — клиент сможет выбрать конкретного специалиста
comment — если нужно передавать комментарий клиента
client_email — если требуется передача email в YCLIENTS
Настройка параметров specialist_name и service_name
Настройка параметров specialist_name и service_name описана в соответствующем разделе.
Шаг 3. Выбор действия
В блоке «Выбор действия» в выпадающем списке выберите:
Создать событие
Шаг 4. Настройка основных параметров
В настройках основных параметров действия сопоставьте поля с параметрами функции, значение которого будет использовано для заполнения полей в CRM-системе:
В поле «Время начала события» → выберите параметр start_booking_datetime
В поле «Название услуги» → выберите параметр service_name
В поле «Имя клиента» → выберите параметр client_name
В поле «Телефон клиента» → выберите параметр client_phone_number
Шаг 5. Настройка необязательных параметров
Если добавлены дополнительные параметры:
В поле «Email клиента» → выберите client_email
В поле «Имя специалиста» → выберите specialist_name
Шаг 6. Настройка комментария к записи
В разделе «Комментарии к записи» вы можете добавить один или несколько комментариев.
В качестве значения можно использовать:
значение параметра функции comment;
системные данные (например, ссылку на диалог, имя пользователя в мессенджере);
текст.
Шаг 7. Настройка напоминания
Если требуется автоматическое напоминание клиенту о предстоящем визите или запрос обратной связи:
В блоке «Напоминание» активируйте переключатель «Добавить напоминание о событии»
Нажмите на кнопку «Добавить напоминание»
Выберите режим времени:
Относительный (за/после X минут от события)
Абсолютный (в выбранный день и время)
При относительном режиме
В поле «Время до/после события (в минутах)» введите количество минут до или после события.
Примеры:
-60 — напоминание за 60 минут до визита
30 — сообщение через 30 минут после визита
При абсолютном режиме
В поле «Смещение по дням» введите количество дней до или после события.
В поле «Время (чч:мм)» введите время напоминания
Примеры:
Смещение -1 время 19:30 — напоминание за 1 день до визита в 19:30
Смещение 0 время 10:00 — напоминание в день визита в 10:00
Текст напоминания
В поле “Текст напоминания” введите текст напоминания.
Можно использовать системные переменные:
{yclientsBookingDate}
{yclientsBookingTime}
И параметры функции:
{start_booking_datetime}
{client_name}
{client_phone_number}
{comment}
{service_name}
{specialist_name}
Примеры:
Напоминание о записи {yclientsBookingDate} в {yclientsBookingTime} на услугу {service_name}
Расскажите, как прошла услуга {service_name}
ШАГ 8. Добавление инструкции в системный промпт
Для того, чтобы ИИ агент вызывал функцию в нужный момент, добавьте правило в системный промпт агента.
Функция не должна вызываться, если отсутствуют обязательные данные.
Поэтому в промпте лучше указать о том, что агент должен собрать необходимые данные и лишь потом вызвать функцию.
Пример:
“После того, как узнал имя и номер телефона клиента, вызови `book_appointment`, чтобы записать клиента. Если клиенту неважно, к какому мастеру записаться, оставь параметр `specialist_name` пустым.”
Логика записи
Если добавлен параметр функции specialist_name → клиент сможет выбрать записаться к конкретному специалисту
При этом если при вызове функции не будет известен нужный специалист (клиенту все равно, к кому записаться) → запись будет к наиболее свободному в этот день специалисту
Результат функции
Создается запись и возвращается:
ID записи
Продолжительность сеанса
Специалист
Last updated
Was this helpful?