Интеграция 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 с Битрикс — и ваши клиенты получат быструю поддержку.