Інтеграції та доступ: API-ключі, веб-хуки та AI-помічники

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

Коли використовувати

• Ви розробляєте власний додаток або інтеграцію з API Altegio, і вам потрібен ключ доступу.
• Вашому серверу потрібно отримувати сповіщення про зміни у філії, наприклад про нові записи або зміни в даних клієнтів.
• Ви хочете працювати з даними Altegio з AI-помічника, наприклад запитати в Claude, як змінився виторг за минулий місяць.

Де знайти блок «Інтеграції та доступ»

Блок Інтеграції та доступ у налаштуваннях філії складається з 3 пунктів:

• Ключі: для тих, хто розробляє власні додатки та інтеграції. Веде в Altegio Developer Hub, де видаються ключі доступу.
• Веб-хуки: відкриває сторінку Налаштування веб-хука. Сама сторінка не змінилася.
• Штучний інтелект — помічники: для підключення AI-помічника. Ключ доступу не потрібен.

Щоб відкрити блок Інтеграції та доступ:

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.

Якщо вам не потрібно нічого розробляти і ви хочете лише працювати з даними з AI-помічника, натисніть на цій самій сторінці Перейти до AI-помічників: AI-помічник підключається без ключа доступу та без реєстрації в Developer Hub.

Крок 2. Зареєструйтеся в Developer Hub

1. У полі Ім’я облікового запису розробника вкажіть назву вашої компанії або ваше ім’я. Користувачі побачать цю назву, коли додаток буде опубліковано в Integrations Hub.
2. У полі Для кого ви плануєте розробити цю інтеграцію? виберіть Для моїх власних об’єктів або об’єктів клієнтів або Для інших компаній через Integrations Hub. Інтеграції для інших компаній проходять перевірку перед публікацією в Integrations Hub.
3. У полі Для чого використовуватиметься обліковий запис розробника опишіть вашу інтеграцію, наприклад чат-бот для надсилання сповіщень.
4. Перевірте блок Контактні дані. Поля Ім’я, Номер телефону та Email заповнюються з вашого профілю в Altegio. Менеджер Altegio може зв’язатися з вами за цими контактами, тому переконайтеся, що дані актуальні.
5. У полі Сайт програми вкажіть сайт вашої компанії.
6. Натисніть зареєструватися.

У формі реєстрації в Developer Hub немає поля для токена, і ключ доступу на цьому кроці не видається: після реєстрації в Developer Hub створюються додатки та ключі доступу.

Крок 3. Скопіюйте ключ доступу

Ключі доступу розташовані в блоці Мої ключі API вашого облікового запису в Developer Hub.

1. Знайдіть поле Клавіша швидкого доступу. Якщо ключів ще немає, натисніть Створити ключ API.
2. Скопіюйте ключ доступу та збережіть його в надійному місці.

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

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

Налаштування веб-хука

Сторінка Налаштування веб-хука відкривається в розділі Налаштування > Інтеграції та доступ > Веб-хуки. Сама сторінка не змінилася.

Підключення AI-помічника до Altegio

AI-помічнику не потрібен ключ доступу для роботи з Altegio. Щоб вибрати спосіб підключення AI-помічника, відкрийте Налаштування > Інтеграції та доступ > Штучний інтелект — помічники. На сторінці Штучний інтелект — помічники 2 картки.

Готові рішення на основі штучного інтелекту. AI-додатки з Маркетплейсу Altegio, наприклад AI-адміністратори, нагадування та аналітика, які підключаються без розробки. Натисніть Відкрити в Marketplace, щоб переглянути їх у Маркетплейсі. У кожного додатка своя ціна, вона вказана в картці додатка.

Підключення Altegio до штучного інтелекту через MCP. Для AI-додатків, які підтримують MCP-сервери, наприклад Claude, ChatGPT або Cursor. Ви входите з обліковим записом Altegio, і помічник отримує доступ до тих самих даних і дій, що й власник облікового запису. У картці перелічено 3 MCP-сервери Altegio:

• Altegio Pro MCP: повний доступ до даних філії, читання та запис.
• Altegio Pro MCP (лише для читання): доступ до даних філії лише для читання.
• Altegio Integrations Hub MCP: доступ до API Altegio для створення інтеграцій.

Щоб підключити MCP-сервер Altegio:

1. Поруч із потрібним сервером натисніть Відкрито. Сторінка сервера відкриється в Маркетплейсі.
2. Вставте адресу сервера в Claude, ChatGPT, Cursor або інший AI-додаток.
3. Увійдіть за допомогою свого облікового запису Altegio.

Ключ доступу або токен не потрібен. Що вміє кожен сервер і яку адресу вставляти, читайте в статті MCP-сервери Altegio для AI-помічників.

Часті питання