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

## Назначение

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

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

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

* «Запишите меня на 15:00»
* «Хочу записаться к Анне на стрижку»
* «Запишите на маникюр завтра в 12»

{% hint style="info" %}
Функция должна вызываться только после получения ИИ-агентом обязательных параметров функции
{% endhint %}

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

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

**Рекомендуемое имя функции:&#x20;**<kbd>**book\_appointment**</kbd>

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

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

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

## Шаг 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 описана [в соответствующем разделе](/functional/functions/sending-result/yclients/nastroika-parametrov-specialist_name-i-service_name.md).

## Шаг 3. Выбор действия

В блоке **«Выбор действия»** в выпадающем списке выберите:

<kbd>**Создать событие**</kbd>

## Шаг 4. Настройка основных параметров

В настройках основных параметров действия сопоставьте поля с параметрами функции, значение которого будет использовано для заполнения полей в CRM-системе:

* В поле **«Время начала события»** → выберите параметр **start\_booking\_datetime**
* В поле **«Название услуги»** → выберите параметр **service\_name**
* В поле **«Имя клиента»** → выберите параметр **client\_name**
* В поле **«Телефон клиента»** → выберите параметр **client\_phone\_number**

## Шаг 5. Настройка необязательных параметров

Если добавлены дополнительные параметры:

* В поле **«Email клиента»** → выберите **client\_email**
* В поле **«Имя специалиста»** → выберите **specialist\_name**

## Шаг 6. Настройка комментария к записи

В разделе **«Комментарии к записи»** вы можете добавить один или несколько комментариев.

В качестве значения можно использовать:

* значение параметра функции **comment;**
* системные данные (например, ссылку на диалог, имя пользователя в мессенджере);
* текст.

## Шаг 7. Настройка напоминания

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

1. В блоке **«Напоминание»** активируйте переключатель\
   \&#xNAN;**«Добавить напоминание о событии»**
2. Нажмите на кнопку **«Добавить напоминание»**
3. Выберите режим времени:

* **Относительный** (за/после X минут от события)
* **Абсолютный** (в выбранный день и время)

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

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

Примеры:

* <kbd>-60</kbd> — напоминание за 60 минут до визита
* <kbd>30</kbd> — сообщение через 30 минут после визита

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

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

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

Примеры:

* Смещение <kbd>-1</kbd> время <kbd>19:30</kbd> — напоминание за 1 день до визита в 19:30
* Смещение <kbd>0</kbd> время <kbd>10:00</kbd> — напоминание в день визита в 10:00

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

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

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

* **{yclientsBookingDate}**
* **{yclientsBookingTime}**

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

* **{start\_booking\_datetime}**
* **{client\_name}**
* **{client\_phone\_number}**
* **{comment}**
* **{service\_name}**
* **{specialist\_name}**

Примеры:

<kbd>Напоминание о записи {yclientsBookingDate} в {yclientsBookingTime} на услугу {service\_name}</kbd>

<kbd>Расскажите, как прошла услуга {service\_name}</kbd>

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

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

{% hint style="info" %}
Функция не должна вызываться, если отсутствуют обязательные данные.
{% endhint %}

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

Пример:

<kbd>“После того, как узнал имя и номер телефона клиента, вызови \`book\_appointment\`, чтобы записать клиента. Если клиенту неважно, к какому мастеру записаться, оставь параметр \`specialist\_name\` пустым.”</kbd>

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

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

***

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

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

* ID записи
* Продолжительность сеанса
* Специалист


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/functional/functions/sending-result/yclients/deistvie-yclients-sozdat-sobytie.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.