Smartsupp Chat Integration: setup and help

You need an existing service account and its Website Key. Configure conversations and the visible widget in the service account.

The module’s Configure action opens Smartsupp Configuration. This page also shows a required-configuration notice and an integrity banner. Use the module’s Configuration, Integrity, License, Support and Update pages for the corresponding maintenance work.

Find the connection value

Copy _smartsupp.key from your Smartsupp chat installation code. The form points you to Settings > Chat box. Paste the identifier only. Do not paste an entire URL or script.

The default is empty. For new or changed identifiers, the module expects 16 to 128 letters, numbers, hyphens or underscores. A rejected identifier keeps the previous saved configuration. Correct the value and save again.

Set these fields in Smartsupp Configuration, then click Save.

Page groups

Targeting uses controller names. A custom checkout controller outside this list is not included by Checkout Pages Only. There is no custom URL-rule field. Show on Mobile uses PrestaShop mobile detection rather than browser width alone.

Customer fields

The module connects using _smartsupp.key. When customer data passing is enabled, it also passes the logged-in customer’s email (_smartsupp.email) and name (_smartsupp.name) to Smartsupp.

Guests do not receive PrestaShop customer identity fields from this module. The service can still collect information through its own widget. This module does not synchronize order history or cart contents.

Example configuration

For checkout pages on desktop, choose Checkout Pages Only, set Show on Mobile to No, and set Fallback Delay (seconds) to 2. The loader starts on the first interaction or after two seconds without interaction.

The module registers displayBeforeBodyClosingTag. It first checks the enable switch, connection value, device rule and page rule. It then places a deferred loader near the end of the page.

Scroll, click, touch or press a key to start loading. Without interaction, wait for the configured fallback. This is the total wait, with no additional delay afterwards. With the installation default 0, allow 10 seconds before treating an idle page as a loading failure.

In browser developer tools, check for a request matching:

https://www.smartsuppchat.com/loader.js?

Open the widget and send a test message. Check that it reaches the service inbox. Test a logged-in account if you enabled Pass Customer Data, and verify which identity fields the service receives. Finally, test the excluded pages and mobile devices.

Manage operators, availability, notifications, recordings and chatbots in Smartsupp. The module does not create an account or configure those service features.

• If no loader is output, check Enable Smartsupp Chat, Website Key, Show on Pages and Show on Mobile.
• If the page is idle, wait for the fallback or interact with it. Fallback Delay (seconds) set to 0 does not mean immediate loading.
• If saving fails, keep the identifier filled in, check its format, reload the configuration page and retry. Do not use placeholder credentials for a live test.
• If the external request fails, check browser console errors, script blocking, Content Security Policy and any consent tooling on your shop.
• If the script loads but the launcher is absent, check your service-side widget publication, account availability and display rules.
• If a customer field is missing, log in and confirm Pass Customer Data is Yes. Compare with the exact fields listed above.
• If another integration also inserts the service script, check the rendered page for duplicate or conflicting installation code.

Check a custom theme

Your theme must execute the closing-body hook. A developer can restore this call before </body> where the theme lacks it:

{hook h='displayBeforeBodyClosingTag'}

For a theme template adjustment, copy:

modules/mprsmartsupp/views/templates/hook/displayBeforeBodyClosingTag.tpl

to:

themes/your-theme/modules/mprsmartsupp/views/templates/hook/displayBeforeBodyClosingTag.tpl

Keep the module's Smarty variables and identifier escaping. The shared interaction wrapper still applies to this hook template.

The form uses the MPRSMART_ prefix for submitted field names. Current storage uses module mprsmartsupp in the shared mpr_config table, with short keys:

ENABLED
WEBSITE_KEY
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

The database table uses your shop's table prefix, so ps_mpr_config is only an example name. Use the configuration form for normal changes. Do not treat form-field names as the current database keys.

Set Enable Smartsupp Chat to No and save with the identifier still present to pause this module's output. You can also disable the module in Module Manager.

To remove it, use Uninstall in Module Manager and confirm. The uninstall removes its module configuration and admin menu entries. It does not close the external service account or remove code inserted by another module or theme.