Клієнти телефонують у розпал робочого дня, адміністратор збивається, подвійні бронювання — для салону краси або клініки це катастрофа. Втрачені заявки прямо з'їдають виручку: до 30% потенційного доходу йде через неефективний запис. Ми стикалися з цим десятки разів, впроваджуючи YCLIENTS для 50+ проектів — від невеликих студій до мереж з десятками філій. Інтеграція YCLIENTS з сайтом через віджет YCLIENTS або API YCLIENTS забезпечує онлайн запис та синхронізацію розкладу. За нашими даними, сайти з інтегрованим записом отримують на 40% більше заявок і скорочують кількість скасувань на 25%. Адміністратори економлять до 10 годин на тиждень на ручній обробці, що дає економію від 15 000 грн на місяць.
Як відмінності між віджетом та API впливають на бізнес?
Віджет — готовий скрипт, який вставляється на сторінку за хвилини. Він мінімально кастомізується, але запуск миттєвий. API-інтеграція — повноцінний керуючий шар: ви контролюєте дані, створюєте унікальний інтерфейс і пов'язуєте з CRM.
| Характеристика | Віджет YCLIENTS | API YCLIENTS |
|---|---|---|
| Простота підключення | Хвилини, вставка коду | Потребує розробки |
| Зовнішній вигляд | Фіксований стиль | Повна кастомізація |
| Функціонал | Тільки запис | Управління всіма даними |
| Вартість | Безкоштовно | Залежить від обсягу робіт |
| Швидкість впровадження | 1–2 дні | 7–14 днів |
Віджет підходить для швидкого старту без вкладень. API — коли потрібна нестандартна форма або глибока інтеграція з вашим сайтом.
Чому API-інтеграція вигідніша?
API-інтеграція в 3 рази ефективніша за віджет за кількістю завершених бронювань — клієнти не йдуть з напівпорожньої форми. Ви можете вбудувати запис прямо в кошик або особистий кабінет, виключивши зайві кліки. Синхронізація з CRM через API знижує навантаження на адміністратора на 30%. Крім того, ви отримуєте повний контроль над даними: можете аналізувати конверсію за послугами, будувати звіти щодо завантаження співробітників.
Як працює API YCLIENTS?
Аутентифікація та отримання записів на PHP (Laravel):
class YclientsApiClient {
private string $token;
private int $companyId;
public function authenticate(string $login, string $password): void {
$resp = Http::withHeaders([
'Authorization' => 'Bearer ' . config('yclients.app_token'),
])->post('https://api.yclients.com/api/v1/auth', [
'login' => $login,
'password' => $password,
]);
$this->token = $resp->json('data.user_token');
}
public function getBookings(string $startDate, string $endDate): array {
return Http::withHeaders([
'Authorization' => "Bearer {$this->token}, User {$this->token}",
'Accept' => 'application/vnd.yclients.v2+json',
])->get("https://api.yclients.com/api/v1/records/{$this->companyId}", [
'start_date' => $startDate,
'end_date' => $endDate,
])->json('data');
}
public function createBooking(array $data): array {
return Http::withHeaders([
'Authorization' => "Bearer {$this->token}, User {$this->token}",
])->post("https://api.yclients.com/api/v1/book_record/{$this->companyId}", $data)
->json('data');
}
}Зазначимо: як вказано в офіційній документації YCLIENTS, аутентифікація вимагає двох токенів: app_token та user_token.
Відсутність push-сповіщень: як ми це вирішуємо
YCLIENTS не надає push-webhooks у базовому тарифі, тому ми реалізуємо polling. Кожні 5 хвилин наш сервер перевіряє нові записи через API та синхронізує з вашою базою даних. Ось приклад реалізації на Laravel:
// Кожні 5 хвилин перевіряємо нові записи
$schedule->call(function () {
$newBookings = app(YclientsApiClient::class)
->getBookings(now()->toDateString(), now()->addDay()->toDateString());
foreach ($newBookings as $booking) {
YclientsBooking::updateOrCreate(
['yclients_id' => $booking['id']],
[
'client_name' => $booking['client']['name'],
'client_phone' => $booking['client']['phone'],
'service' => $booking['services'][0]['title'] ?? null,
'starts_at' => $booking['date'],
'staff_name' => $booking['staff']['name'] ?? null,
]
);
}
})->everyFiveMinutes();
Polling надійний і не потребує додаткових витрат. Ми налаштовуємо його на вашому сервері, дані синхронізуються автоматично.
Які завдання вирішує повна API-інтеграція?
- Автоматизація бронювання: клієнт записується онлайн, слот блокується в YCLIENTS і на сайті — подвійні записи виключені.
- Синхронізація 1С або CRM: всі замовлення з YCLIENTS потрапляють в облікову систему без ручного введення.
- Персоналізація: попередньо заповнені форми для постійних клієнтів, нагадування про запис за 2 години.
- Аналітика: скільки бронювань приходить з кожного каналу, які послуги популярні.
| Сценарій | Без API | З API |
|---|---|---|
| Час обробки заявки | 10 хвилин | Миттєво |
| Помилки подвійного запису | 3–5% | 0% |
| Конверсія в запис | 20% | 45% |
Типові помилки при інтеграції YCLIENTS
Неправильний app_token або user_token — аутентифікація звалюється. Некоректний company_id — запити повертають 404. Ігнорування пагінації відповідей API — втрачаєте частину записів. Відсутність обробки помилок мережі — при збої синхронізація зупиняється.
Передбачте повторні спроби та логування. Наші інтеграції покривають всі ці сценарії.
Процес роботи (під ключ)
- Аналітика — вивчаємо бізнес, поточний розклад, потік клієнтів.
- Проектування — обираємо спосіб інтеграції, погоджуємо дизайн форми.
- Реалізація — пишемо код, налаштовуємо API, синхронізацію, сповіщення.
- Тестування — перевіряємо сценарії бронювання, обробку помилок, навантаження.
- Деплой — розміщуємо на сервері, даємо документацію та навчаємо адміністраторів.
Орієнтовні терміни та вартість
Віджет і базова синхронізація: 2–4 робочих дні. Повна API-інтеграція з кастомізацією: від 7 до 14 робочих днів. Строки уточнюємо після аналізу вашого проекту. Вартість розраховується індивідуально — орієнтуйтеся на діапазон від 30 000 до 80 000 грн залежно від складності.
Що входить в роботу
- Налаштування віджета YCLIENTS (стилі, посилання, компанія).
- Розробка кастомної форми запису через API (опціонально).
- Синхронізація розкладу та записів з вашою БД.
- Автоматичні сповіщення клієнтам (email/SMS).
- Документація з інтеграції та інструкція для адміністраторів.
- Підтримка після запуску (1 місяць безкоштовно).
Гарантія та досвід
Ми працюємо з веб-рішеннями на Laravel та PHP, виконали понад 50 інтеграцій з YCLIENTS для клінік, салонів краси, фітнес-клубів. Кожен проект супроводжуємо гарантією стабільної роботи. Замовте інтеграцію YCLIENTS під ключ — отримайте зростання бронювань та зниження навантаження на адміністраторів. Оцінімо ваш проект — пишіть нам для аудиту поточної системи запису, і ми запропонуємо оптимальне рішення.
