Действие ALTEGIO: Создать событие

Назначение

Действие «Создать событие» используется для создания записи клиента на услугу в CRM-системе ALTEGIO.

Когда используется

Функция вызывается, если пользователь подтверждает запись, например:

• «Запишите меня на 15:00»

• «Хочу записаться к Анне на стрижку»

• «Запишите на маникюр завтра в 12»

Функция должна вызываться только после получения ИИ-агентом обязательных параметров функции

Этапы настройки функции

Шаг 1. Имя и описание функции

Рекомендуемое имя функции:book_appointment

Использование данного имени рекомендуется, так как с ним протестирована корректная работа ИИ-агента.

Рекомендуемое описание функции: Забронировать время. Не бронируй сразу всех специалистов.

Такое описание помогает агенту корректно интерпретировать назначение функции.

Шаг 2. Добавление параметров функции

Параметры функции

Для базовой настройки нужно добавить 4 параметра функции.

Параметр	Тип	Рекомендуемая инструкция для параметра	Обязательный
start_booking_datetime	Текстовый	Дата и время начала записи. Формат ISO 8601 (YYYY-MM-DDTHH:mm)	Да
client_name	Текстовый	Имя клиента	Да
client_phone_number	Текстовый	Телефон клиента, например [phone]	Да
service_name	Текстовый	Название услуги (если услуг несколько, то запиши все через |).	Да

Дополнительные параметры (по желанию)

Если требуется расширенная логика записи, можно добавить:

Параметр	Тип	Обязательный
specialist_name	Текстовый	Нет
comment	Текстовый	Нет
client_email	Текстовый	Нет

specialist_name — клиент сможет выбрать конкретного специалиста

comment — если нужно передавать комментарий клиента

client_email — если требуется передача email в ALTEGIO

Настройка параметров 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. Настройка напоминания

Если требуется автоматическое напоминание клиенту о предстоящем визите или запрос обратной связи:

1. В блоке «Напоминание» активируйте переключатель «Добавить напоминание о событии»

2. Нажмите на кнопку «Добавить напоминание»

3. Выберите режим времени:

• Относительный (за/после X минут от события)

• Абсолютный (в выбранный день и время)

При относительном режиме

В поле «Время до/после события (в минутах)» введите количество минут до или после события.

Примеры:

• -60 — напоминание за 60 минут до визита

• 30 — сообщение через 30 минут после визита

При абсолютном режиме

В поле «Смещение по дням» введите количество дней до или после события.

В поле «Время (чч:мм)» введите время напоминания

Примеры:

• Смещение -1 время 19:30 — напоминание за 1 день до визита в 19:30

• Смещение 0 время 10:00 — напоминание в день визита в 10:00

Текст напоминания

В поле “Текст напоминания” введите текст напоминания.

Можно использовать системные переменные:

• {altegioBookingDate}

• {altegioBookingTime}

И параметры функции:

• {start_booking_datetime}

• {client_name}

• {client_phone_number}

• {comment}

• {service_name}

• {specialist_name}

Примеры:

• Напоминание о записи {altegioBookingDate} в {altegioBookingTime} на услугу {service_name}

• Расскажите, как прошла услуга {service_name}

ШАГ 8. Добавление инструкции в системный промпт

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

Функция не должна вызываться, если отсутствуют обязательные данные.

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

Пример:

“После того, как узнал имя и номер телефона клиента, вызови `book_appointment`, чтобы записать клиента. Если клиенту неважно, к какому мастеру записаться, оставь параметр `specialist_name` пустым.”

Логика записи

• Если добавлен параметр функции specialist_name → клиент сможет выбрать записаться к конкретному специалисту

• При этом если при вызове функции не будет известен нужный специалист (клиенту все равно, к кому записаться) → запись будет к наиболее свободному в этот день специалисту

---

Результат функции

Создается запись и возвращается:

• ID записи

• Продолжительность сеанса

• Специалист