Tawk.to Chat Integration: setup and help

Quick start

  1. Upload and install the mprtawkchatintegration ZIP in Modules > Module Manager.
  2. Click Configure. In Tawk.to Configuration and Fallback Widget, leave Enable Tawk.to Chat set to Yes.
  3. Copy the two values from your Tawk.to embed URL into Fallback Property ID and Fallback Widget ID.
  4. 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.
  5. Click Save. Test the storefront in a separate visitor browser so the employee traffic exclusion does not hide chat.
  6. If MPR Cookies Revolution is enabled, allow the functional category for chat. Scroll, click, touch, press a key, or wait for the 10-second fallback.
  7. 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.

Verification and troubleshooting

  1. Start in a clean visitor browser. Employee exclusion can suppress chat in your usual back-office browser.
  2. Confirm that a rule matches or that the fallback has both valid IDs.
  3. If you use consent management, grant functional consent, then trigger interaction or wait for the fallback.
  4. Confirm the correct property receives a test message. Test the logged-in identity setting separately.
  5. 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

ResolvedUpdated:
Fixed in: 1.4.11
Dutch chat labels could fail to use their available translations.

Setup warning stayed after saving

ResolvedUpdated:
Fixed in: 1.4.11
The installation warning could continue to show a missing setting immediately after it was saved.

Chat covered shop overlays

ResolvedUpdated:
Fixed in: 1.4.3
The Tawk.to widget could sit above the shop overlays and obstruct their controls.

Chat close control misplaced

ResolvedUpdated:
Fixed in: 1.4.3
The close control could fail to follow the chat launcher or bar, including while scrolling.

Chat never loaded without interaction

ResolvedUpdated:
Fixed in: 1.4.3
Chat loading depended entirely on shopper interaction, so passive visitors could never receive the widget.

Chat disabled in inactive shops

ResolvedUpdated:
Fixed in: 1.4.3
Installation checks could inadvertently turn off chat settings for inactive shops.

Chat settings menu placed incorrectly

ResolvedUpdated:
Fixed in: 1.1.13
The Tawk.to settings menu could appear under an incorrect back-office parent menu.

Legacy Tawk.to settings not retained

ResolvedUpdated:
Fixed in: 1.1.16
The integration did not migrate previously stored Tawk.to settings.

Chat widget missing from the storefront footer

ResolvedUpdated:
Fixed in: 1.1.16
The configured chat widget did not render through its footer placement.

Duplicate chat widgets

ResolvedUpdated:
Fixed in: 1.1.16
The Tawk.to widget could be embedded more than once on a page.

Missing chat translations

ResolvedUpdated:
Fixed in: 1.1.16
Some chat integration labels and messages did not have translations.

Feature Requests

8

Implemented

One-click module updates

Implemented
Check for and install module updates from the back office.

Multilingual interface

Implemented
Use translated module labels and messages in French, German, Spanish, Italian and Polish.

Installation checks and repair

Implemented
Check the module installation and restore missing back-office menu entries.

Tawk.to live chat

Implemented
Connect a Tawk.to widget so shoppers can contact the shop from the storefront.

Deferred chat loading

Implemented
Load the chat widget after shopper interaction to reduce initial page loading work.

Consent and visibility controls

Implemented
Control where the chat appears and wait for the required consent, including consent managed by Cookies Revolution.

Internal traffic exclusion

Implemented
Exclude employees and configured internal IP addresses from chat, with a module-specific override.

Visitor text per language

Implemented
Configure visitor-facing chat text separately for each shop 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.
Launch demo shop

By downloading, you accept the demo terms and privacy policy.

By opening this demo you accept the demo terms and the privacy policy.

Loading...
Back to top