Інтеграція 1С-Бітрікс з YCLIENTS: автоматична синхронізація записів

Ви запустили сайт на 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 клієнта зберігається в користувацькому полі угоди.

Варіанти інтеграції: таблиця порівняння

Що входить у роботу (deliverables)

• Детальна документація з інтеграції (схеми даних, конфіги)
• Вихідний код модуля з коментарями
• Налаштування вебхуків і токенів
• Створення користувацьких полів у CRM
• Тестування на staging-середовищі
• Навчання адміністраторів (1 година)
• Гарантія на код 6 місяців і підтримка після запуску

Типові етапи інтеграції

Терміни та як замовити

Базова інтеграція (вебхук → лід) займає 1–2 тижні. Двостороння синхронізація з вітриною послуг — 3–5 тижнів. Фінальна вартість розраховується індивідуально і залежить від складності.

Більше 7 років займаємося інтеграціями Бітрікс та YCLIENTS, реалізували 40+ проектів для салонів краси, клінік та фітнес-центрів.

YCLIENTS REST API v2 Documentation

Отримайте консультацію з інтеграції вашого проекту. Оцінимо терміни та складність. Замовте інтеграцію — і ми підготуємо детальний план автоматизації.