Интеграции и доступы: API-ключи, вебхуки и ИИ-ассистенты

Altegio можно подключить к собственным приложениям, интеграциям и ИИ-ассистентам. Разработчики получают ключ доступа (его также называют API-ключом, партнёрским токеном или Bearer-токеном) в Altegio Developer Hub. ИИ-ассистенты, например Claude или ChatGPT, подключаются через готовые приложения из Маркетплейса или MCP-серверы Altegio, без каких-либо ключей.

Когда использовать

• Вы разрабатываете собственное приложение или интеграцию с API Altegio, и вам нужен ключ доступа.
• Вашему серверу нужно получать уведомления об изменениях в локации, например о новых записях или изменении данных клиентов.
• Вы хотите работать с данными Altegio из ИИ-ассистента, например спросить у Claude, как изменилась выручка за прошлый месяц.

Где найти блок «Интеграции и доступы»

Блок Интеграции и доступы в настройках локации состоит из 3 разделов:

• Ключи: для тех, кто разрабатывает собственные приложения и интеграции. Ведёт в Altegio Developer Hub, где выдаётся ключ доступа.
• Вебхуки: страница настроек вебхуков. Сама страница не изменилась.
• ИИ-ассистенты: для подключения ИИ-ассистента. Ключ доступа не нужен.

Чтобы открыть блок Интеграции и доступы:

1. В режиме Администрирование нажмите Настройки в левом меню.
2. Найдите блок Интеграции и доступы и нажмите на нужный раздел.

Получение ключа доступа для своей интеграции

Ключ доступа нужен программе, которая обращается к данным локации без входа под сотрудником. Ключи доступа выдаются в Altegio Developer Hub, где вы регистрируете аккаунт разработчика. Чтобы получить ключ доступа, не нужно обращаться в поддержку или заполнять анкету партнёра.

Ключ доступа и ключ пользователя

Запросы к данным локации в API Altegio подписываются 2 ключами:

• Ключ доступа: принадлежит вашему аккаунту разработчика и отображается в Developer Hub. В документации API Altegio ключ доступа называется партнёрским токеном (partner token) и передаётся как Bearer-токен.
• Ключ пользователя: его возвращает метод авторизации API в ответ на логин и пароль пользователя Altegio. Ключ пользователя определяет, от чьего имени приложение работает с данными. В документации API Altegio ключ пользователя называется пользовательским токеном (user token).

Шаг 1. Откройте Developer Hub

1. Откройте Настройки > Интеграции и доступы > Ключи.
2. Нажмите Зарегистрироваться в Developer Hub.

Что откроется после нажатия Зарегистрироваться в Developer Hub, зависит от того, есть ли у вас аккаунт разработчика. Если аккаунта разработчика ещё нет, откроется страница регистрации в Developer Hub: перейдите к шагу 2. Если аккаунт разработчика уже есть, сразу откроется ваш аккаунт в Developer Hub: перейдите к шагу 3.

Шаг 2. Зарегистрируйтесь в Developer Hub

1. В поле Название аккаунта разработчика укажите название вашей компании или ваше имя.
2. В поле Для кого вы планируете делать интеграцию выберите, для чего вам нужен доступ к API.
3. Проверьте блок Контактные данные. Поля Имя, Телефон и Email заполняются из вашего профиля в Altegio. Менеджер Altegio может связаться с вами по этим контактам, поэтому убедитесь, что данные актуальны.
4. В поле Сайт укажите сайт вашей компании.
5. Нажмите Зарегистрироваться.

В форме регистрации в Developer Hub нет поля для токена: для регистрации Bearer-токен не нужен.

Шаг 3. Скопируйте ключ доступа

На странице аккаунта в Developer Hub есть блок Мои ключи, блок ИИ-ассистенты и блок с ключом доступа вашего аккаунта разработчика.

1. Найдите поле Ключ доступа.
2. Скопируйте ключ доступа и сохраните его в надёжном месте.

Важно. Ключ доступа является приватным ключом. Никому его не показывайте и не публикуйте в открытом коде, например в публичном репозитории.

Ключ пользователя возвращает метод авторизации API в ответ на логин и пароль пользователя Altegio. Способы получить ключ пользователя и список методов API описаны в документации API Altegio.

Настройки WebHook

Страница Настройки WebHook открывается в разделе Настройки > Интеграции и доступы > Вебхуки.

Подключение ИИ-ассистента к Altegio

ИИ-ассистенту не нужен ключ доступа для работы с Altegio. Чтобы выбрать способ подключения ИИ-ассистента, откройте Настройки > Интеграции и доступы > ИИ-ассистенты.

На странице ИИ-ассистенты 2 карточки: готовые ИИ-решения из Маркетплейса и подключение собственного ИИ-ассистента через MCP.

Готовые ИИ-решения. На странице ИИ-ассистенты первая карточка ведёт к ИИ-приложениям в Маркетплейсе Altegio, например к ИИ-администраторам, которые круглосуточно отвечают клиентам и записывают их. У каждого приложения своя цена, она указана в карточке приложения.

Подключение Altegio к ИИ-ассистенту через MCP. На странице ИИ-ассистенты вторая карточка предназначена для ИИ-приложений, которые поддерживают MCP-серверы, например Claude, ChatGPT или Cursor. В карточке есть ссылки на 3 MCP-сервера Altegio:

• Altegio Pro MCP: читает и изменяет данные ваших локаций: записи, сотрудников, услуги, графики работы, клиентов и настройки.
• Altegio Pro MCP (read-only): читает те же данные и полный набор аналитики, но ничего не может изменить.
• Altegio Integrations Hub MCP: для разработчиков, которые создают приложения для Маркетплейса Altegio.

Чтобы подключить MCP-сервер Altegio, вы входите с email и паролем от Altegio. Ключ доступа или токен не нужен. Что умеет каждый сервер, читайте в статье MCP-серверы Altegio для ИИ-ассистентов.

Частые вопросы