# Мастер создания функций ALTEGIO

## Создание функций

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

1. Зайдите в раздел **Интеграции ->** [ALTEGIO](https://app.nextbot.ru/integrations?tab=AltegioSettings) и нажмите "**Мастер создания функций"**\ <br>

   <figure><img src="/files/OcNJOFLk1dRqWs6jwtwR" alt=""><figcaption></figcaption></figure>
2. В **Мастере создания функций** ALTEGIO нажмите **«Начать»**.\ <br>

   <figure><img src="/files/mpeKGxLFTS2rxzLsCb23" alt=""><figcaption></figcaption></figure>

### Шаг 1. Настройка специалистов

Проверьте и подтвердите выбор специалистов, выбрав их с помощью чекбоксов.\
\
Или включите опцию "Автоматически загружать специалистов" — тогда специалисты будут загружаться **автоматически** при каждом ответе пользователю. ИИ-агент будет иметь доступ ко всем включенным специалистам с Online записью. Не забудьте выбрать, какие поля необходимо использовать для отображения специалиста — Имя как в основной карточке или ФИО.\
Также, при использовании опции "Автоматически загружать специалистов", вы можете выбрать добавлять ли поле "специализация" к вашим специалистам.

<figure><img src="/files/qyDZ1ypP6V1q2CZloHrZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/qd4eyW4ulJ1PahwH3Km1" alt=""><figcaption></figcaption></figure>

### Шаг 2. Настройка услуг

Проверьте и подтвердите выбор услуг, выбрав их с помощью чекбоксов.\
\
Или включите опцию "**Автоматически загружать услуги**" — тогда услуги будут загружаться автоматически при каждом ответе пользователю. ИИ агент будет иметь доступ ко всем включенным услугам с Online записью. Не забудьте выбрать, какие поля необходимо использовать для отображения специалиста — Имя как в основной карточке или ФИО.\
\
Опция "**Добавить к услугам цену**" позволяет добавлять к услугам цену. Полезно если вы хотите, чтобы агент мог сказать цену без дополнительного запроса в Altegio.

<figure><img src="/files/5TBqRYpDTzUEzEYnb0Qg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/kXiuODY4vd6Wp1KI14tA" alt=""><figcaption></figcaption></figure>

### Шаг 3. Выберите необходимые функции

Отметьте, какие функции необходимо создать для агента:

* Чтение расписания — функция для получения свободных временных слотов на выбранный день.
* Запись на услугу — функция для записи клиента на услугу в свободное время.
* Отмена своей записи — функция для отмены записи, сделанной клиентом.
* Получение информации о услугах — функция для получения информации о услугах. Получение информации об услугах особенно полезно, если у вас их много и для каждой указано подробное описание в Altegio.
* Получение информации о специалистах — функция для получения информации о ваших специалистах (из поля Страница мастера в AG). Получение информации о специалистах особенно полезно, если у вас их много и у каждого есть подробное описание в Altegio. Если указаны только имя, фамилия и специализация, достаточно чтения расписания и записи — в этом случае специалисты попадут в параметры функции. Используйте только если заполнено описание специалиста.
* Получение информации о записях — функция для получения всех записей, привязанных к номеру телефона. Добавьте, если нужно подсказать клиенту о всех его записях или если у вас может быть много записей в день на одного клиента и нужно удалить одну определённую.

Нажмите **«Далее»**.

<figure><img src="/files/uxmTTJnbQahdb0ivuSVs" alt=""><figcaption></figcaption></figure>

### Шаг 4. Настройки получения записей

Укажите, нужно ли получать записи конкретного специалиста (или всех).

* Чтение записей конкретного специалиста
  * если опция **выбрана** - то ИИ-Агент может запросить расписание конкретного специалиста. А также выбрать по каким полям искать специалиста.\
    Вы можете включить добавление специализации к специалистам.

    <figure><img src="/files/Ni06olRgiisHnoYbi1wQ" alt=""><figcaption></figcaption></figure>
  * если опция **не выбрана** - то ИИ-Агент будет получать расписание всех специалистов.

    <div align="left"><figure><img src="/files/4qyUfjQq3GWRbF0Jr0Ci" alt="" width="375"><figcaption></figcaption></figure></div>
* Чтение записей по конкретной услуге
  * если опция **выбрана** - то ИИ-Агент может запросить расписание по конкретной услуге. А также выбрать, добавлять ли в функцию информацию о ценах. Полезно, если вы хотите, чтобы агент мог сказать цену без дополнительного запроса в ALTEGIO.

    <figure><img src="/files/5vCDCoRcU2f1DIotF89C" alt=""><figcaption></figcaption></figure>
  * если опция **не выбрана** - то ИИ-Агент сможет видеть только свободное время специалистов.<br>
* Добавить доступные услуги сотрудника в результат
  * если опция **выбрана** - то при запросе конкретного специалиста, ИИ-Агент получит все услуги, которые оказывает этот специалист.<br>

    <figure><img src="/files/fDQxiWaIxs1hDVmyWxGL" alt=""><figcaption></figcaption></figure>
  * если опция **не выбрана** - то доступные услуги сотрудника в результат выполнения функции добавлены не будут.

Нажмите **«Далее»**.

### Шаг 5. Настройки записи на услугу

Выберите вариант логики распределения записей:

* **Запись к конкретному специалисту**
  * **Выключено** — Клиент **не сможет** выбрать специалиста — запись произойдёт к любому доступному сотруднику.
  * **Включено** — Клиент **сможет** выбрать конкретного специалиста (к специалисту добавится его специальность, если выбрать добавление).
* **Добавить к услугам цену**
  * **Выключено** — к услугам не будет добавлена цена. Для того чтоб узнать цену и другую информацию - понадобится запрос в ALTEGIO.
  * **Включено** — к услугам будет добавлена цена. ИИ-Агент будет знать стоимость услуг без дополнительного запроса в ALTEGIO.
* **Отправлять напоминание о записи** — укажите, за сколько минут до визита отправлять напоминание клиенту. В функции можно настроить напоминания более гибко, смотри статью "[Настройка напоминаний ALTEGIO](/functional/integrations/altegio/nastroika-napominanii-altegio.md)"
* **Запрашивать обратную связь** — укажите, через сколько минут после визита отправлять запрос на обратную связь клиенту.

Нажмите **«Далее»**.

<figure><img src="/files/JNSEbDQD0SVi6gXSkMKk" alt=""><figcaption></figcaption></figure>

### Шаг 6. Настройки удаления

Выберите как ИИ-Агент может удалять записи.

* **Удалять по номеру записи -** включено по умолчанию. Если включено, можно будет удалить запись по её уникальному номеру (ID).
* **Удалять по номеру телефона -** если включено, можно будет удалить запись по номеру телефона клиента.

<figure><img src="/files/xQpSsToDaJVQosIQe2OI" alt=""><figcaption></figcaption></figure>

### Шаг 7. Настройки получения информации о специалистах

Укажите, какие поля информации о специалистах будут доступны:

* Добавлять специализацию к специалистам — в варианты будут добавлены специализации специалистов.
* Какие поля использовать для отображения специалиста: Можно выбрать любое сочетание, например Имя и Фамилия\
  \
  Нажмите **«Далее»**.<br>

  <figure><img src="/files/0hIfAmd5y2CUk3L7rUks" alt=""><figcaption></figcaption></figure>

## Результат

Будут созданы следующие функции:

1. `get_booking_status` — получение доступного времени для записи
2. `book_appointment` — создание записи на услугу
3. `cancel_booking` — отмена записи клиента
4. `get_services_info` — получение информации об услуге
5. `get_specialist_info` — получение информации о специалисте по его имени
6. `get_client_records` — получение информации о всех записях клиентов по номеру телефона клиента

<figure><img src="/files/VBnOheEumQpdVgPNgpMD" alt=""><figcaption></figcaption></figure>

Необходимо прописать в промпте ИИ-агента инструкцию для правильного использования функций. Пример в [статье](/functional/integrations/altegio/nastroika-ii-agenta-dlya-raboty-s-altegio.md)


---

# 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/integrations/altegio/master-sozdaniya-funkcii-altegio.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.