Altegio

Что это

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

Требования

Локация в Altegio с включённой онлайн-записью: услуги и сотрудники должны быть доступны для онлайн-записи.
Partner token — выдаётся после регистрации разработчика в Altegio Marketplace. Приложение с этим токеном должно иметь доступ к вашей локации.
ID локации — число из адреса кабинета Altegio.

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

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

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

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

Ограничения

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

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

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

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

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