Verbox Integration with 1C-Bitrix: Chat, Leads, and CRM

Often after installing Verbox, the widget fails to transmit client data—the operator sees only "Guest," and offline chats get lost. For instance, an online store with 10,000 items lost 30% of inquiries because notifications weren't delivered. After integration, chat conversion rose by 15%, and response time halved from 5 minutes to 2.5. Average operational cost savings reach 40%, and ROI occurs within 2–3 months. We solve such tasks in 1–2 days. Integration with 1C-Bitrix requires understanding of infoblocks and caching. This article provides technical details: proper widget installation, user profile transmission, offline form configuration, and CRM setup.

How to install the widget without breaking the template?

Insert the widget code into the Bitrix template:

<!-- Before </body> in site template -->
<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>

In Bitrix, add it via Settings → Product Settings → JS Fragments (see documentation on dev.1c-bitrix.ru) or directly in the site template file /local/templates/{template_name}/footer.php. Ensure the script loads asynchronously before closing .

Transferring authorized user data

Verbox receives data through the __cs array before the widget loads:

<?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) ?>]);
    // Custom fields via setCustomData (if supported by plan)
    __cs.push(["setCustomData", {
        "user_id": <?= $userId ?>,
        "orders": <?= getUserOrdersCount($userId) ?>,
    }]);
</script>
<?php endif; ?>

Order matters: push data to __cs before loading support.js, otherwise it won't be passed during widget initialization. In 90% of cases, this is why the operator sees "Guest."

Email notifications and offline form

Verbox sends email notifications for missed inquiries by default. For a Bitrix online store, configure notification recipients in the Verbox admin panel: Account → Notifications. Enter managers' emails or a shared sales department inbox.

When operators are unavailable, Verbox shows an offline form.

Data from the form can be retrieved via the Verbox API or email notification. To automatically record it in Bitrix, use an Email pipeline: forward offline notifications to an address that Bitrix24 monitors as a CRM email channel.

Alternatively, if your Verbox plan supports webhooks:

// /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 offline: ' . ($name ?: $email),
        'NAME' => $name,
        'EMAIL' => $email,
        'PHONE' => $phone,
        'COMMENTS' => $message,
        'SOURCE_DESCRIPTION' => 'Verbox offline form',
    ]);
}

http_response_code(200);
echo 'ok';

Widget display restrictions and appearance

If the chat is only needed on certain pages (e.g., catalog and cart, not info pages):

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

Verbox allows changing button color, greeting text, and operator avatar via the admin panel. Button position (right/left, margin from edge) is set via CSS variables or __cs parameters:

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

If the widget conflicts with other floating elements (callback form, "back to top" button), adjust z-index via CSS or change the position of one widget via parameters.

Common integration mistakes

A frequent issue is transmitting user data after the widget has loaded. All __cs push calls must execute before support.js loads. Otherwise, the data won't be applied. Email notifications for missed chats not configured—operators learn about inquiries late, losing orders. Check recipient addresses. Widget displays in the Bitrix admin panel—add a check for CSite::IsAdminSection() or similarly restrict by pages.

What's included in the work

How Verbox improves chat conversion?

After integration, response time is cut in half—the operator sees the client profile immediately. Without data transfer, 30–60 seconds are wasted clarifying contacts. Sending custom fields (order count, purchase history) enables tailored scenarios. This yields a 15–20% conversion lift over a standard widget without data. The average order value also increases by 15–20%.

Why trust us with integration?

We have over 5 years of experience in Bitrix integrations and have completed numerous projects. We hold a 1C-Bitrix certification. We guarantee deadlines and quality. Every integration comes with documentation and operator training.

How we set up integration in 1–2 days?

1. Submit a request—we'll assess your project.
2. Install the widget using our guide.
3. We configure data transfer and CRM.

Contact us for a consultation and a precise project estimate. Order Verbox integration with Bitrix—and your clients will get fast support.