Введение
Открытая экосистема 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-телефония | Идентификация звонящего, запись разговоров, сценарии обратного звонка, аналитика звонков по всей сети | Интеграции с 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 поддерживает установку приложения из Маркетплейса сразу в несколько филиалов за один шаг. При подключении пользователь выбирает нужные филиалы, а ваш сервис получает массив их идентификаторов (salon_ids[]). Вам необходимо активировать интеграцию для каждого ID, чтобы открыть доступ к API и зарегистрировать вебхуки для конкретного филиала. Разработчики могут включить эту опцию в настройках приложения («Разрешить добавление приложения в несколько филиалов»). См. руководство по установке в несколько филиалов.
Объединение сетевых данных (для разработчиков приложений)
- Профиль клиента: единая сетевая база клиентов и консолидированная «сетевая карта клиента» позволяют видеть расходы, визиты, посещенные филиалы и баланс программы лояльности человека по всей сети. См. Сетевая база клиентов и Сетевая карта клиента.
- Аналитика отображает показатели по уникальным клиентам, загруженности, записям и доходам для сетей; дедупликация предотвращает повторные рассылки одним и тем же людям. См. Какие задачи решает сетевая аналитика.
Жизненный цикл вебхуков и процесс отключения
Когда пользователь отключает ваше приложение в Маркетплейсе:
- Все настройки интеграции удаляются на уровне филиала.
- Доступ к API для этого филиала аннулируется, и Altegio прекращает отправку событий на ваши вебхуки.
- Altegio отправляет вебхук об отключении («disable») на URL-адрес обработчика (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 для отображения имени звонящего, карты клиента, быстрого создания записи, перевода звонков и обратных вызовов; храните записи разговоров до 1 года и анализируйте звонки в разделе Отчеты → Звонки. См. Интеграции с IP-телефонией and Отчеты — Звонки.
4) CRM и источники лидов
- Направляйте данные о записях и лидах в вашу CRM (например, Kommo через интеграторы) и используйте точки входа из соцсетей и карт для повышения конверсии. См. Онлайн-запись через социальные сети и Запись через Google.
5) Дашборды Power BI для сетей
- Передавайте ключевые бизнес-показатели (когорты, удержание, загруженность временных слотов, продажи услуг/товаров сотрудниками, план-факт) в 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, сопоставление комиссий по картам, правила работы с абонементами). См. разделы выше.
Дополнительные ресурсы
- Центр документации (мультимодульный, для разных отраслей): Раздел поддержки
- Карта документации по онлайн-записи: Документы по онлайн-записи
- Каталог аналитических отчетов: Аналитика и отчеты