JivoChat Integration: setup and help

Connect your shop to JivoChat. You need an existing service account and its Widget ID. Configure conversations and the visible widget in the service account.

The module's Configure action opens JivoChat Configuration. The configuration 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 the Widget ID from the installation code for your website channel in JivoChat. The setup panel points to Manage > Channels > Website widget. Paste the identifier only. Do not paste an entire URL or script.

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

Set these fields in JivoChat 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

When Pass Customer Data is enabled and the customer is logged in, the module registers window.jivo_onLoadCallback before loading the widget. When JivoChat invokes it and jivo_api is available, it sends the customer name and email through jivo_api.setContactInfo. Set the option to No to omit this handoff.

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 trigger the loader. Without interaction, wait for the configured fallback. The shared loader removes the inner template delay, so the two waits are not added together. 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:

//code.jivosite.com/widget/{Widget ID}

Open the widget and send a test message. Check that it reaches the service inbox. Finally, test the excluded pages and mobile devices.

Manage operators, channels, routing, offline forms and automation in JivoChat. This module supplies the storefront widget loader and display rules.

• If no loader is output, check Enable JivoChat, Widget ID, 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 the logged-in customer name or email is missing, check Pass Customer Data, reload the page and check for errors or another integration replacing window.jivo_onLoadCallback.
• 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/mprjivochat/views/templates/hook/displayBeforeBodyClosingTag.tpl

to:

themes/your-theme/modules/mprjivochat/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 MPRJIVO_ prefix for submitted field names. Current storage uses module mprjivochat in the shared mpr_config table, with short keys:

ENABLED
WIDGET_ID
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 JivoChat 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.