Ви запустили сайт на 1С-Бітрікс і підключили YCLIENTS для онлайн-запису. Клієнти залишають заявки через віджет, але дані про записи залишаються в YCLIENTS — у CRM Бітрікс вони не потрапляють. Менеджери вручну переносять інформацію, витрачають до 10 хвилин на один запис, втрачають до 30% лідів. При 50 записах на день це 500 хвилин — більше 8 годин роботи одного співробітника. Втрата лідів призводить до значного зниження виручки. Результат — зниження конверсії та незадоволені клієнти.
Наша команда реалізувала інтеграцію для мережі з 12 салонів краси: після впровадження автоматизації час на обробку одного запису скоротився з 8 хвилин до 2 секунд — це в 240 разів швидше ручного введення, а конверсія в продаж зросла на 22%. Як це працює — розберемо нижче.
Чому важлива синхронізація YCLIENTS та Бітрікс?
Єдина CRM — це не просто зручність, а основа для маркетингу та аналітики. Ви бачите, з якого джерела прийшов клієнт, які послуги популярні, де втрачаються заявки. Без інтеграції ці дані розрізнені, а бізнес-процеси гальмуються ручним вводом. Webhook-обробка дозволяє реагувати миттєво: клієнт записався — у CRM вже лід.
Що інтегруємо: ключові сценарії
YCLIENTS надає REST API v2. Основні сутності: records, clients, services, staff, bookforms. Для нас пріоритетні записи та клієнти.
Сценарії:
- Новий запис у YCLIENTS → лід у CRM (створення або оновлення)
- Клієнт з CRM → картка клієнта в YCLIENTS (двонаправлена синхронізація)
- Скасування запису → оновлення статусу угоди (JUNK)
- Вітрина послуг YCLIENTS на сайті через віджет
YCLIENTS API: авторизація
YCLIENTS використовує Bearer-токен, отримуваний в обмін на логін/пароль. Токен живе довго (кілька місяців), зберігаємо в налаштуваннях модуля.
namespace Local\YClients; class ApiClient { private string $baseUrl = 'https://api.yclients.com/api/v1'; private string $partnerToken; private string $userToken; public function __construct() { $this->partnerToken = \Bitrix\Main\Config\Option::get('local.yclients', 'partner_token'); $this->userToken = \Bitrix\Main\Config\Option::get('local.yclients', 'user_token'); } public function request(string $method, string $path, array $data = []): array { $url = $this->baseUrl . $path; $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $url, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $this->partnerToken . ', User ' . $this->userToken, 'Accept: application/vnd.yclients.v2+json', 'Content-Type: application/json', ], ]); if ($method === 'POST') { curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); } elseif ($method === 'PUT') { curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT'); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); } $response = json_decode(curl_exec($ch), true); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode >= 400) { throw new \RuntimeException("YCLIENTS API error {$httpCode}: " . ($response['meta']['message'] ?? 'unknown')); } return $response['data'] ?? $response; } } Як налаштувати вебхук для створення лідів?
YCLIENTS підтримує події: record_created, record_updated, record_cancelled, client_created. Налаштування в ОК YCLIENTS: Інтеграції → Webhook.
// /local/api/yclients-webhook.php require_once($_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php'); $payload = json_decode(file_get_contents('php://input'), true); $signature = $_SERVER['HTTP_X_YCLIENTS_HOOK_SIGNATURE'] ?? ''; $body = file_get_contents('php://input'); $secret = \Bitrix\Main\Config\Option::get('local.yclients', 'webhook_secret'); if (hash_hmac('sha256', $body, $secret) !== $signature) { http_response_code(403); exit; } $eventType = $payload['resource'] ?? ''; $data = $payload['data'] ?? []; match ($eventType) { 'record_created' => (new \Local\YClients\RecordHandler())->onCreate($data), 'record_cancelled' => (new \Local\YClients\RecordHandler())->onCancel($data), 'record_updated' => (new \Local\YClients\RecordHandler())->onUpdate($data), default => null, }; http_response_code(200); Обробник запису створює лід із полями: назва (послуги), телефон, ім'я, коментар з деталями, а також користувацькі поля для ідентифікації запису в YCLIENTS. При скасуванні статус угоди змінюється на JUNK.
Синхронізація клієнтів з Бітрікс у YCLIENTS
При створенні угоди в Бітрікс (клієнт зацікавлений у послузі) автоматично створюємо клієнта в YCLIENTS. Пошук за телефоном — якщо знайдено, оновлюємо картку, якщо ні — створюємо нову. ID клієнта зберігається в користувацькому полі угоди.
Варіанти інтеграції: таблиця порівняння
| Спосіб | Коли використовувати | Складність | Термін |
|---|---|---|---|
| Вебхуки | Потрібна миттєва реакція на події в YCLIENTS | Низька | 1–2 тижні |
| Pull API | Потрібне періодичне вивантаження даних (раз на годину) | Середня | 2–3 тижні |
| Двонаправлена синхронізація | Повна консистентність даних | Висока | 3–5 тижнів |
Що входить у роботу (deliverables)
- Детальна документація з інтеграції (схеми даних, конфіги)
- Вихідний код модуля з коментарями
- Налаштування вебхуків і токенів
- Створення користувацьких полів у CRM
- Тестування на staging-середовищі
- Навчання адміністраторів (1 година)
- Гарантія на код 6 місяців і підтримка після запуску
Покрокова інструкція з налаштування вебхука (для адміністраторів)
- Отримайте партнерський токен в ОК YCLIENTS (Налаштування → API).
- Збережіть токен і секрет вебхука в налаштуваннях модуля.
- Розмістіть файл-обробник за адресою
/local/api/yclients-webhook.php. - В ОК YCLIENTS додайте URL вебхука (Інтеграції → Webhook → Додати).
- Перевірте створення запису — у CRM з'явиться новий лід.
Типові етапи інтеграції
| Етап | Що робимо | Термін |
|---|---|---|
| Аналіз | Вивчаємо поточний сайт, YCLIENTS, сценарії | 1–2 дні |
| Проектування | Створюємо схему даних, визначаємо користувацькі поля | 1 день |
| Розробка | Пишемо API-клієнт, вебхук-обробник, синхронізацію | 5–10 днів |
| Тестування | Перевіряємо всі сценарії, обробляємо edge cases | 2–3 дні |
| Деплой | Викочуємо на продакшен, налаштовуємо моніторинг | 1 день |
Терміни та як замовити
Базова інтеграція (вебхук → лід) займає 1–2 тижні. Двостороння синхронізація з вітриною послуг — 3–5 тижнів. Фінальна вартість розраховується індивідуально і залежить від складності.
Більше 7 років займаємося інтеграціями Бітрікс та YCLIENTS, реалізували 40+ проектів для салонів краси, клінік та фітнес-центрів.
YCLIENTS REST API v2 Documentation
Отримайте консультацію з інтеграції вашого проекту. Оцінимо терміни та складність безкоштовно. Замовте інтеграцію — і ми підготуємо детальний план автоматизації.