Tawk.to Chat Integration: setup and help
Quick start
- Upload and install the
mprtawkchatintegrationZIP in Modules > Module Manager. - Click Configure. In Tawk.to Configuration and Fallback Widget, leave Enable Tawk.to Chat set to Yes.
- Copy the two values from your Tawk.to embed URL into Fallback Property ID and Fallback Widget ID.
- Leave Fallback Widget Pages at All Pages, Show on Mobile at Yes, and Fallback Delay (seconds) at
0. Choose whether to enable Pass Customer Data. - Click Save. Test the storefront in a separate visitor browser so the employee traffic exclusion does not hide chat.
- If MPR Cookies Revolution is enabled, allow the
functionalcategory for chat. Scroll, click, touch, press a key, or wait for the 10-second fallback. - Open the chat and send a test message. Check it in Tawk.to, then test Hide chat and the footer Open chat control.
Requires PrestaShop 1.6 or later and PHP 7.1 or later.
Setup manual
Installation and first configuration
On older PrestaShop versions, use the equivalent module installation page. Open this module through Configure whenever you need to return to its settings.
Tawk.to Configuration and Fallback Widget
Read the two IDs from https://embed.tawk.to/PROPERTY_ID/WIDGET_ID. For example, the first part can be 5a1b2c3d9e4f6a7b8c9d and the second 1abc2def3. Paste only the IDs. The setup panel points to Administration > Chat Widget in Tawk.to.
| Setting | Default | What you do |
|---|---|---|
| Enable Tawk.to Chat | Yes | Stop all chat output by turning this off. |
| Fallback Property ID | Empty | Enter the property part of the embed URL. Use 2-128 letters, numbers, dashes, or underscores. |
| Fallback Widget ID | Empty | Enter the widget part using the same accepted characters and length. |
| Pass Customer Data | Yes | Identify logged-in customers by name and email. Guest identity, cart contents, and order data are not passed by this setting. |
| Show on Mobile | Yes | Turn off to suppress chat and footer controls on mobile devices. This version checks the browser user agent in JavaScript. |
| Fallback Delay (seconds) | 0 |
Load on the first interaction, when the visitor asks to open chat, or after the passive timeout. Zero uses 10 seconds. A positive value changes the passive timeout. |
| Fallback Widget Pages | all |
Apply the fallback widget on all, product, category, or checkout pages when no widget rule matches. |
Enter both fallback IDs or leave both empty. A rule can supply the widget without fallback IDs. If no rule matches and the fallback is empty or invalid, no chat is shown. Checkout covers cart, order, order-opc, orderopc, and checkout.
Widget rules
Click Manage widget rules in the Widget rules panel. Create a rule on the Widget Rule screen. Each rule selects a Tawk.to property and widget for a visitor context.
| Setting | Default | What you do |
|---|---|---|
| Name | Empty | Enter an internal name up to 128 characters. |
| Property ID | Copied from the fallback for a new rule | Enter the property to use for matching visitors. |
| Widget ID | Empty | Enter its widget ID. Both IDs must be valid. |
| Languages | No selection | Leave empty for every language, or select the storefront languages that match this rule. |
| Customer Groups | No selection | Leave empty for every visitor. Otherwise a logged-in customer must belong to at least one selected group. Guests do not match a selected group. |
| Page Scope | All Pages | Choose All Pages, Product Pages Only, Category Pages Only, or Checkout Pages Only. |
| Login Status | Logged-in Customers and Guests | Optionally choose Logged-in Customers Only or Guests Only. |
| Priority | 0 |
Higher numbers run first. Equal priorities use the oldest rule ID first. |
| Active | Yes | Turn off to retain a rule without applying it. |
Every condition within a rule must match. The first matching active rule wins. If no rule matches, the configuration fallback and Fallback Widget Pages apply. The mobile, enable, customer data, traffic, and consent controls still apply to a rule-selected widget.
For example, create a higher-priority rule for one language and Logged-in Customers Only. Use the fallback for all remaining visitors. Verify the rule with a matching customer and with a guest who should receive the fallback.
Internal traffic
The Internal traffic section can suppress chat for employees and listed IP addresses. Select one shop before editing. Shared shop settings require a shop administrator. Module overrides require permission to configure this module.
| Setting | Default | What you do |
|---|---|---|
| Exclude employees | Yes on a shop with no saved policy | Use the back-office marker to classify employee browsers as internal. |
| Internal IP addresses and CIDR networks (one per line) | Empty on a shop with no saved policy | Add the addresses or networks that you want treated as internal. |
| Module default | Inherit | Choose Inherit, Always exclude internal traffic, or Never exclude internal traffic for this module. |
| Chat | Inherit | Override the module default for chat. The effective policy is displayed below the field. |
Use Save shared settings for shop-wide changes and Save module overrides for this module. Shared changes affect other participating modules. Overrides do not grant cookie consent. If the page reports that settings are read-only because no safe save lock is available, ask your administrator to resolve that server limitation. An optional Cloudflare synchronization control appears only when its package and permissions are available.
Consent, loading, and storefront controls
The front script loads from displayHeader. The module renders the footer control through displayFooterAfter on PrestaShop 1.7 and later, or displayFooter on 1.6. This version does not use a displayBeforeBodyClosingTag.tpl embed template.
Chat waits for an allowed internal-traffic decision. With MPR Cookies Revolution enabled, it also waits for functional consent. Chat stays blocked while the consent service is unavailable. The passive timer is not an extra delay after interaction. It can load chat without any interaction once traffic and consent allow it. The interaction events are scroll, click, touchstart, keydown, and mousemove.
The module adds the Tawk.to script from your selected IDs. On PrestaShop 1.7 and later, customer identification reads the logged-in customer object in the browser. On 1.6, the module supplies the customer data from PHP. Your team manages agents, widget appearance, routing, wording, offline forms, and conversations in Tawk.to.
Use Hide chat to hide the widget. Hiding from the widget asks for confirmation. Your choice is retained in this browser tab’s session storage. Use Open chat at the bottom of the page to reopen it. Consent withdrawal or a definitive internal-traffic exclusion stops an active chat. The module also hides chat while supported storefront overlays are open.
Verification and troubleshooting
- Start in a clean visitor browser. Employee exclusion can suppress chat in your usual back-office browser.
- Confirm that a rule matches or that the fallback has both valid IDs.
- If you use consent management, grant functional consent, then trigger interaction or wait for the fallback.
- Confirm the correct property receives a test message. Test the logged-in identity setting separately.
- Hide and reopen chat. Test your mobile setting and each rule’s language, group, page, and login conditions.
If there is no footer control, check the footer hook for your PrestaShop version and your theme. Reopen Configure to let the module reconcile its hook registrations. If no script loads, check consent, the internal-traffic decision, the mobile setting, and a prior hidden choice. If the external script fails, check browser network errors and blocking rules.
The Integrity page checks installation and configuration. Diagnostic controls are also available on the configuration page. When diagnostics are active, the browser console can inspect mprtawkChat.debugReport(). License, Support, and Update remain maintenance pages.
Disable or uninstall
Turn off Enable Tawk.to Chat and save to retain settings and rules. Uninstall in the module manager to remove this module’s settings, widget-rule schema, menu entries, and its internal-traffic overrides. The shared internal-traffic policy remains. Your Tawk.to account and conversations remain with Tawk.to.
Questions
No questions about this module yet
Ask anything about installation, compatibility or setup. Answers appear here.
Known Issues
11
Dutch chat labels remained untranslated
Setup warning stayed after saving
Chat covered shop overlays
Chat close control misplaced
Chat never loaded without interaction
Chat disabled in inactive shops
Chat settings menu placed incorrectly
Legacy Tawk.to settings not retained
Chat widget missing from the storefront footer
Duplicate chat widgets
Missing chat translations
Feature Requests
8
Implemented
One-click module updates
Multilingual interface
Installation checks and repair
Tawk.to live chat
Deferred chat loading
Consent and visibility controls
Internal traffic exclusion
Visitor text per language
Changelog
v1.2.02026-07-22
- AddedPS 9 / Hummingbird theme compatibility
- Addedvisitor monitoring — passes cart total and product name to Tawk.to visitor info
- Improvedtrigger configuration — custom auto-message on product pages
- Fixedwidget appearing on checkout confirmation page when suppression rule set
Older releases
v1.1.162026-06-08
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedInteraction-triggered chat widget loading
- FixedPrevent duplicate tawk widget embed
- FixedRender tawk chat in footer
- FixedMigrate legacy Tawk chat settings
- FixedRepair tawk chat admin parent menu
v1.3.02026-04-20
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedadmin menu management via MenuInstaller for streamlined module setup
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
v1.1.02025-06-11
- Addedunlimited-agent note in back office linking to Tawk.to pricing page
- Addedticketing mode toggle — route offline messages to ticket system
v1.0.02025-05-07
- Initialrelease: Tawk.to free live chat integration for PrestaShop
- InitialAutomatic widget script injection with configurable property ID and widget ID
- InitialBack-office configuration with connection-test link
- InitialCompatible with PS 1.7.x and PS 8.x
Demo
Test the full module before you buy
Buy a licence later and keep your settings.
- Your 30-day demo Test it on your own shop for 30 days from the first install.
- Ready demo shop Explore a ready demo shop in your browser.
- No registration No account, email or store domain needed.
By downloading, you accept the demo terms and privacy policy.
By opening this demo you accept the demo terms and the privacy policy.