Klaviyo Integration

The Klaviyo integration connects your WizShop storefront to Klaviyo, so every shopper action (browsing, adding to cart, checking out, and placing an order) flows into Klaviyo in real time, enabling you to run email and SMS flows such as cart abandonment, post-purchase, and win-back.

Table of Contents

A. How the Integration Works

WizShop sends shopper events to Klaviyo in real time using the Klaviyo Track and Identify APIs. Each time a buyer performs an action on your storefront (such as logging in, viewing a product, adding to cart, starting checkout, or placing an order) that event is forwarded to Klaviyo and appears in the buyer's Klaviyo profile.

Buyer profiles are identified at login and signup using email, phone, and name. Events performed before login (as a guest) are merged into the identified profile once the buyer logs in.

Each WizShop tenant uses their own Klaviyo API key. The integration is multi-tenant safe, with per-tenant retry handling, dead-letter queue, and rate limiting built in.

Once events are flowing into Klaviyo, your marketing team can use them to build flows and campaigns directly inside Klaviyo. Setting up flows and campaigns is handled on the Klaviyo side and is outside the scope of this article.

B. How to Connect Klaviyo

The Klaviyo integration is enabled by the WizCommerce Implementation team. It is not self-serve, your team cannot enable it from the WizShop admin directly.

To get started:

1. Purchase a Klaviyo license from klaviyo.com.
2. Retrieve your Klaviyo Private API Key and Public Site Key from your Klaviyo account.
3. Share both keys with your WizCommerce Implementation team.
4. The Implementation team configures the keys in your tenant settings and enables the integration.
5. Once enabled, the Klaviyo JS snippet loads automatically on your storefront using your public key, and events begin flowing to Klaviyo.

To verify the integration is active, log in to your WizCommerce admin and open WizTracker settings, you will see your Klaviyo ID configured there.

C. What Events You Will See in Klaviyo

Once the integration is enabled, the following events flow from WizShop into your Klaviyo account. These appear as metrics in your Klaviyo dashboard and can be used to trigger flows and campaigns.

These events carry full property payloads (like product details, order values, buyer identifiers) so your marketing team can use them for segmentation and personalisation inside Klaviyo.

D. Troubleshooting and Common Issues

» No events are landing in Klaviyo after the integration was set up

Confirm with your WizCommerce Implementation team that the Klaviyo feature flag is enabled for your tenant and that the KlaviyoEventConsumer is running. Your Implementation team can check the consumer logs for any retry or dead-letter activity.

» A guest buyer's events are not being attributed to them after they log in

Guest events are merged into the identified buyer profile when klaviyo.identify() is called at login. If attribution is not happening, confirm with your Implementation team that the identify call is firing correctly at login.

» Klaviyo is not showing any historical buyer data

The integration only forwards events from the go-live date onwards. Historical events and past orders are not backfilled into Klaviyo, this is not in scope for v1.

FAQs

1. Can we self-serve enable the Klaviyo integration from the WizShop admin?

A. No, the integration requires your WizCommerce Implementation team to configure your Klaviyo API keys in tenant settings and enable the feature flag. Contact your CSM to get started.

2. Can one Klaviyo account be used across multiple WizShop storefronts?

A. Yes, you can integrate Klaviyo across all WizShop storefronts you have under your account. Each storefront uses the same Klaviyo API key configured by the Implementation team.

3. Will Klaviyo unsubscribes flow back to WizShop?

A. No. In the current version, Klaviyo unsubscribes do not flow back to WizShop. If you manage marketing communications from both platforms, you will need to reconcile unsubscribe lists manually.

4. Is historical order or buyer data backfilled into Klaviyo when the integration is enabled?

A. No, only events from the date the integration is enabled onwards flow into Klaviyo. Past orders and buyer activity are not backfilled.

5. Who is responsible for TCPA / SMS compliance for flows built in Klaviyo?

A. SMS compliance (TCPA, DND) is the tenant's responsibility. WizShop forwards events to Klaviyo, it does not gate or audit the flows you build or the messages you send on the Klaviyo side.