WhatsApp Chat Integration: setup and help

1. Open Modules > Module Manager in your back office.
2. Choose Upload a module and upload the WhatsApp Chat Integration ZIP.
3. Open Configure.
4. In WhatsApp Connection, enter your Phone Number in international digits-only format.
5. Keep Enable Widget on and save.
6. Open your storefront, scroll or click, then test the contact button.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

You edit the connection, Appearance and Behavior forms on the module configuration page. Use Save after changes. Button Text, Tooltip Text and Pre-filled Message support language-specific text. Missing language text falls back to your default language, then the stored base text.

Checkout targeting matches cart, order, order-opc, orderopc and checkout. A custom checkout controller with another name will not match that choice.

The module loads its local stylesheet through displayHeader. Your theme must execute displayBeforeBodyClosingTag or the displayFooter fallback. A render guard prevents duplicate buttons.

The button opens https://wa.me/PHONE with an optional URL-encoded text parameter. WhatsApp or WhatsApp Web handles the conversation. The module does not use the WhatsApp Business API or store messages in PrestaShop.

For a product question, set Pre-filled Message to Hi! I have a question about {product}: {url} and Show on Pages to Product Pages Only. The module replaces {product} only on product pages. On other pages that placeholder can remain literal, so use plain text and {url} for checkout help. The module provides no chatbot, shared inbox, automation or message history.

• Open a page allowed by Show on Pages and interact with it. If you do nothing, wait for the fallback timer.
• Click the button and confirm it opens your own number. Test a product page and inspect the filled message before sending it.
• If the button is absent, check Enable Widget, the required identifier, Show on Mobile and page targeting. The back office shows a configuration notice for a missing or invalid identifier. Changed identifiers are validated on save; an invalid edit keeps the previous configuration.
• If the markup is absent on every allowed page, check the render hook in your theme. If it is present but hidden, check theme CSS, JavaScript errors and overlapping fixed buttons.
• A valid digits-only number must also belong to the intended WhatsApp account. Test the link on the devices your customers use.

Override themes/your-theme/modules/mprwhatsappchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl if you need different markup. Keep your changes in the theme.

The widget ID is #mprwhatsapp-widget. Position, style and animation classes use the same prefix, such as .mprwhatsapp-bottom-right, .mprwhatsapp-bar and .mprwhatsapp-pulse. The tooltip class is .mprwhatsapp-tooltip.

You can move the button above another fixed element in your theme stylesheet:

#mprwhatsapp-widget.mprwhatsapp-bottom-right {
  bottom: calc(var(--mprwa-margin, 20px) + 50px);
}
#mprwhatsapp-widget .mprwhatsapp-tooltip {
  font-size: 12px;
}

The settings generate --mprwa-color, --mprwa-size and --mprwa-margin on the wrapper. Use the settings to change those values.

Turn off Enable Widget to stop displaying the button. To remove the module, use Uninstall in Module Manager. Uninstall removes its menu entries and stored module configuration. It does not delete conversations held in WhatsApp.