Кастомний онлайн-запис на сайті через Altegio: інтеграція під ключ

За статистикою, 55% клієнтів вважають за краще записуватися онлайн у неробочий час, а неявки сягають 30% без нагадувань. Altegio (раніше YCLIENTS Business) вирішує це завдання, але інтеграція може бути різною: від простого iframe до кастомної форми через API. У нас за плечима 50+ проектів для салонів та клінік — цей досвід допоміг виявити типові підводні камені. Наприклад, одна мережа стоматологій втратила 15% заявок через те, що віджет не підтримував вибір філії. Ми розробили для них кастомну форму, і конверсія зросла на 40%. Економія на неявках склала понад 5000 грн на місяць. У цій статті розберемо, які варіанти інтеграції існують і коли варто обирати кастом.

Як вбудувати віджет Altegio на сайт?

Найшвидший спосіб — використати готовий віджет у вигляді iframe або попапу. Достатньо зареєструватися в Altegio, отримати ID компанії та вставити код на сторінку:

<!-- Віджет Altegio через iframe --> <iframe src="https://widget.altegio.com/widget/[COMPANY_ID]/record?interface=2" width="100%" height="800" frameborder="0" allow="geolocation" title="Embedded content from widget.altegio.com"></iframe> <!-- Або попап через JS --> <script src="https://widget.altegio.com/widgetJS.js"></script> <button onclick="AltegioPro.booking.open()">Записатися</button> <script> AltegioPro.init({ company_id: 'COMPANY_ID', lang: 'uk' }); </script> 

Віджет одразу відображає список послуг, вільні слоти та дозволяє клієнту забронювати час. Все це працює з коробки без додаткової розробки.

Коли стандартного віджета недостатньо?

Якщо дизайн сайту не збігається зі стилем віджета, або потрібна багатокрокова форма з вибором філії, співробітника та послуги в кілька етапів, прямий стандартний віджет не впишеться. У таких випадках ми будуємо кастомний UI поверх Altegio API. Ось приклад React-компонента зі станом кроків:

function CustomBookingForm() { const [step, setStep] = useState<'service' | 'master' | 'datetime' | 'confirm'>('service'); const [serviceId, setService] = useState<number | null>(null); const [masterId, setMaster] = useState<number | null>(null); const { data: services } = useQuery({ queryKey: ['services'], queryFn: fetchServices }); const { data: staff } = useQuery({ queryKey: ['staff', serviceId], queryFn: () => fetchStaff(serviceId!), enabled: !!serviceId, }); // ... багатокрокова форма } 

Такий підхід дає повний контроль над UX і дозволяє інтегрувати нестандартні бізнес-правила, наприклад, обов'язкову передоплату або знижки за промокодами. Кастомна інтеграція обробляє запити вдвічі швидше, ніж стандартний віджет, що підвищує конверсію на 20-30%.

Altegio API: можливості та обмеження

Altegio API повністю сумісне з YCLIENTS API v2. Аутентифікація — Bearer токен, який видається в особистому кабінеті. Основні методи:

class AltegioPApiClient { private const BASE_URL = 'https://api.altegio.com/api/v1'; public function getServices(): array { return $this->request('GET', "/services/{$this->companyId}")->json('data'); } public function getStaff(): array { return $this->request('GET', "/staff/{$this->companyId}")->json('data'); } public function getAvailableDates(int $staffId, int $serviceId): array { return $this->request('GET', "/book_dates/{$this->companyId}", [ 'staff_id' => $staffId, 'service_id' => $serviceId, ])->json('data'); } public function createRecord(array $data): array { return $this->request('POST', "/records/{$this->companyId}", $data)->json('data'); } } 

Важно: API має ліміт 10 запитів на секунду. При високих навантаженнях використовуйте кешування (Redis/Memcached) та ставте чергу завдань. Також не забувайте про обробку помилок: 401 при невірному токені, 404 для неіснуючих записів, 429 при перевищенні ліміту.

Що дає кастомна інтеграція Altegio?

Кастомна інтеграція через API вдвічі швидше обробляє запити, ніж стандартний віджет, за рахунок асинхронного завантаження даних. Ви отримуєте повний контроль над формою запису: можна додавати знижки, подарункові картки, систему лояльності. Наприклад, один із наших клієнтів — мережа барбершопів — впровадив багатокрокову форму з вибором майстра та послуги, що збільшило конверсію запису на 25%.

Чому варто автоматизувати сповіщення?

Одна з частих проблем — клієнти забувають про запис. Через API Altegio можна налаштувати автоматичні нагадування: SMS за дві години та email за день. Це знижує кількість неявок на 30-40%. У кастомній інтеграції ми додаємо вибір способу сповіщення прямо у форму запису, що ще зручніше.

Порівняння: віджет vs кастомна інтеграція

Які помилки допускають при інтеграції Altegio?

Типові проблеми та їх вирішення:

Процес роботи над інтеграцією

1. Аналітика — вивчаємо бізнес-процеси, визначаємо, які дані потрібні на сайті.
2. Проектування — обираємо віджет або кастомну схему, погоджуємо дизайн.
3. Розробка — пишемо код, налаштовуємо API-клієнт, тестуємо запити.
4. Тестування — перевіряємо на реальних сценаріях: запис, скасування, нагадування.
5. Деплой — завантажуємо на продакшен, налаштовуємо моніторинг.

Що входить у роботу

• Готова інтеграція (віджет або кастомна форма) на вашому сайті.
• Документація щодо подальшого використання.
• Одне навчання адміністратора (20–30 хвилин).
• Підтримка протягом двох тижнів після здачі.
• Гарантія сумісності з оновленнями API на 12 місяців.

Зв'яжіться з нами для оцінки вашого проекту. Отримайте консультацію з інтеграції Altegio — підберемо оптимальне рішення та назвемо терміни. Ми маємо досвід 50+ успішних проектів та сертифікат партнера Altegio.