У Barberly тепер є публічний API бронювання (Booking API). З ним ваш власний сайт, застосунок, бот у WhatsApp, голосовий агент чи ШІ-асистент можуть приймати бронювання у ваш барбершоп з тими самими послугами, командою, вільним часом і правилами бронювання, які ваші клієнти вже бачать у вашому застосунку Barberly.
Що можна створити за допомогою API бронювання для барбершопу
- WhatsApp: бронювання просто в чаті, яким клієнти вже користуються
- ШІ-асистенти: бронювання за вашим реальним вільним часом
- Голосові агенти: автоматичні бронювання телефоном
- Сайти: власний процес бронювання у вашому стилі
- Чат-боти: крок бронювання в будь-якому чат-віджеті
- Власні інтеграції: усе інше, що створює бронювання
Бронює так само, як ваші клієнти
API бронювання - це ще один інструмент для клієнтів поруч із вашим мобільним застосунком, сайтом, віджетами бронювання, кіоском і бронюванням через Google. Це не API для бек-офісу. Він не дає доступу до звітів, керування командою чи налаштувань.
Усе, що ви налаштували для власної сторінки запису, діє без змін:
- Слот, закритий для клієнтів, закритий і в API. Доступність показує клієнтський вигляд вашого календаря, ніколи не вигляд для персоналу.
- Якщо ви підтверджуєте записи вручну, бронювання через API так само надходять непідтвердженими.
- Якщо ви вимагаєте зареєстрованого клієнта, API вимагає його так само.
- Графік роботи, мінімальний час до запису, тривалість послуг і те, хто з барберів що виконує, зчитуються з ваших налаштувань у реальному часі.
API не вигадує власних правил і не може обійти жодного.
Що охоплює API бронювання
- Каталог: локації, учасники команди, послуги з додатковими послугами
- Доступність: вільні дні та слоти за локацією, барбером і послугою
- Бронювання: створення, перегляд, перенесення та скасування
- Акаунти клієнтів: реєстрація, вхід і скидання пароля
Ключі API та права доступу
Спершу налаштуйте в Barberly свої локації, команду, послуги та графік роботи. API читає цю конфігурацію, але не створює її. Потім створіть ключ у порталі Barberly в розділі Apps → Booking API → Create key і надайте йому лише ті права доступу (scopes), які справді потрібні:
| Право доступу | Що дає |
|---|---|
catalog:read | Локації, учасники команди, послуги, доступність |
bookings:read | Перегляд бронювання |
bookings:write | Створення, зміна та скасування бронювань |
accounts:write | Реєстрація, вхід і відновлення акаунтів клієнтів |
Передавайте ключ у заголовку X-Api-Key. Ключі можна відкликати або видалити на тому самому екрані.
Спробуйте живі демо
На публічному демо-барбершопі працюють два робочі процеси бронювання для гостей, тож вони одразу показують реальні дані. Обидва проходять через локацію, барбера, послуги з додатковими послугами, дату й час, дані гостя та підтвердження, без входу в акаунт.
- Хаб запису: одна картка з чотирма полями, які гість заповнює в будь-якому порядку
- Покроковий майстер: п'ять кроків зі смугою прогресу
Вихідний код є на GitHub: приклади на React, які можна вивчити, скопіювати або перенести у власний проєкт.
Документація
- Довідник API: кожен ендпоінт і кожне поле
- Документ OpenAPI: згенеруйте клієнт своєю мовою програмування
Поширені запитання
Чи коштує API бронювання додатково?
Ні. API бронювання входить у вашу підписку на Barberly. Жодної додаткової плати за нього немає.
Я не розробник. Як отримати готову інтеграцію?
Дайте ChatGPT, Claude чи іншому ШІ-агенту посилання на довідник API й опишіть, що вам потрібно. За кілька хвилин у вас буде робоча реалізація, з якої можна почати.
Чи можна підключити його до n8n, Make або Zapier?
Так. Будь-який інструмент, який уміє надсилати HTTP-запит із заголовком, може викликати API: вузол HTTP Request в n8n, модуль HTTP у Make або власний запит у Zapier. Ці інструменти можуть створювати, переносити та скасовувати бронювання. Але вони не можуть реагувати на зміни, зроблені всередині Barberly, бо в API поки немає вебхуків.
Чи може голосовий агент або ChatGPT записувати клієнтів через нього?
Так. Голосові платформи, як-от Vapi чи Retell, викликають зовнішні API як інструменти, а власний GPT у ChatGPT може імпортувати документ OpenAPI і передавати ваш ключ у заголовку. Поточного API достатньо для обох випадків.
Чи отримують клієнти звичайні підтвердження бронювання?
Так. Бронювання через API надсилають ті самі сповіщення, які ви налаштували для мобільного застосунку та сайту.
А як щодо депозитів і передоплати?
API бронювання не приймає платежів. Якщо вам потрібен депозит або передоплата, спершу отримайте їх у власному процесі, а потім створіть бронювання через API.
Чи можна побачити, які бронювання надійшли через API?
Так. В історії запису бронювання, зроблене через API, позначено як створене через Booking API, так само як інші бронювання показують мобільний застосунок або сайт.
Чи потрапляють клієнти, які бронюють через API, до моєї клієнтської бази?
Так. Їх додають до ваших клієнтів, як і всіх інших, і вони отримують бали лояльності, коли запис позначено як завершений.
Чи є тестовий режим?
Ні. Поки ви розробляєте інтеграцію, скасовуйте тестові бронювання, які створюєте.
Чи дізнається моя система, коли бронювання змінюється в Barberly?
Не автоматично: вебхуків поки немає. Щоб перевірити бронювання, прочитайте його знову за ID.
У мене кілька локацій. Чи потрібен ключ для кожної?
Ні. Один ключ працює для всіх ваших локацій. Як і в застосунку та на сайті, клієнт обирає локацію під час бронювання.
Чи працює API бронювання з клієнтами без запису або зі списком очікування?
Ні. Він призначений для бронювань: створення, перегляду, перенесення та скасування записів. Черга клієнтів без запису та список очікування працюють через кіоск і застосунок Barberly Business.
