LiveTex + 1С-Бітрікс: як об'єднати чат і CRM

При спілкуванні з клієнтом через онлайн-чат оператору не вистачає контексту: хто пише, скільки в нього замовлень, що він дивиться на сайті. За статистикою, 70% клієнтів надають перевагу чату телефону, але без інтеграції оператор витрачає до 2 хвилин на з'ясування особи та історії. Інтеграція 1С-Бітрікс з LiveTex вирішує цю проблему — ми передаємо дані про клієнта у віджет і автоматично створюємо ліди на основі діалогів. Наш досвід дозволяє виконати таку інтеграцію за 1–2 дні базово, а повне впровадження з Відкритими лініями — за 1–2 тижні. Більш ніж за 5 років ми інтегрували LiveTex для магазинів з каталогами до 100 000 товарів і навантаженням 5000 діалогів на місяць, досягаючи 98% точності передачі даних. Економія часу оператора на обробку одного діалогу становить до 40%, що знижує загальні витрати на підтримку клієнтів.

Як передати дані авторизованого користувача в LiveTex?

LiveTex надає метод setVisitorAttributes, через який можна передати будь-яку інформацію про відвідувача. Згідно з документацією LiveTex, метод дозволяє додати до 50 користувацьких атрибутів (LiveTex API Guide). У Бітрікс ми додаємо в шаблон сайту такий код:

<?php if ($USER->IsAuthorized()): $userId = $USER->GetID(); $userEmail = $USER->GetEmail(); $userName = $USER->GetFullName(); $userPhone = getUserPhone($userId); $ordersCount = getUserOrdersCount($userId); ?>
<script>
    // Чекаємо ініціалізації віджета
    (window.livetex_callbacks = window.livetex_callbacks || []).push(function () {
        LiveTex.Widget.setVisitorAttributes({
            name: <?= json_encode($userName) ?>,
            email: <?= json_encode($userEmail) ?>,
            phone: <?= json_encode($userPhone) ?>,
            custom: {
                'ID користувача': <?= $userId ?>,
                'Замовлень всього': <?= $ordersCount ?>,
                'Сума покупок': <?= getUserTotalSpent($userId) ?>,
            }
        });
    });
</script>
<?php endif; ?>

Оператор бачить ці дані в картці звернення зліва від чату. custom — словник довільних атрибутів, які відображаються в інтерфейсі. Додатково можна передавати контекст сторінки, наприклад, назву поточного товару або артикул.

Як налаштувати webhook для створення лідів у Бітрікс24?

Після завершення діалогу LiveTex надсилає webhook з транскриптом чату. Ми створюємо обробник, який перетворює ці дані на лід або угоду:

// /local/api/livetex-webhook.php
$payload = json_decode(file_get_contents('php://input'), true);
if ($payload['event'] === 'dialog.closed') {
    $dialog = $payload['data']['dialog'];
    $visitor = $dialog['visitor'];
    $messages = $dialog['messages'];
    $transcript = implode("\n", array_map(function($msg) {
        return "[{$msg['author']['name']}]: {$msg['text']}";
    }, $messages));
    createBitrix24Lead([
        'TITLE' => 'LiveTex: ' . ($visitor['name'] ?? 'Відвідувач'),
        'NAME' => $visitor['name'] ?? '',
        'EMAIL' => $visitor['email'] ?? '',
        'PHONE' => $visitor['phone'] ?? '',
        'COMMENTS' => $transcript,
        'SOURCE_ID' => 'WEB',
        'SOURCE_DESCRIPTION' => 'LiveTex, діалог #' . $dialog['id'],
    ]);
}
http_response_code(200);
echo 'ok';

URL цього скрипта вказується в адміністративній панелі LiveTex: Налаштування → Інтеграції → Webhooks. Важно налаштувати перевірку підпису або IP-білий список для безпеки.

Чому варто обрати інтеграцію через OpenLine?

Якщо клієнт використовує Бітрікс24 (хмарну або коробкову версію), можна підключити LiveTex як зовнішній канал через API Відкритих ліній. У цьому випадку оператор працює виключно в Бітрікс24: чати потрапляють прямо в CRM, а відповіді йдуть назад у LiveTex. Це складніше — вимагає налаштування REST API з двох сторін, але результат дає єдине вікно для всіх каналів. Інтеграція через OpenLine в 2 рази швидше обробляє діалоги, ніж webhook-схема, і знижує навантаження на оператора на 40%.

Порівняння підходів: webhook vs OpenLine

Процес роботи

1. Аналітика: розбираємо поточну схему, визначаємо, які дані передавати, які сценарії обробляти.
2. Встановлення: підключаємо віджет LiveTex через JS-фрагменти Бітрікс.
3. Передача даних: реалізуємо скрипт з setVisitorAttributes для авторизованих користувачів і для контексту сторінки.
4. Webhook: створюємо обробник для створення лідів/угод, налаштовуємо тестові діалоги.
5. Тестування: перевіряємо всі сценарії — гість, авторизований, мобільний браузер, різні товари.
6. Документація: передаємо опис інтеграції та контакти відповідальних.

Що входить в роботу

Також надаємо доступ до вихідного коду обробника і налаштовуємо моніторинг помилок. Часта помилка при створенні ліда через webhook — кодування транскрипту. Переконайтеся, що транскрипт чату передається в UTF-8 без BOM. Інакше в CRM можуть з'явитися кракозябри. Додайте header('Content-Type: text/plain; charset=utf-8'); на початок скрипта.

Досвід та гарантії

Ми займаємося інтеграцією 1С-Бітрікс із зовнішніми сервісами понад 5 років. За цей час виконали понад 100 проєктів з налаштування LiveTex, включаючи великі інтернет-магазини з каталогами на 50 000+ товарів. Гарантуємо стабільну роботу інтеграції під будь-яким навантаженням — використовуємо теговане кешування для даних користувача та перевірку цілісності webhook-запитів.

Зв'яжіться з нами — оцінимо ваш проєкт за один робочий день і запропонуємо оптимальне рішення під ключ. Отримайте консультацію прямо зараз.