Інтеграція 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 дні.