Интеграция 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 недели.