Інтеграція 1С-Бітрікс з Chatra: налаштування та ліди

Чому варто інтегрувати Chatra з Бітрікс?

Втрата лідів через анонімні діалоги — типова біль інтернет-магазинів на Бітрікс. Кожен другий користувач йде без відповіді, якщо оператор не бачить його даних. Відвідувач заходить, питає про доставку — оператор не знає ні імені, ні кошика. Діалог втрачає контекст, клієнт іде. За статистикою, 70% операторів витрачають час на з'ясування даних замість вирішення проблеми. Chatra важить лише 15 КБ — у 4 рази легше, ніж Jivo (60 КБ). Це означає, що сайт не гальмує, а швидкість завантаження не страждає. Інтеграція Chatra з 1С-Бітрікс вирішує цю проблему. Ми налаштовуємо інтеграцію Chatra з 1С-Бітрікс вже понад 50 разів і знаємо всі підводні камені. Результат — конверсія чату в ліди зростає в 3 рази, а середній час обробки діалогу скорочується на 40%.

Chatra — онлайн-чат з фокусом на простоту і швидкість. Офлайн-форма замість закритого віджета, автосповіщення за поведінкою, перегляд тексту, який набирається. Інтеграція з Бітрікс — це насамперед ідентифікація користувача та передача даних сесії в операторський інтерфейс.

Як налаштувати ідентифікацію та передачу даних?

1. Встановлення коду Chatra — вставте скрипт у шаблон Бітрікс перед </body>, використовуючи ChatraID з вашого акаунту.
2. Налаштування clientId — для авторизованих користувачів передайте стабільний ідентифікатор (хеш від email або ID). Без нього кожен візит анонімний.
3. Передача даних кошика — завантажте кошик через Bitrix\Sale\Basket та передайте через Chatra('setIntegrationData', {...}).
4. Налаштування автосповіщень — використовуйте тригери в інтерфейсі Chatra або JavaScript для складних сценаріїв.
5. Створення 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; ?> 

Типові помилки при інтеграції

Обсяг робіт і терміни

Ми виконуємо інтеграцію під ключ:

• Встановлення коду Chatra з урахуванням особливостей шаблону
• Ідентифікація авторизованих користувачів (clientId, email, ім'я, телефон)
• Передача даних кошика та контексту сторінки
• Налаштування автосповіщень за сценаріями
• Webhook для створення лідів/завдань в Бітрікс24
• Вимкнення чату на службових сторінках
• Документація та навчання операторів

Термін інтеграції — від 2 до 4 робочих днів залежно від складності. Вартість розраховується індивідуально. Досвід команди — понад 50 інтеграцій Бітрікс з різними сервісами. Гарантуємо коректну роботу всіх сценаріїв.

Результат у цифрах

Додаткові сценарії: відправка промокоду через автосповіщення при перегляді кошика >30 сек (зростання конверсії на 15%), сповіщення оператора про VIP-клієнта.

Як замовити інтеграцію

Зв'яжіться з нами для безкоштовної консультації. Ми оцінимо ваш проект, підготуємо пропозицію та реалізуємо інтеграцію в строк. Замовте налаштування Chatra з 1С-Бітрікс — усуньте втрату лідів і підвищте конверсію.