Klaviyo Connector для OpenCart — події, профілі й підписки з магазину в Klaviyo

Klaviyo Connector для OpenCart — інтеграція магазину на OpenCart 4, 3 або 2.3 з Klaviyo через офіційний REST API. Модуль передає в Klaviyo те, на чому тримаються флоу й сегменти: перегляди товарів, кошик, початок оформлення з посиланням, що повертає кошик, замовлення з повним складом і профіль покупця, а підписує на розсилку лише тих, хто сам поставив галочку. Магазин на WooCommerce — є Klaviyo Connector для WooCommerce.

Чесно про перевірку. Пісочниці Klaviyo не має, тож модуль зроблено за офіційною документацією Klaviyo API (revision 2026-07-15) і перевірено наскрізно на симуляції цього API — формати подій, підписок, каталогу й відповіді з помилками звірено з документацією — на OpenCart 4.1 (PDO), 4.0.2.3, 3.0.5.0 і 2.3.0.2, на nginx з PHP-FPM і на Apache, поряд зі штатним чекаутом і з CatCode One Page Checkout. На бойовому акаунті Klaviyo модуль ще не запускали — перевірте на своєму в 7-денному тріалі Pro. Журнал показує кожен запит і відповідь Klaviyo, і якщо Klaviyo відповість інакше, ніж у документації, виправимо оперативно.

Як це виглядає для покупця

• Нічого зайвого на вітрині. klaviyo.js вантажиться асинхронно, форми Klaviyo (спливаючі, вбудовані) з’являються так, як ви їх налаштували в Klaviyo. Сторінка ніколи не чекає на Klaviyo: усі запити йдуть після того, як сторінку віддано.
• Згода на розсилку — окремою галочкою, не відміченою. Де в чекауті вже є штатна галочка розсилки OpenCart (OpenCart 4, One Page), саме вона і є згодою. Де її нема (гість в OpenCart 3 і 2.3) — наша галочка під полем e-mail, текстом мовою вітрини; текст можна змінити для кожної мови.
• Кинутий кошик повертається. У листі Klaviyo покупець натискає посилання — і кошик з тими самими товарами й опціями відкривається навіть на іншому пристрої, 30 днів.
• Cookie — за правилами. Режим «чекати згоди на cookie» вмикає klaviyo.js лише після згоди в Cookiebot, CookieYes або вашому банері.

Що отримує магазин

• «Зберегти й перевірити» звіряє ключ з акаунтом Klaviyo, підставляє публічний ключ для klaviyo.js і завантажує всі ваші списки. Помилку Klaviyo модуль показує зрозумілим текстом з кодом відповіді.
• Приватний ключ зберігається в базі зашифрованим (AES-256 з HMAC), у форму більше не повертається і не потрапляє в журнал.
• Placed Order і Ordered Product — з тієї самої історії замовлення, що й у самого OpenCart: штатний чекаут, One Page, колбеки оплат і зміна статусу з адмінки дають подію один раз. Сума — у валюті замовлення, позиції з фото, посиланням, категоріями, брендом і опціями, окремо знижка з кодом купона, податок, доставка, адреси.
• Started Checkout — з посиланням на кошик і складом кошика, одна подія на покупця і вміст кошика за день, щойно відомий e-mail: покупець увійшов або ввів його на чекауті.
• Профіль покупця: ім’я, телефон у форматі E.164 за країною адреси, адреса і мова — у самій події замовлення. Телефон, який Klaviyo не прийме, модуль відкидає, а подію все одно надсилає.

• Черга замість запитів у момент покупки. Подія записується в чергу і йде після відповіді сторінки, фоновим запитом наступної сторінки вітрини або кроном. Ліміт Klaviyo (429) — пауза рівно на скільки просить Klaviyo, збої сервера — повтори з наростанням, відхилений запит лишає відповідь Klaviyo в журналі.
• Ключ без потрібного дозволу (403) не зупиняє все: чекають лише запити цього типу, модуль пише в адмінці, який саме дозвіл потрібен, а решта подій іде далі.
• Копія магазину на іншій адресі (тестовий сайт, переїзд) нічого не надсилає, доки ви не підтвердите, що це робочий магазин.

Як це працює — крок за кроком

1. Ключ. У Klaviyo: Settings → API keys → Create Private API Key (Full або Custom з доступом до Events, Profiles, Lists, Subscriptions, Catalogs і читанням Accounts).
2. Підключення. Розширення → Модулі → Klaviyo Connector → «Підключення»: вставте ключ, «Зберегти й перевірити», оберіть список для підписників.
3. Відстеження і згода. Вкладки «Відстеження» і «Згода»: які події слати, режим cookie, текст галочки для кожної мови.
4. Флоу в Klaviyo. Метрики Started Checkout, Placed Order, Viewed Product з’являються в Klaviyo з першими подіями — на них будуються флоу кинутого кошика, після покупки й повторного перегляду.
5. Pro. Вкладки «Життєвий цикл замовлення», «Каталог» і «Історія»: статуси для подій, синхронізація каталогу, вивантаження минулих замовлень і підписників.

Що під капотом

• Klaviyo REST API, revision 2026-07-15: Create Event, Bulk Subscribe / Unsubscribe, Catalog items, variants і categories, Accounts, Lists. Авторизація заголовком Klaviyo-API-Key.
• Без дублів: кожна подія має стабільний unique_id (префікс установки + номер замовлення), тож повтор запиту чи повторний виклик історії замовлення не створює другої події в Klaviyo.
• Штатні події OpenCart: модуль слухає addHistory в OpenCart 4 і addOrderHistory в 3.x і 2.3, тож бачить замовлення з будь-якого чекауту й будь-якої оплати, що працюють через ядро.
• Сесію OpenCart модуль не пише: стан відвідувача (e-mail, згода, знімок кошика) — у власній таблиці, щоб не перезаписати паралельні запити чекауту.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції.
• Видалення модуля прибирає події, завдання крону й права; таблиці модуля з копією налаштувань і посиланнями відновлення кошика з уже надісланих листів лишаються, тож оновлення й перевстановлення нічого не губить. Щоб прибрати дані повністю, видаліть таблиці oc_cc_klaviyo_*.

Як встановити

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_klaviyo.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_klaviyo-oc3.ocmod.zip, потім Розширення → Модифікації → «Оновити». OpenCart 2.3: залийте вміст папки upload/ з cc_klaviyo-oc23.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу) — Інсталятор 2.3 без налаштованого FTP файлів не копіює.
2. Розширення → Розширення → Модулі → Klaviyo Connector → «Встановити», потім «Редагувати».
3. «Підключення»: приватний ключ Klaviyo, «Зберегти й перевірити», список для підписників, статус «Увімкнено».
4. Для Pro: вставте ліцензійний ключ з листа після оплати або натисніть «Почати 7-денний тріал» на вкладці «Ліцензія».