Интеграция 1С-Битрикс с сервисами онлайн-записи (YCLIENTS)

Вы запустили сайт на 1С-Битрикс и подключили YCLIENTS для онлайн-записи. Клиенты оставляют заявки через виджет, но данные о записях остаются в YCLIENTS — в CRM Битрикс они не попадают. Менеджеры вручную переносят информацию, тратят до 10 минут на одну запись, теряют до 30% лидов. При 50 записях в день это 500 минут — более 8 часов работы одного сотрудника. Средний чек салона красоты — $22–32, 30% потерянных лидов — это около $340–490 упущенной выручки ежедневно. Результат — снижение конверсии и недовольные клиенты.

Наша команда реализовала интеграцию для сети из 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 недель. Средний проект обходится в $1k–2.5k, но финальная стоимость рассчитывается индивидуально и зависит от сложности.

Более 7 лет занимаемся интеграциями Битрикс и YCLIENTS, реализовали 40+ проектов для салонов красоты, клиник и фитнес-центров.

YCLIENTS REST API v2 Documentation

Получите консультацию по интеграции вашего проекта. Оценим сроки и сложность. Закажите интеграцию — и мы подготовим детальный план автоматизации.