OroCommerce

Connect your OroCommerce store to Kenzi to add a live chat widget to your storefront and automatically sync order data so your support team has full context when helping customers.

What You’ll Need

• A Kenzi account — sign up at kenzi.chat if you don’t have one yet
• OroCommerce 6.0 or later (Community Edition or Enterprise Edition)
• Admin access to your OroCommerce back-office

Install the Bundle

Run these commands from your OroCommerce application root:

composer require kenzi-chat/orocommerce-bundle
php bin/console cache:clear
php bin/console oro:platform:update --force

The bundle registers itself automatically — no additional configuration files to edit.

---

After installation, a new Kenzi Chat section will appear in your OroCommerce system configuration.

Connect to Kenzi

Connecting links your OroCommerce store to your Kenzi workspace so order data and chat messages flow between them.

1. In your OroCommerce back-office, go to System > Configuration.
2. In the left sidebar, expand Integrations and click Kenzi Chat.

3. Click the Connect to Kenzi button.

4. A popup will open. If you’re not already signed in to Kenzi, sign in with Google.

5. Select the workspace you want to connect to. If you only have one workspace, it will be selected automatically.

6. Review the connection details and click Connect.

7. The popup closes and the page reloads. You’ll see a green Connected to Kenzi status showing your workspace and the date you connected.

Once connected, Kenzi automatically begins syncing order data in the background.

Enable the Chat Widget

The chat widget is a small chat window that appears on your storefront so customers can message your support team.

1. On the Kenzi Chat configuration page, check the Enable Chat Widget box.
2. Click Save Settings.

The widget will now appear on your storefront pages. When your team is online in Kenzi, customers can start a live conversation. When no one is online, the widget offers an email option so customers can still reach you.

What Gets Synced

Once connected, Kenzi pulls in order data and stays up to date as new orders come in:

Data	Details
Orders	Order number, status, total, shipping method, and dates
Customers	Customer name, email, and company from the order
Products	Product names, SKUs, quantities, and prices from each order

New and updated orders are sent to Kenzi automatically — there’s nothing you need to do to keep things in sync.

How It Looks in Kenzi

When a customer reaches out through any channel — chat, email, Facebook, or Instagram — Kenzi automatically matches them to their order history using their email address. Your support agents will see a Recent Orders section in the conversation sidebar with:

• The order status shown as a color-coded badge
• The products in the order
• The order total
• A link to open the full order in your OroCommerce back-office

This gives your team instant context so they can help customers faster.

Multi-Website Setup (Enterprise Edition)

If you’re running OroCommerce Enterprise Edition with multiple websites, each website can have its own independent Kenzi connection. This means each storefront can connect to a different Kenzi workspace and have its own chat widget.

To configure Kenzi for a specific website:

1. Go to System > Websites and click the website you want to configure.
2. Click Configuration in the top right.
3. In the left sidebar, expand Kenzi Chat and click Connection.
4. Click Connect to Kenzi and follow the same connection steps as above.

Repeat for each website you want to connect.

Note

On OroCommerce Community Edition, there is only one website, so you can skip this section and use the system-level configuration described above.

Disconnect

If you need to remove the connection between your OroCommerce store and Kenzi:

1. Go to System > Configuration > Integrations > Kenzi Chat.
2. Click the Disconnect button.
3. Confirm when prompted.

The chat widget will stop appearing on your storefront and order data will no longer sync to Kenzi. You can reconnect at any time by clicking Connect to Kenzi again.