> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.crisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to connect Klaviyo with Crisp

*Learn how to connect Klaviyo to Crisp so support and marketing data can stay connected from the Inbox.*

The **Klaviyo** plugin synchronizes Crisp contacts to Klaviyo, pushes Crisp events to Klaviyo profiles, displays Klaviyo profile details in Crisp, and can bring Klaviyo email or SMS replies into the Crisp Inbox.

__Use this guide to jump to the right section:__
* [Connect Klaviyo to Crisp](#1-connect-klaviyo-to-crisp) → install and authorize the plugin
* [Understand how Klaviyo works with Crisp](#1-understand-how-klaviyo-works-with-crisp) → contact sync, events, widget data, email, and SMS
* [Troubleshooting](#1-troubleshooting) → common SMS sync issue

---

# ${color}[#0080dd](Connect Klaviyo to Crisp)

1. Start the [**Klaviyo plugin installation**](https://app.crisp.chat/initiate/plugin/0264638f-5f92-473c-b295-87453de0e014/) and select the Crisp workspace where the plugin should be installed.
2. You will be redirected to Klaviyo.
3. Select the Klaviyo workspace to connect.
4. Click **Allow** to grant Crisp access to the listed resources.
5. Return to Crisp and review the plugin settings.

You can optionally restrict whether Crisp operators with **Member** permissions can add or remove customers from Klaviyo lists.

---

# ${color}[#0080dd](Understand how Klaviyo works with Crisp)

#### ${color}[#445055](Contact synchronization)

When automatic synchronization is enabled, the Klaviyo plugin syncs Crisp contacts to Klaviyo whenever a contact is created or updated in Crisp. If automatic synchronization is disabled, operators can still manually sync a contact from the Klaviyo widget in Crisp.

![Manually sync a Crisp contact to Klaviyo](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/wdiget1_108o0oa.png =1000xauto)

__Contact properties synced from Crisp to Klaviyo can include:__
* **First and last name** → middle names are treated as last names
* **Phone number**
* **Email address**
* **Contact address and location**
* **Job title**
* **Contact custom data** → when enabled from the Klaviyo plugin settings in Crisp

#### ${color}[#445055](Contact events)

Events that happen in Crisp can be added to the Klaviyo profile. These events help marketing and support teams understand how a customer interacted with your team.

__All events include these common properties:__
* `website_id` → Crisp workspace ID
* `session_id` → conversation ID where the event occurred
* `conversation_url` → direct link to the Crisp conversation
* `conversation_segments` → segments associated with the conversation
* `conversation_data` → custom data associated with the conversation
* `contact_address` → contact address
* `contact_ip_address` → contact IP address
* `contact_device_timezone` → contact device timezone offset in UTC
* `contact_device_locales` → contact device locales, such as `en_US` or `pt`
* `contact_device_user_agent` → contact device user agent
* `contact_device_os_name` → contact device operating system name
* `contact_device_os_version` → contact device operating system version
* `contact_device_browser_name` → contact device browser name
* `contact_device_browser_version` → contact device browser version
* `contact_device_city` → contact device city
* `contact_device_country` → contact device country
* `contact_device_region` → contact device region

__Supported Crisp events include:__
* **Conversation Opened** → triggered when a conversation changes state to **Unresolved** or **Pending**
* **Conversation Closed** → triggered when a conversation changes from **Unresolved** or **Pending** to **Resolved**
* **Conversation Subject Updated** → triggered when an email conversation subject is set or changed; includes `conversation_subject`
* **Conversation Rating** → triggered when a user leaves a rating; includes `rating` and `rating_comment`

#### ${color}[#445055](Widget data)

The Klaviyo widget displays the customer's Klaviyo profile directly in Crisp. It can show profile details such as lists, segments, coupons, and events. Operators can also add or remove customers from lists when allowed by the plugin settings.

![Klaviyo profile data in Crisp](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/wdiget2_izmxz.png =1000xauto)

|| By default, Crisp can restrict list add/remove actions to workspace owners to reduce accidental changes by members.

![Add a customer to a Klaviyo list from Crisp](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/modal1_164ifd5.png =1000xauto)

#### ${color}[#445055](Email conversations)

If you send an email campaign from Klaviyo, you can receive replies in Crisp by using your Crisp email address as the campaign **reply-to** address.

1. In Crisp, find your email address from **Settings → Workspace Settings → Setup & Integrations → Email**.
2. In Klaviyo, set that Crisp email address as the campaign **reply-to** address.
3. Send the campaign from Klaviyo.

All replies are delivered to your Crisp Inbox.

| To use your own email domain, follow [How can I setup a custom email domain?](https://help.crisp.chat/en/article/how-can-i-setup-a-custom-email-domain-ndklh7/).

In the example below, `@crisp.yourcompany.com` is a custom email domain. You can also append a segment to the reply-to mailbox. For example, `reply-to+june2024@crisp.yourcompany.com` adds the `june2024` segment to the Crisp conversation.

![Klaviyo email campaign reply-to example](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/email-campaign_1fxf4uq.png =1000xauto)

#### ${color}[#445055](SMS conversations)

Klaviyo SMS conversations can also be handled from Crisp. When a customer sends an SMS to your Klaviyo number, Crisp receives the message as a conversation. Operators can reply from either Crisp or Klaviyo, and the messages appear in the Crisp conversation.

||| You cannot start Klaviyo SMS conversations from Crisp. A customer must send at least one SMS first before your team can reply from Crisp.

![Klaviyo SMS conversation in Crisp](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/sms-conversation_1yjfsc2.png =1000xauto)

---

# ${color}[#0080dd](Troubleshooting)

###### ${color}[#F08820](I see SMS messages in Klaviyo but not in Crisp)

Open **Plugins → Klaviyo → Settings** in Crisp and make sure the option to receive Klaviyo SMS messages in Crisp is enabled. If it is already enabled, reconnect the plugin and send a new SMS test message.