# Действие ALTEGIO: Получить события

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

Действие **«Получить события»** используется для получения свободных временных слотов для записи в **ALTEGIO**.

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

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

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

* «Когда есть свободное время?»
* «Есть ли запись завтра?»
* «Когда свободен мастер Анна?»
* «Есть ли время на маникюр в пятницу?»

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

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

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

**Рекомендуемое описание функции:** <kbd>Проверить свободные слоты. Для конкретного дня укажи одинаковую дату в start\_date и end\_date.</kbd>

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

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

Для базовой настройки нужно добавить два параметра функции - **start\_date** и **end\_date**.

<table data-header-hidden><thead><tr><th width="120.80078125"></th><th width="136.82421875"></th><th width="293.140625"></th><th></th></tr></thead><tbody><tr><td><strong>Параметр</strong></td><td><strong>Тип</strong></td><td><strong>Рекомендуемая инструкция для параметра</strong></td><td><strong>Обязательный</strong></td></tr><tr><td>start_date</td><td>Текстовый</td><td>Дата начала. Формат ISO 8601 (YYYY-MM-DDTHH:mm)</td><td>Да</td></tr><tr><td>end_date</td><td>Текстовый</td><td>Дата окончания. Формат ISO 8601 (YYYY-MM-DDTHH:mm)</td><td>Да</td></tr></tbody></table>

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

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

* **по конкретному специалисту**
* **по конкретной услуге**

необходимо добавить соответствующие параметры:

| **Параметр**     | **Тип**   | **Обязательный** |
| ---------------- | --------- | ---------------- |
| specialist\_name | Текстовый | Нет              |
| service\_name    | Текстовый | Нет              |

#### [Настройка параметров specialist\_name и service\_name](/functional/functions/sending-result/altegio/nastroika-parametrov-specialist_name-i-service_name.md)

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

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

<kbd>**Получить события**</kbd>

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

В настройках действия сопоставьте поля:

* В поле **«Время начала события»** → выберите параметр **start\_date**
* В поле **«Время окончания события»** → выберите параметр **end\_date**

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

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

* В поле **«Услуга»** → выберите **service\_name**
* В поле **«Имя специалиста»** → выберите **specialist\_name**

Дополнительно можно активировать переключатель:

**«Добавить доступные услуги сотрудника в полученное расписание».**

Это позволит функции вернуть список услуг специалиста, если расписание запрошено без указания конкретной услуги.

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

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

Пример:

<kbd>Используй функцию \`get\_booking\_status\`, чтобы узнать доступное время для записи.</kbd>

## Логика работы функции

* Если указан специалист → возвращается расписание конкретного специалиста.
* Если указана услуга → возвращаются слоты под конкретную услугу.
* Если параметры не указаны → возвращаются все доступные слоты.

***

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

Функция возвращает список доступных временных интервалов в заданном диапазоне дат.


---

# 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/altegio/deistvie-altegio-poluchit-sobytiya.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.