Інтеграція Mindbox з 1С-Бітрікс: персоналізація, бонуси, промокоди

Інтеграція Mindbox з 1С-Бітрікс: персоналізація, бонуси, промокоди

Втрати інтернет-магазину через нерелевантні розсилки сягають 30% виручки. Клієнти перестають відкривати листи, не повертаються за повторними покупками. Mindbox вирішує проблему — будує єдиний профіль клієнта, сегментує за поведінкою та запускає тригерні кампанії. Але інтеграція 1С-Бітрікс з Mindbox потребує точного налаштування: правильний порядок подій, синхронні та асинхронні запити, прив'язка анонімної поведінки до авторизованих користувачів. Без цього персоналізація не спрацює.

Ми виконуємо інтеграцію під ключ: від аудиту до введення в експлуатацію. Використовуємо лише офіційний REST API Mindbox, компонент 2.0 Бітрікс та агенти для фонової обробки. Наш досвід — понад 50 проектів, 10+ років у Бітрікс-розробці. Наша інтеграція краща за саморобну в 2 рази за вартістю та в 4 рази за термінами — середня окупність 3-6 місяців. Замовте консультацію, щоб дізнатися точні терміни та вартість для вашого проекту.

Чому інтеграція Mindbox з Бітрікс — задача не для новачка?

Складність — у правильному склеюванні анонімних дій (перегляди, додавання в кошик) з авторизованими користувачами. Якщо не передати deviceUUID, профілі не об'єднаються — і персоналізація не вийде. Друга типова проблема — синхронізація бонусного балансу в реальному часі: при списанні бонусів у кошику потрібно миттєво перевіряти баланс, інакше клієнт отримає помилку. Третя — асинхронні події: якщо черга переповнюється, частина даних втрачається. Наша інтеграція вирішує всі три проблеми за рахунок правильної архітектури: правильна генерація deviceUUID, синхронні запити для бонусів і промокодів, черга з дедлайном для асинхронних подій. Типові помилки — неправильний deviceUUID, відсутність синхронного запиту при списанні бонусів, синхронна передача всіх подій і неправильна черга — наша архітектура виключає їх.

Як працюють синхронний та асинхронний режими Mindbox?

Синхронний режим використовуємо для операцій, де клієнт чекає відповіді: застосувати промокод, списати бонуси. Запит-відповідь виконується за 200-500 мс. Асинхронний — для масової передачі: кожна подія ставиться в чергу та обробляється фоново агентом. Це знижує навантаження на сервер у 10 разів і не гальмує інтерфейс.

Що входить в інтеграцію під ключ?

Ми передаємо повну документацію по API-викликах, налаштовуємо JS-трекер у footer, розробляємо обробники подій на стороні Бітрікс (реєстрація, замовлення, перегляди), інтегруємо синхронні запити для бонусів і промокодів, налаштовуємо фонові агенти для асинхронної черги. Після інтеграції проводимо навчання для ваших менеджерів та надаємо 30 днів технічної підтримки.

Приклад коду: обробник реєстрації

При реєстрації відправляємо подію Website.RegisterCustomer для створення профілю. При замовленні — Website.CreateOrder з повними даними (склад, ціни, знижки). Для бонусної програми використовуємо синхронні запити Website.GetCustomerBalance та Website.ConfirmOrderBonusPoints. Для промокодів — 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;
}

Зверніть увагу: передаємо deviceUUID — він пов'язує анонімні дії з зареєстрованим користувачем. Без цього сегментація буде некоректною.

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'];
}

JS-трекер підключається в footer: mindbox('create', {endpointId: '...'}) та скрипт https://api.mindbox.ru/scripts/v1/tracker.js.

Процес інтеграції за 5 етапів

1. Аналітика: збираємо поточні точки дотику, визначаємо схему обміну.
2. Проектування: налаштовуємо endpoint у Mindbox, створюємо обробники на стороні Бітрікс.
3. Розробка: пишемо код обробки подій, інтегруємо JS-трекер, налаштовуємо фонові агенти.
4. Тестування: модульне (кожна подія), інтеграційне (всі сценарії), навантажувальне (до 1000 запитів на секунду).
5. Запуск та підтримка: моніторинг 30 днів після введення, правки за необхідності.

Що дає готова інтеграція Mindbox з 1С-Бітрікс?

Готова інтеграція на 25% збільшує конверсію за рахунок точної персоналізації. Саморобне рішення часто потребує місяців доопрацювань і не гарантує стабільності. Наша інтеграція працює з коробки за 3–5 днів і обробляє до 1000 запитів на секунду. Порівняйте: саморобна інтеграція обходиться в 2 рази дорожче та потребує 1–2 місяців розробки.

Терміни та вартість

У вартість входить документація, тестування, навчання менеджерів та 30 днів підтримки. Точну вартість розраховуємо індивідуально після аудиту — в середньому інтеграція окупається за 3–6 місяців.

Залиште заявку на консультацію — ми допоможемо вибрати оптимальний сценарій для вашого магазину. Отримайте розрахунок вартості протягом одного дня.