# Altegio

## Что это

**Altegio** — международная платформа онлайн-записи и управления для салонов красоты, барбершопов, клиник, фитнес-студий и других сервисных бизнесов. Это международная версия YCLIENTS. Интеграция работает через публичный API онлайн-записи Altegio: бот показывает услуги и сотрудников локации, находит свободные даты и время, записывает клиента и отменяет запись. Запись сразу появляется в журнале локации.

## Требования

- Локация в [Altegio](https://alteg.io) с включённой онлайн-записью: услуги и сотрудники должны быть доступны для онлайн-записи.
- **Partner token** — выдаётся после регистрации разработчика в [Altegio Marketplace](https://app.alteg.io/appstore/developers/1). Приложение с этим токеном должно иметь доступ к вашей локации.
- **ID локации** — число из адреса кабинета Altegio.

## Как подключить

1. Зарегистрируйтесь как разработчик в Altegio Marketplace и скопируйте partner token.
2. Скопируйте ID локации из адреса кабинета Altegio.
3. В конструкторе откройте **Интеграции** → найдите карточку **Altegio** → **Подключить**.
4. Заполните поля **Partner token** и **ID локации**.
5. Сохраните подключение и нажмите **Проверить соединение**. Кнопка запрашивает список услуг онлайн-записи и показывает, сколько их найдено.

## Доступные операции

| Операция | Что делает |
|---|---|
| Список услуг | Услуги онлайн-записи: ID, название, цена от/до, длительность. Можно отфильтровать по сотруднику |
| Список сотрудников | Сотрудники онлайн-записи: ID, имя, специализация, рейтинг. Можно отфильтровать по услуге и времени |
| Свободные даты | Даты, на которые есть свободное время, с учётом услуги и сотрудника |
| Свободное время | Свободные окна на выбранную дату; без сотрудника — у любого свободного |
| Создать запись | Проверяет окно и записывает клиента (имя, телефон, email, комментарий). Возвращает ID и хэш записи |
| Отменить запись | Отменяет запись по её ID и хэшу |

## Ограничения

- Операции видят только услуги и сотрудников, открытых для онлайн-записи в настройках локации.
- Одно подключение работает с одной локацией. Для сети создайте отдельное подключение на каждую локацию.
- Altegio ограничивает частоту запросов: 200 в минуту и 5 в секунду с одного IP. Не вызывайте списки в цикле — сохраняйте результат в переменные.
- Если локация требует подтверждать телефон клиента SMS-кодом, Altegio отклонит запись без кода. Для работы с ботом отключите подтверждение телефона в настройках онлайн-записи.
- Поиск клиентов, их история визитов и перенос записи в публичный API онлайн-записи не входят.
- Дата и время передаются в формате ISO 8601. Для создания записи используйте поле `datetime` из результата операции «Свободное время».

## Особенности и примечания

> Типичный сценарий записи: «Список услуг» → «Свободное время» на выбранную дату → «Создать запись».

> Сохраните `record_id` и `record_hash` из операции «Создать запись» в переменные клиента — они нужны, чтобы бот мог отменить запись.

> Если выбранное окно уже заняли, Altegio вернёт ошибку ещё на этапе проверки, и запись не будет создана. Предложите клиенту другое время из операции «Свободное время».