Вступ
Відкрита екосистема Altegio дозволяє розширювати основні модулі бронювання, CRM та ERP за допомогою партнерських застосунків і кастомних інтеграцій. У цьому гайді розглянуто категорії Маркетплейсу, модель встановлення для мереж і франшиз, поведінку вебхуків при відключенні застосунку та схеми аналітичних подій — а також практичні патерни для платежів, месенджерів/WhatsApp, IP-телефонії, CRM і звітності в Power BI. Посилання ведуть на офіційну документацію Altegio для реалізації.
Категорії Маркетплейсу та профільна документація
| Категорія | Типові інтеграції та їхні можливості | Ключова документація |
| Платежі | Онлайн-оплата/передоплата, продаж абонементів, обробка комісій за картками через платіжні шлюзи (наприклад, Stripe, VivaWallet, MonoBank, LiqPay, PIX) | Дивіться налаштування платежів у платформі та гайди партнерів: Налаштування платформи (огляд платежів), Партнерські сайти та платежі |
| Чат-боти, WhatsApp, SMS | Нагадування через WhatsApp/SMS, повторне залучення клієнтів, масові розсилки, збір відгуків | Каталог чат-ботів, Fromni WhatsApp/SMS, SMS.to, Каталог SMS-провайдерів |
| IP-телефонія | Ідентифікація абонента, записи розмов, callback-сценарії, аналітика дзвінків для всієї мережі | Інтеграції IP-телефонії, Звіти — дзвінки |
| CRM | Синхронізація лідів/записів із зовнішніми CRM (наприклад, Kommo через інтеграторів) | Центр документації (інтеграції), Бронювання через соцмережі та CRM |
| Аналітика та BI | Події бронювання GA4/Meta Pixel, передача Client ID, дашборди Power BI | Підключення GA4, Схема подій, Аналітика віджета та примітки, Client ID (UA), Power BI — Smart-Metrika, Індекс Power BI |
| Лояльність і абонементи | Цифрові картки, подарункові картки, бонуси, обмеження онлайн-бронювання за абонементом | Картки лояльності (мережа), Транзакції лояльності, Інтеграція LoyalCards, Boomerangme, Бронювання лише за абонементом |
Модель встановлення для мереж і франшиз
Встановлення застосунку в кількох філіях
Altegio підтримує встановлення застосунку з Маркетплейсу одразу в кількох філіях в одному потоці. Під час підключення користувач обирає філії; ваш сервіс отримує масив ID філій (salon_ids[]). Ви маєте активувати свою інтеграцію для кожного ID, щоб відкрити доступ до API та реєстрацію вебхуків для конкретної філії. Розробники вмикають цю функцію в налаштуваннях застосунку («Дозволити додавати застосунок у кілька філій»). Дивіться гайд зі встановлення в кількох філіях.
Уніфікація даних мережі (для розробників застосунків)
- Граф клієнтів: єдина база клієнтів мережі та консолідована «мережева картка клієнта» показують витрати, візити, відвідані локації та активи лояльності конкретної людини в усій мережі. Дивіться Базу клієнтів мережі та Мережеву картку клієнта.
- Аналітика показує метрики унікальних клієнтів, завантаженості, бронювань і виручки для мереж; дедублікація запобігає повторним контактам з одним і тим же клієнтом. Дивіться Які завдання вирішує мережева аналітика.
Життєвий цикл вебхуків і сценарій «відключення»
Коли користувач відключає ваш застосунок з Маркетплейсу:
- Усі налаштування інтеграції видаляються на рівні локації.
- Доступ до API для цієї локації відкликається, і Altegio перестає надсилати події на ваші вебхуки.
- Altegio надсилає вебхук «відключення» на callback-URL, вказаний у налаштуваннях вашого застосунку (формат наведено в документації API на відповідній сторінці). Дивіться Відключення інтеграції.
Схеми аналітичних подій і атрибуція
Підключення та перевірка GA4
Підключіть GA4, додавши веб-потік даних (G-XXXXXXXXX) і вставивши Measurement ID у розділ Інтеграції → Аналітика → Google Analytics. Перевірте підключення за допомогою звітів у реальному часі. Дивіться Налаштування GA4.
Таксономія подій віджета бронювання
Віджет онлайн-бронювання надсилає стандартизовані події в GA/Meta, зокрема (перелік неповний): widget_loaded, service_selected, master_selected, date_selected, time_selected, booked, appointment_changed, appointment_deleted, company_page_open, master_page_open, review_created. Дивіться Повний перелік подій та Примітки щодо аналітики віджета.
Примітки щодо реалізації:
- Кожне посилання для бронювання може бути прив’язане лише до одного потоку даних (для кількох потоків створюйте додаткові форми). Дивіться Налаштування GA4.
- Можливі незначні розбіжності між даними аналітики та платформи, коли клієнти користуються кількома джерелами. Дивіться Примітки щодо аналітики віджета.
- (Застаріле/UA) Ви можете передавати власний Client ID, щоб об’єднати ідентифікатори GA та CRM. Дивіться Передачу Client ID.
Типові патерни інтеграцій
1) Платежі та передоплата
- Увімкніть онлайн-передоплату для послуг і групових подій; налаштуйте комісії провайдера та рахунок, куди надходять кошти (прив’язка до каси). Дивіться Партнерські сайти та платежі та Гайд з налаштування комісії за картки.
- За потреби обмежте онлайн-бронювання лише активними абонементами (фітнес/освіта). Дивіться Бронювання лише за абонементом.
2) Месенджери: автоматизація WhatsApp/SMS
- Підключіть WhatsApp/SMS-провайдера для нагадувань, повторного залучення клієнтів, що не з’явилися, привітань з днем народження та збору відгуків; деякі партнери додають тригери для «втрачених» клієнтів. Дивіться Каталог чат-ботів, Fromni WhatsApp/SMS та SMS.to.
- Базова система сповіщень (SMS/Email/Push/WhatsApp) налаштовується в Altegio. Дивіться Функцію сповіщень.
3) IP-телефонія з операційною аналітикою
- Інтегруйте віртуальну АТС/SIP, щоб бачити ім’я абонента, картку клієнта, швидке бронювання, переведення дзвінків і callback; зберігайте записи розмов протягом 1 року та аналізуйте дзвінки через Звіти → Дзвінки. Дивіться Інтеграції IP-телефонії та Звіти — дзвінки.
4) CRM і джерела лідів
- Направляйте дані про бронювання/ліди у вашу CRM (наприклад, Kommo через інтеграторів) і використовуйте соцмережі та карти як точки входу для конверсії. Дивіться Онлайн-бронювання через соцмережі та Бронювання через Google.
5) Дашборди Power BI для мереж
- Передавайте корпоративні KPI (когорти, утримання клієнтів, завантаженість тайм-слотів, продажі послуг/персоналу, план vs. факт) у Power BI через Smart-Metrika. Дивіться Power BI — Smart-Metrika та Індекс Power BI.
6) Лояльність і цифрові картки
- Випускайте та синхронізуйте цифрові картки з Apple Wallet/Google Pay, надсилайте геозалежні/push-сповіщення та звіряйте транзакції між локаціями. Дивіться LoyalCards, Boomerangme та Картки лояльності (мережа).
Мережева аналітика та звіти, на які можуть спиратися ваші застосунки
- Прибутковість послуг і частка виручки (лише за статусом «Прийшов»); фільтрація за періодом, категорією послуг, співробітником, локацією; експорт в Excel. Дивіться Мережевий звіт з послуг.
- Заробіток персоналу, продані послуги/товари, години, вартість години, % від виручки — за локацією та періодом; експорт і перевірені завантаження. Дивіться Мережевий звіт з персоналу.
Безпека, приватність і контроль доступу
- Ролі щодо даних: бізнеси є контролерами даних своїх клієнтів; Altegio виступає обробником. Дотримується GDPR. Дивіться Політику конфіденційності (ЄС).
- Інфраструктура та розташування даних: задокументований хостинг у ЄС (Hetzner, Німеччина). Дивіться Про Altegio.
- Гнучкі права доступу та контроль витоку даних, включно з маскуванням контактів клієнтів, правами по розділах і журналами дій. Дивіться Захист ваших даних та Права доступу до календаря записів.
Чек-лист для розробників
- Проєктуйте з розрахунком на мережу: обробляйте масиви ID філій і активуйте застосунок для кожної окремо. Дивіться Встановлення в кількох філіях.
- Реалізуйте надійний обробник відключення: очищуйте стан по кожній філії на своїй стороні при отриманні вебхука відключення; враховуйте, що Altegio припинить доставку подій і відкличе доступ до API. Дивіться Сценарій відключення.
- Використовуйте офіційні назви подій віджета для аналітики; правильно підключайте GA4 і документуйте будь-які застереження щодо атрибуції. Дивіться Схему подій та Налаштування GA4.
- Для сценаріїв месенджерів/платежів звертайтеся до сторінок налаштування конкретних партнерів у службі підтримки Altegio, щоб уникнути помилок конфігурації (наприклад, шаблони WhatsApp, прив’язка комісій за картки, правила абонементів). Дивіться розділи вище.
Додаткові ресурси
- Центр документації (кілька модулів, кілька галузей): Головна підтримки
- Карта документації з онлайн-бронювання: Документація з онлайн-бронювання
- Каталог аналітичних звітів: Аналітика та звіти