Articles on: Integrations

How to install Crisp helpdesk and live chat on Adobe Commerce?

Installing Crisp on your Adobe Commerce online store (previously known as Magento) requires a couple steps. The integration will enable the chat widget on your online store as well as the creation of an helpdesk for your e-commerce activity and will be very useful to synchronize customers' data for each conversation, no matter the channel.

Note that you can download our Crisp extension for Adobe Commerce on Adobe Marketplace, available here:

➡️ To know more about Crisp chat widget click here
➡️ To know more about Crisp chatbot software click here

How to install Crisp on Adobe Commerce (Magento 2) using Composer?

Ensure composer is installed in your Magento 2 root directory, otherwise install composer.
Remaining in your Adobe Commerce root directory, enter the following commands to install the extension:

If your Magento 2 store is using a Hyvä Theme use:
# 1. (Hyvä Themes) Update your compose.json file
composer require hyva-themes/magento2-crisp-chat-chatbox-and-helpdesk:1.0.0

Otherwise, use:
# 1. (Luma Themes) Update your compose.json file
composer require crisp-chat/chatbox-and-helpdesk:1.0.5

# 2. Enable the Crisp module:
bin/magento module:enable Crisp_Crisp

# 3. Register the extension and update the database schema & data
bin/magento setup:upgrade

# 4. Generate the new code
bin/magento setup:di:compile

# 5. Deploy static files
bin/magento setup:static-content:deploy

# 6. Clean the cache
bin/magento cache:clean

Next, you will need your Crisp website_id in order to configure your chat widget on your online store. You can find your websiteID in Crisp > Settings > Website settings > (select website) > Setup Instructions. Also, we have an article that explains how to find the websiteID: How to find WebsiteID?

In your Adobe online store, go to Stores > Configuration > Crisp > Settings > then paste your website_id and save your settings. Once saved, you will now be able to see the Crisp Live Chat on your e-commerce store.

In order to create a true helpdesk for e-commerce and see your customers' carts and orders, you will need to activate the integration. In your Magento (Adobe Commerce) admin area go to: System > Integrations and Activate the Crisp integration.

Approve the permissions required to view your customers' order data.
A popup window will open for Crisp, login and install the Adobe Commerce plugin on your Crisp Workspace.
Magento 2 is connected to Crisp!

How does the Adobe Commerce <> Crisp integration work?

When your customer contacts you through the chatbox, you will have access to view what your customer currently has in their basket. If your customer has an account on your website and is logged in, you will also have the option to see any past orders.

#How to download Adobe Commerce Extension?

You can access the extension from Adobe Commerce marketplace, which is available here: and search for "Crisp".


Why am I seeing "Invalid store code" in the plugin widget?

If you see this error, it means your store view code is not the default store code. Therefore you need to define the store code by heading to Plugins > Magento > Settings, where you will see the option to save your store view code.

To find your store view code, you can head to your Magento Admin area > Stores > All Stores and in the third column under Store View you can find your store view code. If this code is different to "default" please save the respective in the plugin settings. Once this is saved, you should be able to see your customer, cart and order data.

Updated on: 05/06/2024

Was this article helpful?

Share your feedback


Thank you!