# Подключение интеграции с ALTEGIO

{% hint style="success" %}
**На этом этапе предполагается, что у вас уже создан и настроен личный кабинет ALTEGIO**
{% endhint %}

### Настройка через мастер подключения

0\. Зайдите в раздел **Интеграции →** [Altegio](https://app.nextbot.ru/integrations?tab=AltegioSettings) **→ Мастер подключения**

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

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

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

2. Введите Salon ID — это уникальный номер вашего филиала в ALTEGIO. Чтобы его найти:

* Откройте боковую панель навигации ALTEGIO.
* Нажмите на иконку **«Свяжитесь с нами»** внизу.
* Во всплывающем окне появится Location ID.
* Скопируйте ТОЛЬКО ЦИФРЫ и вставьте их в поле без символа #.\
  \
  Альтернативный способ:
* Возьмите значение из URL<br>

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

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

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

3. Создайте аккаунт разработчика в ALTEGIO. Для этого откройте личный кабинет ALTEGIO и в основном меню перейдите в раздел «Интеграции» → «Аккаунт разработчика»

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

4. Заполните обязательные поля и нажмите «Зарегистрироваться» для создания аккаунта разработчика. <mark style="color:orange;">Если у вас уже есть аккаунт разработчика, этот шаг можно пропустить.</mark>

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

5. В ALTEGIO в разделе «Аккаунт разработчика» найдите и нажмите кнопку «Добавить приложение» для начала процесса создания нового API-приложения. После нажатия откроется мастер создания приложения.\ <mark style="color:orange;">Если вы настраиваете повторно, например для второго агента - то шаги создания приложения можно пропустить.</mark>

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

6. На первом шаге мастера создания приложения необходимо выбрать тип приложения. **Обязательно выберите тип «Непубличное»**, так как это необходимо для корректной работы с API ALTEGIO без публикации в каталоге приложений.

<figure><img src="/files/27OiBt9Tn6h4HMFGsg40" alt=""><figcaption></figcaption></figure>

7. На этом шаге необходимо заполнить основные данные о вашем приложении:

* **Название приложения** - введите любое название
* **Короткое описание** - добавьте любое краткое описание функций вашего приложения
* **Категория** - выберите категорию «Онлайн-запись»

<figure><img src="/files/3l3RNoJ06ER3oKYQ3VcX" alt=""><figcaption></figcaption></figure>

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

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

9. После создания приложения, вы можете найти его Application ID в разделе «Мои приложения» → «Общая информация». Данный идентификатор понадобится для настройки интеграции.

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

10. Теперь необходимо ввести User Token — это персональный токен доступа к API ALTEGIO. Чтобы его найти, откройте раздел «Мои приложения» → «Доступ к API». В поле «User Token» вы увидите нужный токен.

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

11. Настройка прав доступа для приложения на этой же странице ниже.\
    Обязательно включите доступ к следующим разделам:

* **Журнал записи** — для работы с записями клиентов
* **Форма записи** — для управления процессом онлайн-записи
* **Клиентская база** — для доступа к информации о клиентах

Обязательно нажмите кнопку **СОХРАНИТЬ**

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

12. **Настройка уведомлений из Altegio** позволяет автоматически отправлять клиентам сообщения в каналы связи WhatsApp и Max при создании и/или удалении записи вручную в интерфейсе **Altegio**. Сообщение отправляется по номеру телефона, указанному в записи клиента.

Для работы этой опции необходимо скопировать webhook-ссылку из интерфейса Nextbot → перейти в **Altegio** в раздел «Мои приложения» → открыть «Настройки подключения» и вставить webhook-ссылку в поле «Адрес, на который отправлять уведомления» → нажать «Сохранить» внизу страницы.

Пример использования: Администратор добавляет запись в сервисе **Altegio** → Nextbot через webhook получает информацию о событии → клиенту приходит сообщение в WhatsApp/Max в соответствии с выбранным форматом сообщения на странице интеграции: «Стандартное сообщение» или «Инструкция для ИИ». Если у агента, на котором настроена интеграция **Altegio**, подключен только один мессенджер, например, WhatsApp, клиент получит сообщение только в WhatsApp. Если подключены оба канала — WhatsApp и Max, сообщение будет отправлено в каждый мессенджер.

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

13. Настройка реакции на новую запись

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

14. Настройка реакции на удаление записи

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

15. Теперь необходимо ввести Partner Token — это партнерский токен для доступа к API ALTEGIO. Чтобы его найти, перейдите в раздел **«Настройки аккаунта»** и в блоке **«Данные аккаунта»** найдите поле **«Токен партнера»**.

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

Скопируйте токен партнера из вашего аккаунта ALTEGIO и вставьте его в поле в мастере подключения. Нажмите **«Далее»**<br>

16. В мастере подключения нажмите кнопку **«Перейти к приложению в** **ALTEGIO»**

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

В новой вкладке откроется страница вашего приложения в ALTEGIO. Нажмите **«Подключить» → «Продолжить»**

<figure><img src="/files/6rB9MbsLkcc0n33WZUJG" alt=""><figcaption></figcaption></figure>

Вернитесь на страницу с мастером подключения.

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

17. Настройка даты и времени

<figure><img src="/files/56UcOyhiNzoJdFARoPhd" alt=""><figcaption></figcaption></figure>

18. Нажмите **«Далее»** **→** **«Завершить».**

<figure><img src="/files/7DLAQ0OrvdRoGvmFMx4k" alt=""><figcaption></figcaption></figure>

**Настройка завершена.** Продолжение — в [следующей статье](broken://pages/k3vagv5BV8N1aC5RC8Cg).

***

### Настройка вручную

1. Зайдите в раздел Интеграции -> [Altegio](https://app.nextbot.ru/integrations?tab=AltegioSettings)
2. Нажмите **«Закрыть»** в мастере подключения
3. Введите значения в поля:
   1. **Salon ID** — уникальный номер филиала. Найдите его в **ALTEGIO → Обзор → Сводка → Идентификатор филиала (ID)**.

      **Альтернативный способ:** Возьмите значение из URL<br>

      <figure><img src="/files/dJw3hYC9J6X2kPY3L7nY" alt=""><figcaption></figcaption></figure>
   2. **Application ID** — если приложение уже создано, найдите его в разделе **«Интеграции»** **→** **«Аккаунт разработчика»**, нажав **«Управление»** → поле **Application ID**.
   3. **User Token** — находится там же, в разделе **«Доступ к API»**.
   4. **Partner Token** — найдите его в разделе **«Настройки аккаунта»** во вкладке **«Аккаунт разработчика»**, в поле **«Токен партнера»**.<br>
4. Нажмите Подключить.

<figure><img src="/files/87YAioXxMxO4wuBCtuCp" alt=""><figcaption></figcaption></figure>

5. В новой вкладке откроется страница приложения в **ALTEGIO**.

* Нажмите **«Подключить» → «Продолжить»**.
* Если отображается статус **«Подключено»**, пропустите этот шаг.

6. Вернитесь на страницу настройки **ALTEGIO**.

**Настройка завершена.** Продолжение — в [следующей статье](broken://pages/k3vagv5BV8N1aC5RC8Cg).


---

# 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/podklyuchenie-integracii-s-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.