PHPackages                             coolstudio/module-chatwoot - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. coolstudio/module-chatwoot

ActiveMagento2-module[Utility &amp; Helpers](/categories/utility)

coolstudio/module-chatwoot
==========================

Chatwoot integration for Magento

1.0.1(1y ago)2256OSL-3.0PHPPHP ~7.3.0||~7.4.0||~8.1.0||~8.2.0||~8.3.0

Since Feb 25Pushed 1y ago2 watchersCompare

[ Source](https://github.com/cool-studio/magento2-module-chatwoot)[ Packagist](https://packagist.org/packages/coolstudio/module-chatwoot)[ Docs](https://github.com/coolstudio/magento2-module-chatwoot)[ RSS](/packages/coolstudio-module-chatwoot/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Chatwoot for Magento 2
======================

[](#chatwoot-for-magento-2)

[![Chatwoot for Magento 2](https://camo.githubusercontent.com/360e2de1fd9c704bed173bb02c7cd39ec1713f893d985460f9493be3e29b4e0f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342e782d6f72616e67652e737667)](https://camo.githubusercontent.com/360e2de1fd9c704bed173bb02c7cd39ec1713f893d985460f9493be3e29b4e0f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342e782d6f72616e67652e737667) [![License](https://camo.githubusercontent.com/4a6ba36223f8e23fb97e78b41a7b99d6cccd648322da59101a4dec9eb0f9868d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4f534c2d2d332e302d626c75652e737667)](https://camo.githubusercontent.com/4a6ba36223f8e23fb97e78b41a7b99d6cccd648322da59101a4dec9eb0f9868d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4f534c2d2d332e302d626c75652e737667)

This module integrates the Chatwoot customer messaging platform with Magento 2, allowing you to provide seamless customer support directly on your store.

Features
--------

[](#features)

- ✅ Easy integration with Chatwoot
- ✅ Secure user identification with HMAC validation
- ✅ Customizable widget position (left/right)
- ✅ Multiple widget display types (standard/expanded)
- ✅ Custom launcher title support
- ✅ Dark mode support with auto/light options
- ✅ Real-time page tracking for better context
- ✅ Automatic customer information sync when logged in
- ✅ Full configuration through Magento admin

Installation
------------

[](#installation)

### Via Composer (recommended)

[](#via-composer-recommended)

```
composer require coolstudio/module-chatwoot
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
```

### Manual Installation

[](#manual-installation)

1. Create the following directory structure in your Magento installation:

    ```
    app/code/CoolStudio/Chatwoot

    ```
2. Download the module files and place them in this directory
3. Enable the module and update the database:

    ```
    bin/magento module:enable CoolStudio_Chatwoot
    bin/magento setup:upgrade
    bin/magento setup:di:compile
    bin/magento setup:static-content:deploy -f
    bin/magento cache:flush
    ```

Configuration
-------------

[](#configuration)

1. Log in to your Magento Admin Panel
2. Navigate to **Stores** &gt; **Configuration** &gt; **Services** &gt; **Chatwoot**
3. Configure the following settings:

SettingDescriptionEnable ChatwootEnables/disables the moduleWebsite TokenYour Chatwoot website token (found in Chatwoot dashboard)Base URLYour Chatwoot instance URL (e.g., )HMAC Secret KeySecret key for secure user identification (optional)Widget PositionPosition of the widget (left/right)Widget TypeStandard or Expanded bubble displayLauncher TitleCustom text for the chat widget when closedDark ModeChoose between auto (system preference) or light modeSetting up HMAC Identity Validation
-----------------------------------

[](#setting-up-hmac-identity-validation)

For enhanced security, you can enable HMAC validation:

1. In your Chatwoot dashboard, go to **Settings** &gt; **Inboxes** &gt; **Select your inbox** &gt; **Widget Settings**
2. Enable "Identity Validation" to get your secret key
3. Copy this key to the Magento admin configuration

HMAC validation ensures that user identities are authentic and cannot be spoofed.

Features in Detail
------------------

[](#features-in-detail)

### Dark Mode

[](#dark-mode)

The widget can adapt to your users' preferences:

- `auto`: Automatically matches the user's system theme
- `light`: Forces light mode regardless of system settings

### Page Tracking

[](#page-tracking)

Support agents can see which page a customer is currently viewing, helping provide more contextual assistance. This works for both:

- Logged-in customers
- Guest visitors

Support
-------

[](#support)

For issues, feature requests, or questions:

- Open an issue on [GitHub](https://github.com/coolstudio/magento2-chatwoot)

License
-------

[](#license)

This module is licensed under the Open Software License v. 3.0 (OSL-3.0).

---

© 2025 CoolStudio. All rights reserved.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance41

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

2

Last Release

491d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ec4b2f97a2fd8f4a742e995c5de3c7ea7b8e04cbeef35d205264b7f04a3a4bdf?d=identicon)[J4Wx](/maintainers/J4Wx)

![](https://www.gravatar.com/avatar/ea17f08869a038fa90775b74b928d718c2d0f60493a3eeca48e45fd2266b536e?d=identicon)[CoolStudio](/maintainers/CoolStudio)

---

Top Contributors

[![J4Wx](https://avatars.githubusercontent.com/u/3397311?v=4)](https://github.com/J4Wx "J4Wx (11 commits)")

---

Tags

magentoextensionmodulewidgetchatsupportmagento2magento2 modulemagento 2 modulemagento 2 extensionmagento2 extensionLive Chatcustomer-supportchatwoot

### Embed Badge

![Health badge](/badges/coolstudio-module-chatwoot/health.svg)

```
[![Health](https://phpackages.com/badges/coolstudio-module-chatwoot/health.svg)](https://phpackages.com/packages/coolstudio-module-chatwoot)
```

###  Alternatives

[olegkoval/magento2-regenerate-url-rewrites

Add into Magento 2 a CLI feature which allow to regenerate a Url Rewrites of products and categories

4483.9M2](/packages/olegkoval-magento2-regenerate-url-rewrites)[magepsycho/magento2-storepricing

Magento 2 Store View Pricing

2624.4k](/packages/magepsycho-magento2-storepricing)[magepsycho/magento2-discountlimit

Magento 2 Discount Amount Limiter

1112.3k](/packages/magepsycho-magento2-discountlimit)[werfu/magento2-url-key-mask

Enable Product and Category URL\_key generation using masks

135.7k](/packages/werfu-magento2-url-key-mask)[magepsycho/magento2-custom-shipping

Magento 2 Custom Shipping

708.4k](/packages/magepsycho-magento2-custom-shipping)[magepsycho/magento2-easy-template-path-hints

Easy Template Path Hints for Magento 2

441.0k](/packages/magepsycho-magento2-easy-template-path-hints)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
