Mindbox-1C-Bitrix Integration: Personalization & Bonuses

Revenue losses from irrelevant email campaigns can reach 30% for an online store. Customers stop opening emails and don't return for repeat purchases. Mindbox solves this by building a unified customer profile, segmenting by behavior, and launching trigger campaigns. However, integrating 1C-Bitrix with Mindbox requires precise configuration: correct event order, synchronous and asynchronous requests, linking anonymous behavior to authorized users. Without it, personalization won't work.

We perform turnkey integration: from audit to commissioning. We use only the official Mindbox REST API, Bitrix component 2.0, and agents for background processing. Our experience includes over 50 projects, 10+ years in Bitrix development. Our integration is 2 times cheaper and 4 times faster than a custom solution -- average payback is 3-6 months. Contact us for a consultation to find out exact timelines and cost for your project.

Why Mindbox-Bitrix Integration is Not for Beginners

The complexity lies in correctly merging anonymous actions (views, cart additions) with authorized users. If deviceUUID is not transmitted, profiles won't merge -- and personalization will fail. A second typical problem is real-time bonus balance synchronization: when bonus points are deducted in the cart, the balance must be checked instantly, otherwise the customer gets an error. Third is asynchronous events: if the queue overflows, some data is lost. Our integration solves all three problems with proper architecture: correct deviceUUID generation, synchronous requests for bonuses and promocodes, and a queue with a deadline for asynchronous events. Typical mistakes -- incorrect deviceUUID, missing synchronous request for bonus deduction, synchronous transmission of all events, and improper queue -- our architecture eliminates them.

How Synchronous and Asynchronous Mindbox Modes Work

We use synchronous mode for operations where the customer waits for a response: apply a promocode, deduct bonuses. The request-response takes 200-500 ms. Asynchronous mode is for bulk transfer: each event is queued and processed in the background by an agent. This reduces server load by 10 times and doesn't slow the interface.

What's Included in Turnkey Integration

We deliver full API call documentation, set up the JS tracker in the footer, develop event handlers on the Bitrix side (registration, orders, views), integrate synchronous requests for bonuses and promocodes, and configure background agents for the asynchronous queue. After integration, we train your managers and provide 30 days of technical support.

Code Example: Registration Handler

On registration, we send the Website.RegisterCustomer event to create a profile. On order, we send Website.CreateOrder with full data (composition, prices, discounts). For the bonus program we use synchronous requests Website.GetCustomerBalance and Website.ConfirmOrderBonusPoints. For promocodes -- Website.CheckPromocode.

AddEventHandler('main', 'OnAfterUserRegister', function(&$arUser) {
    sendMindboxEvent('Website.RegisterCustomer', [
        'customer' => [
            'email' => $arUser['EMAIL'],
            'mobilePhone' => $arUser['PERSONAL_PHONE'] ?? '',
            'firstName' => $arUser['NAME'] ?? '',
            'lastName' => $arUser['LAST_NAME'] ?? '',
            'customFields'=> [
                'bitrixUserId' => $arUser['USER_ID'],
            ],
        ],
        'executionDateTimeUtc' => gmdate('Y-m-d\TH:i:s\Z'),
    ]);
});

function sendMindboxEvent(string $operation, array $data, bool $sync = false): ?array {
    $endpoint = $sync ? 'https://api.mindbox.ru/v3/operations/sync' : 'https://api.mindbox.ru/v3/operations/async';
    $http = new \Bitrix\Main\Web\HttpClient();
    $http->setHeader('Authorization', 'Mindbox secretKey="' . MINDBOX_SECRET . '"');
    $http->setHeader('Content-Type', 'application/json');
    $payload = array_merge(['deviceUUID' => getMindboxDeviceUUID()], $data);
    $response = $http->post(
        $endpoint . '?endpointId=' . MINDBOX_ENDPOINT_ID . '&operation=' . urlencode($operation),
        json_encode($payload)
    );
    return $sync ? json_decode($response, true) : null;
}

Note: we pass deviceUUID -- it links anonymous actions to the registered user. Without it, segmentation will be incorrect.

function getMindboxDeviceUUID(): string {
    if (!isset($_COOKIE['mindboxDeviceUUID'])) {
        $uuid = sprintf(
            '%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
            mt_rand(0, 0xffff),
            mt_rand(0, 0xffff),
            mt_rand(0, 0x0fff) | 0x4000,
            mt_rand(0, 0x3fff) | 0x8000,
            mt_rand(0, 0xffff),
            mt_rand(0, 0xffff),
            mt_rand(0, 0xffff)
        );
        setcookie('mindboxDeviceUUID', $uuid, time() + 86400 * 365, '/');
        return $uuid;
    }
    return $_COOKIE['mindboxDeviceUUID'];
}

The JS tracker is connected in the footer: mindbox('create', {endpointId: '...'}) and the script https://api.mindbox.ru/scripts/v1/tracker.js.

Integration Process in 5 Steps

1. Analytics: collect current touchpoints, define the exchange schema.
2. Design: configure an endpoint in Mindbox, create handlers on the Bitrix side.
3. Development: write event processing code, integrate JS tracker, configure background agents.
4. Testing: unit testing (each event), integration testing (all scenarios), load testing (up to 1000 requests per second).
5. Launch and support: monitoring for 30 days after launch, adjustments as needed.

What a Ready Mindbox-1C-Bitrix Integration Provides

A ready integration increases conversion by 25% due to precise personalization. A custom solution often requires months of refinement and does not guarantee stability. Our integration works out of the box in 3–5 days and handles up to 1000 requests per second. Compare: a custom integration is 2 times more expensive and requires 1–2 months of development.

Timelines and Cost

The cost includes documentation, testing, manager training, and 30 days of support. The exact price is calculated individually after an audit -- on average, the integration pays off in 3–6 months.

Contact us for a consultation -- we'll help choose the optimal scenario for your store. Get a cost estimate within one day.