Viber Chat Integration: setup and help

On older PrestaShop versions, use the equivalent module installation page. Open this module through Configure whenever you need to return to its settings.

After saving a phone number, use the test link on the configuration page to confirm that it opens the correct Viber contact. Changed phone numbers are checked for the required format when you save. A rejected edit keeps the previous configuration. An unchanged phone number is not checked again.

You can translate Button Text and Tooltip Text using the form language controls. An empty translation follows the default language. The same language fallback applies to Pre-filled Message. Use Save after editing.

Checkout Pages Only includes the cart and checkout pages. If you use another checkout module, check that its pages are included. The fallback wait starts when the page opens. It is not an additional delay after an interaction.

The button appears only when Viber Chat is enabled, a phone number is saved, and the mobile and page settings allow it. Phone number format is checked when you save a changed number. Your theme must render displayHeader for the stylesheet and displayFooter on PrestaShop 1.6, or displayBeforeBodyClosingTag on 1.7 and later, for the widget.

After the first interaction or fallback, you see a fixed button in the selected corner. Its link opens in a new tab and uses this destination:

https://viber.me/48600123456

You configure one phone contact. Values such as 48600123456 and 0048600123456 also pass the format check, but you must test that your exact value resolves correctly in Viber. The device must be able to open Viber links. The module does not provide chat history, analytics, bots, broadcasts, or Business API automation.

Test one allowed page and one excluded page if you restrict page types. Test mobile visibility on a real device. If you use multiple languages, check the translated button text and tooltip.

For a text button on product pages, set Button Style to Bar with Text, Button Text to Ask us on Viber, Show on Pages to Product Pages Only, and Animation to none. You can choose Bottom Left when another widget uses the right corner.

If you need to move the widget above another fixed control, add a rule to your theme stylesheet:

#mprviber-widget.mprviber-bottom-right {
  bottom: 90px;
  right: 24px;
}

#mprviber-widget.mprviber-bar a span {
  font-size: 15px;
}

For a theme template override, use:

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

The template receives $mprviber with position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation, and delay, plus the prepared chat_url. The URL includes the phone number without a leading + and any encoded draft message. Keep changes in your theme so a module update does not overwrite them.

• If you see no button, check the enable switch, saved identifier, page rule, and mobile rule. Trigger an interaction or wait for the fallback.
• If an edit is rejected, enter the identifier format listed above. Do not paste an entire contact link.
• If the widget has no styling, check that your theme calls displayHeader and loads the module stylesheet.
• If the template never appears, check displayFooter on PrestaShop 1.6 or displayBeforeBodyClosingTag on 1.7 and later, and the module’s hook registration in the back office.
• If the button overlaps another control, change Position or Margin from Edge (px).
• If the button appears but the destination fails, test the saved contact and the device’s external app handler.

Changing Pre-filled Message adds or updates the ?draft= part of the storefront link. {url} is replaced with the current page URL before encoding. An empty message omits ?draft=. The contact link requires a registered Viber Business account, with or without a pre-filled message; test the storefront button because the configuration-page test link includes only the phone number.

Use the module’s Integrity page for setup and hook diagnostics. License, Support, and Update are maintenance pages rather than storefront appearance settings.

Turn off Enable Viber Chat and save to retain your configuration. The main form still requires a non-empty identifier when you save. You can also disable the module from the module list.

Use Uninstall in the module manager to remove the module configuration and its admin menu entries. Your external messaging account is not deleted.