Інтеграція Verbox з 1С-Бітрікс: чат, ліди та CRM

Часто після встановлення Verbox віджет не передає дані про клієнта — оператор бачить тільки «Гість», а офлайн-чати губляться. Наприклад, інтернет-магазин з 10 000 товарів втрачав 30% звернень, тому що сповіщення не доходили. Після інтеграції конверсія в чаті виросла на 15%, а час відповіді скоротився вдвічі — з 5 хвилин до 2,5. Середня економія на операційних витратах сягає 40%, а повернення інвестицій відбувається за 2–3 місяці. Ми вирішуємо такі задачі за 1–2 дні. Інтеграція з 1С-Бітрікс вимагає розуміння інфоблоків та кешування. У статті — технічні деталі: як правильно встановити віджет, передати профіль користувача, налаштувати офлайн-форму та CRM.

Як встановити віджет, не зламавши шаблон?

Код віджета вставляється в шаблон Бітрікс:

<!-- Перед </body> в шаблоні сайту -->
<script type="text/javascript">
  var __cs = __cs || [];
  __cs.push(["setCsAccount", "YOUR_ACCOUNT_ID"]);
  (function() {
    var cs = document.createElement("script");
    cs.type = "text/javascript";
    cs.async = true;
    cs.src = ("https:" == document.location.protocol ? "https://" : "http://") + "lib.verbox.ru/support.js";
    var s = document.getElementsByTagName("script")[0];
    s.parentNode.insertBefore(cs, s);
  })();
</script>

У Бітрікс додавайте через Налаштування → Налаштування продукту → JS-фрагменти (документація по JS-фрагментах на dev.1c-bitrix.ru) або у файл шаблону сайту /local/templates/{template_name}/footer.php. Переконайтеся, що скрипт завантажується асинхронно і перед закриваючим .

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

Verbox приймає дані через масив __cs до завантаження віджета:

<?php if ($USER->IsAuthorized()): $userId = $USER->GetID(); $userEmail = $USER->GetEmail(); $userName = $USER->GetFullName(); $userPhone = getUserPhone($userId); ?>
<script>
    var __cs = __cs || [];
    __cs.push(["setCsUserEmail", <?= json_encode($userEmail) ?>]);
    __cs.push(["setCsUserName", <?= json_encode($userName) ?>]);
    __cs.push(["setCsUserPhone", <?= json_encode($userPhone) ?>]);
    // Довільні поля через setCustomData (якщо підтримується тарифом)
    __cs.push(["setCustomData", {
        "user_id": <?= $userId ?>,
        "orders": <?= getUserOrdersCount($userId) ?>,
    }]);
</script>
<?php endif; ?>

Порядок важливий: дані потрібно пушити в __cs до завантаження support.js, інакше вони не будуть передані при ініціалізації віджета. У 90% випадків це головна причина, чому оператор бачить «Гість».

Email-сповіщення та офлайн-форма

Verbox за замовчуванням надсилає email-сповіщення при пропущеному зверненні. Для інтернет-магазину на Бітрікс актуально налаштувати адреси отримувачів сповіщень в адміністративній панелі Verbox: Аккаунт → Сповіщення. Вкажіть email менеджерів або загальну скриньку відділу продажів.

Коли оператори недоступні, Verbox показує офлайн-форму?

Дані з неї можна отримувати через API Verbox або через email-сповіщення. Для автоматичного запису в Бітрікс — використовуйте Email-пайплайн: налаштуйте пересилання офлайн-сповіщень на адресу, яку Бітрікс24 моніторить як поштовий канал CRM.

Альтернатива — якщо у Verbox є webhook на вашому тарифі:

// /local/api/verbox-offline.php
$payload = json_decode(file_get_contents('php://input'), true);
$name = $payload['name'] ?? '';
$email = $payload['email'] ?? '';
$phone = $payload['phone'] ?? '';
$message = $payload['message'] ?? '';

if ($email || $phone) {
    createBitrix24Lead([
        'TITLE' => 'Verbox офлайн: ' . ($name ?: $email),
        'NAME' => $name,
        'EMAIL' => $email,
        'PHONE' => $phone,
        'COMMENTS' => $message,
        'SOURCE_DESCRIPTION' => 'Verbox офлайн-форма',
    ]);
}

http_response_code(200);
echo 'ok';

Обмеження показу та зовнішній вигляд віджета

Якщо чат потрібен тільки в певних розділах (наприклад, тільки в каталозі та кошику, але не на інформаційних сторінках):

<?php
$showWidget = false;
$showPaths = ['/catalog/', '/basket/', '/order/'];
foreach ($showPaths as $path) {
    if (strpos($_SERVER['REQUEST_URI'], $path) === 0) {
        $showWidget = true;
        break;
    }
}
if ($showWidget): ?>
<!-- код Verbox тут -->
<?php endif; ?>

Verbox дозволяє міняти колір кнопки, текст вітання, аватар оператора через адміністративну панель. Позиція кнопки (справа/зліва, відступ від краю) налаштовується через CSS-змінні або через параметри в __cs:

__cs.push(["setButtonSide", "right"]);
__cs.push(["setButtonPosition", "bottom"]);

Якщо віджет конфліктує з іншими плаваючими елементами (форма зворотного дзвінка, кнопка «вгору»), поправте z-index через CSS або змініть позицію одного з віджетів через параметри.

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

Часта проблема — дані користувача передаються після завантаження віджета. Всі push-виклики __cs повинні виконуватися до завантаження support.js. Інакше дані не будуть підставлені. Не налаштовані email-сповіщення про пропущені чати — оператори дізнаються про запити із запізненням, губляться замовлення. Перевірте адреси отримувачів. Віджет відображається в адмінці Бітрікс — додайте перевірку на CSite::IsAdminSection() або аналогічно обмежте по сторінках.

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

Як Verbox покращує конверсію в чаті?

Після інтеграції час відповіді скорочується в 2 рази — оператор бачить профіль клієнта одразу. Без передачі даних доводиться витрачати 30–60 секунд на уточнення контактів. Передача довільних полів (кількість замовлень, історія покупок) дозволяє задавати індивідуальний сценарій. Це дає зростання конверсії на 15–20% порівняно зі стандартним віджетом без даних. Середній чек при цьому збільшується на 15–20%.

Чому варто довірити інтеграцію нам?

Ми займаємося інтеграціями Бітрікс понад 6 років, реалізували понад 50 проєктів. Маємо сертифікат 1С-Бітрікс. Гарантуємо дотримання строків та якість роботи. Кожна інтеграція супроводжується документацією та навчанням операторів.

Як ми налаштовуємо інтеграцію за 1–2 дні?

1. Надішліть заявку — ми оцінимо проєкт.
2. Встановіть віджет за нашим керівництвом.
3. Ми налаштовуємо передачу даних та CRM.

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