Интеграция 1С-Битрикс с Verbox

Интеграция 1С-Битрикс с Verbox

Verbox — онлайн-чат российского производства с акцентом на простоту операторского интерфейса и низкий порог входа. Часто выбирается небольшими интернет-магазинами как альтернатива JivoSite. Интеграция с Битрикс включает стандартный набор: установку виджета, передачу данных пользователя, получение уведомлений об обращениях.

Установка виджета Verbox

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

<!-- Перед </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-фрагменты или в файл шаблона сайта /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, иначе они не будут переданы при инициализации виджета.

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 или измените позицию одного из виджетов через параметры.

Состав работ: установка виджета, передача данных пользователя, настройка офлайн-формы — 1 рабочий день. Интеграция с CRM через Webhook или Email-пайплайн — ещё 1–2 дня.