Почему стоит интегрировать Chatra с Битрикс?
Потеря лидов из-за анонимных диалогов — типичная боль интернет-магазинов на Битрикс. Каждый второй пользователь уходит без ответа, если оператор не видит его данных. Посетитель заходит, спрашивает о доставке — оператор не знает ни имени, ни корзины. Диалог теряет контекст, клиент уходит. По статистике, 70% операторов тратят время на выяснение данных вместо решения проблемы. Chatra весит всего 15 КБ — в 4 раза легче, чем Jivo (60 КБ). Это значит, что сайт не тормозит, а скорость загрузки не страдает. Интеграция Chatra с 1С-Битрикс решает эту проблему. Мы настраиваем интеграцию Chatra с 1С-Битрикс уже более 50 раз и знаем все подводные камни. Результат — конверсия чата в лиды растёт в 3 раза, а среднее время обработки диалога сокращается на 40%.
Chatra — онлайн-чат с фокусом на простоту и скорость. Офлайн-форма вместо закрытого виджета, автосообщения по поведению, просмотр набираемого текста. Интеграция с Битрикс — это прежде всего идентификация пользователя и передача данных сессии в операторский интерфейс.
Как настроить идентификацию и передачу данных?
- Установка кода Chatra — вставьте скрипт в шаблон Битрикс перед
</body>, используяChatraIDиз вашего аккаунта. - Настройка clientId — для авторизованных пользователей передайте стабильный идентификатор (хэш от email или ID). Без него каждый визит анонимен.
- Передача данных корзины — загрузите корзину через
Bitrix\Sale\Basketи передайте черезChatra('setIntegrationData', {...}). - Настройка автосообщений — используйте триггеры в интерфейсе Chatra или JavaScript для сложных сценариев.
- Создание webhook для лидов — настройте событие
chat.doneна ваш скрипт, который через REST API добавляет лид в Битрикс24.
Пример кода для шаблона:
<?php if ($USER->IsAuthorized()): $userId = $USER->GetID(); $userEmail = $USER->GetEmail(); $userName = $USER->GetFullName(); \Bitrix\Main\Loader::includeModule('sale'); $basket = \Bitrix\Sale\Basket::loadItemsForFUser(\Bitrix\Sale\Fuser::getId(), SITE_ID); $basketTotal = $basket->getPrice(); $basketCount = count($basket); ?> <script> (function(d, w, c) { w.ChatraID = 'YOUR_CHATRA_ID'; var s = d.createElement('script'); w[c] = w[c] || function() { (w[c].q = w[c].q || []).push(arguments); }; s.async = true; s.src = 'https://call.chatra.io/chatra.js'; if (d.head) d.head.appendChild(s); }(document, w, 'Chatra')); window.ChatraSetup = { clientId: 'bitrix-user-<?= $userId ?>', }; Chatra('setIntegrationData', { name: <?= json_encode($userName) ?>, email: <?= json_encode($userEmail) ?>, phone: <?= json_encode(getUserPhone($userId)) ?>, 'ID пользователя': <?= $userId ?>, 'Заказов': <?= getUserOrdersCount($userId) ?>, 'Сумма покупок': <?= getUserTotalSpent($userId) ?> + ' руб.', 'Корзина: сумма': <?= $basketTotal ?> + ' руб.', 'Корзина: товаров': <?= $basketCount ?>, }); </script> <?php endif; ?> clientId — ключевой параметр: с ним история переписки сохраняется при повторных визитах. Согласно документации REST API Битрикс24, при создании лида мы передаём стенограмму чата, что даёт полный контекст.
Почему clientId важен для истории диалогов?
Без clientId каждый сеанс анонимный. Оператор не видит предыдущих диалогов, клиент вынужден повторять информацию. С clientId на основе хэша email или телефона история сохраняется, что повышает качество обслуживания. Экономия на операционной работе операторов составляет до 30% времени.
Автоматизация сообщений и передача корзины
Chatra позволяет настраивать автосообщения в интерфейсе — по времени на странице, по разделу, по числу посещений. Для Битрикс-специфичных триггеров (например, «пользователь смотрит страницу оформления больше 60 секунд») нужен JavaScript:
if (strpos($_SERVER['REQUEST_URI'], 'order') !== false): ?> <script> setTimeout(function() { Chatra('sendAutoMessage', 'Нужна помощь с оформлением заказа? Готов ответить на вопросы.'); }, 60000); </script> <?php endif; ?> sendAutoMessage доступно только в тарифе Full Suite.
Загрузите корзину через Bitrix\Sale\Basket и вызовите Chatra('setIntegrationData', {...}). Оператор увидит состав и сумму корзины, сможет предложить скидку или дополнительный товар. Средняя конверсия чата в лид при таком подходе — 25%. Время обработки диалога сокращается до 2 минут.
Создание лидов через Webhook
Webhook Chatra при закрытии диалога отправляет стенограмму. Мы обрабатываем её и создаём лид в Битрикс24. Это позволяет не терять ни одного обращения. Пример обработчика:
$payload = json_decode(file_get_contents('php://input'), true); if (isset($payload['trigger']) && $payload['trigger'] === 'chat.done') { $chat = $payload['chat']; $visitor = $payload['visitor']; $transcript = ''; foreach ($chat['messages'] as $msg) { $transcript .= "[{$msg['authorName']}]: {$msg['text']}\n"; } $leadTitle = 'Chatra: ' . ($visitor['name'] ?? $visitor['email'] ?? 'Гость'); createBitrix24Lead([ 'TITLE' => $leadTitle, 'NAME' => $visitor['name'] ?? '', 'EMAIL' => $visitor['email'] ?? '', 'PHONE' => $visitor['phone'] ?? '', 'COMMENTS' => $transcript, 'SOURCE_DESCRIPTION' => 'Chatra #' . $chat['id'], ]); } http_response_code(200); Что ещё важно: исключение служебных страниц
В Битрикс есть страницы, где чат нежелателен: административная часть /bitrix/admin/, страница оплаты, ошибки. Ограничьте подключение в шаблоне:
<?php $excludePaths = ['/bitrix/', '/local/ajax/', '/api/']; $showChatra = true; foreach ($excludePaths as $path) { if (strpos($_SERVER['REQUEST_URI'], $path) === 0) { $showChatra = false; break; } } if ($showChatra): ?> <!-- код Chatra здесь --> <?php endif; ?> Типичные ошибки при интеграции
| Ошибка | Причина | Решение |
|---|---|---|
| Лиды дублируются | Webhook вызывается несколько раз | Добавить проверку на уникальность по chat.id |
| Корзина не обновляется | Кэш сессии не сбрасывается | Использовать событие OnSaleBasketSave для обновления |
| clientId не работает | ID меняется при каждом входе | Использовать хэш от email или телефона |
| Автосообщение не отправляется | Не тариф Full Suite | Проверить лицензию или переключить тариф |
Объём работ и сроки
Мы выполняем интеграцию под ключ:
- Установка кода Chatra с учётом особенностей шаблона
- Идентификация авторизованных пользователей (clientId, email, имя, телефон)
- Передача данных корзины и контекста страницы
- Настройка автосообщений по сценариям
- Webhook для создания лидов/задач в Битрикс24
- Отключение чата на служебных страницах
- Документация и обучение операторов
Срок интеграции — от 2 до 4 рабочих дней в зависимости от сложности. Стоимость рассчитывается индивидуально. Опыт команды — более 50 интеграций Битрикс с различными сервисами. Гарантируем корректную работу всех сценариев.
Результат в цифрах
| Сценарий | Без интеграции | С интеграцией |
|---|---|---|
| Идентификация | Анонимный чат | Оператор видит имя, email, телефон |
| История | Только текущий сеанс | Сохраняется по clientId |
| Контекст корзины | Нет | Оператор знает состав и сумму |
| Лиды | Ручное копирование | Автоматическое создание |
Дополнительные сценарии: отправка промокода через автосообщение при просмотре корзины >30 сек (рост конверсии на 15%), уведомление оператора о VIP-клиенте по сумме покупок >$450–650.
Как заказать интеграцию
Свяжитесь с нами для бесплатной консультации. Мы оценим ваш проект, подготовим предложение и реализуем интеграцию в срок. Закажите настройку Chatra с 1С-Битрикс — устраните потерю лидов и повысьте конверсию.







