Інтеграція 1С-Бітрікс із LiveTex

Інтеграція 1С-Бітрікс з LiveTex

LiveTex — платформа для комунікації з клієнтами: онлайн-чат, чат-боти, інтеграція з месенджерами (WhatsApp, Telegram, VK), обробка звернень у єдиному операторському інтерфейсі. Інтеграція з Бітрікс вирішує два завдання: збагачення операторського інтерфейсу даними про клієнта та передача звернень у CRM.

Установка віджета

LiveTex надає скрипт віджета, який підключається в шаблон Бітрікс:

<!-- У шаблоні сайту, перед </body> -->
<script>
(function(d, w, c) {
    w[c] = w[c] || [];
    w[c].push(function() {
        LiveTex.Widget.init({widgetId: 'YOUR_WIDGET_ID'});
    });
    var s = d.createElement('script');
    s.type = 'text/javascript';
    s.async = true;
    s.src = 'https://cs.livetex.ru/js/widget.js';
    var f = d.getElementsByTagName('script')[0];
    f.parentNode.insertBefore(s, f);
}(document, window, 'livetex_callbacks'));
</script>

У Бітрікс зручніше додавати через Налаштування → Налаштування продукту → JS-фрагменти — так скрипт не загубиться при оновленні шаблону.

Передача даних користувача з Бітрікс

LiveTex API дозволяє передавати ім'я, email, телефон і довільні атрибути до початку чату:

<?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 — словник довільних даних, що відображаються в інтерфейсі LiveTex.

Передача URL сторінки та контексту

LiveTex автоматично визначає URL сторінки, але можна передати додатковий контекст — наприклад, назву розділу або ID товару в картці:

<?php if (defined('CURRENT_PRODUCT_ID')): ?>
<script>
(window.livetex_callbacks = window.livetex_callbacks || []).push(function () {
    LiveTex.Widget.setVisitorAttributes({
        custom: {
            'Поточний товар': <?= json_encode($arResult['NAME']) ?>,
            'Артикул':        <?= json_encode($arResult['PROPERTIES']['ARTICLE']['VALUE']) ?>,
            'Ціна':           <?= $arResult['CATALOG_PRICE_1'] ?> + ' грн.',
        }
    });
});
</script>
<?php endif; ?>

Webhook LiveTex для створення звернень у Бітрікс

LiveTex надсилає webhook при завершенні діалогу. Це використовується для створення лідів або задач у Бітрікс24:

// /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));

    // Створюємо лід у Бітрікс24
    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 webhook вказується в адміністративній панелі LiveTex: Налаштування → Інтеграції → Webhooks.

Інтеграція з Бітрікс24 через OpenLine

Якщо у клієнта є Бітрікс24 (а не лише 1С-Бітрікс), LiveTex може працювати як зовнішній канал через API Відкритих ліній. Повідомлення з LiveTex з'являються в Бітрікс24 CRM як звернення у Відкритій лінії, оператор відповідає з Бітрікс24, відповідь іде клієнту в чат на сайті.

Це потребує налаштування Бітрікс24 REST API та реєстрації Webhook в обидва боки — складніше, ніж проста передача лідів, але дає єдиний інтерфейс для оператора без перемикання між системами.

Склад робіт

• Установка віджета LiveTex у шаблон Бітрікс
• Скрипт передачі даних авторизованого користувача
• Передача контексту сторінки (розділ каталогу, картка товару)
• Налаштування Webhook для створення лідів у Бітрікс24
• Тестування в різних сценаріях (гість, авторизований, мобільний браузер)

Терміни: установка та базова передача даних — 1–2 дні. Webhook і створення лідів — ще 1–2 дні. Повна інтеграція з Відкритими лініями Бітрікс24 — 1–2 тижні.