Find the Smartsupp Plugin

On the Dashboard of Shoper, see Additions and integrations - Dodatki i integracje (1) >> Application - Aplikacje (2) >> scroll down and click on the option Smartsupp - live czat, czatbot oraz nagrania wideo (4), in order to find the Smartsupp Plugin.

Installation & Regulations

Click on the Instal application - Zainstaluj aplikację (5) button.

Check Accept the appstore T&C - Akceptuję regulamin appstore (6), then click on the Install - Instaluj (7) button.

You will get a message saying that the Smartsupp plugin was successfully installed.

Configure Smartsupp

Then go to the Add-ons and integrations - Dodatki i integracje (8) >> My applications - Moje aplikacje (9) >> Click on the Smartsupp logo icon (10).

Then you can create a new Smartsupp account (11) or if you already have one, you can directly login into your Smartsupp account (12).

Chat with customers, API

Then you can go chat with your customers (13) or adjust Smartsupp chat by using API (14). You can also use the Smartsupp JavaScript API to trigger the chat widget from custom buttons on your website. For example:

Open the chat widget:

  <button onclick="smartsupp('chat:open')">Chat with us</button>

Toggle the chat widget:
```
  <button onclick="smartsupp('chat:toggle')">Chat</button>
```
Ensure the Smartsupp widget script is loaded on your webpage before calling these methods.

Don’t forget to save the changes (15) when using the API.

Uninstallation

If you wish for any reason to uninstall your plugin, please go to Add-ons and integrations - Dodatki i integracje (16) >> click on My applications - Moje aplikacje (17) >> then click on the Smartsupp - live czat, czatbot oraz nagrania wideo (18).

Note: Smartsupp and Shoper are two separate services. If you uninstall plugin, your Smartsupp subscription will keep running. To cancel it, please contact our support.

Then, click on the Uninstall the app - ODINSTALUJ APLIKACJĘ (19) button,

and Confirm (20).

Manual code installation

If you are having trouble installing the Plugin you can try to install the code manually by adding it as a javascript snippet.

Your code is in Smartsupp - Settings - Chat box - Chat code. To customize chat visibility, apply changes to the Smartsupp embed code. For example, use conditional logic to hide the chat box on checkout or cart pages.

Note: Please be noted that the custom configuration implemented into the Shoper must look easy and avoid the HTML tags like <script> </script>. Required Look: if (window.location.href.indexOf("http://example.com/order/") > -1) { smartsupp('chat:hide'); If using embed code, integrate the following snippet to hide the chat on cart or checkout pages: If you want to use your own custom button and hide the default Smartsupp chat button, you can use the following JavaScript API method:

smartsupp('chat:hide');

Then, trigger the chat from your custom button using:

<button onclick="smartsupp('chat:open')">Chat with us</button>

This approach ensures that the default chat button is hidden while your custom button remains functional.

if (
  location.pathname.startsWith('/cart') ||
  location.pathname.startsWith('/checkout')
) {
  _smartsupp.hideWidget = true;
}

Adjust the paths to match the specific URLs of your cart and checkout.}

Note: you may need to refresh your browser in order to see changes.

Best Practices for Integration

Load the Smartsupp Script: Ensure the Smartsupp widget script is fully loaded on your webpage before calling any API methods.
Test Your Implementation: After integrating the custom button, test its functionality across different browsers and devices to ensure a consistent user experience.
Keep the Code Clean: Use descriptive names for your custom buttons and organize your JavaScript code for better maintainability.

To chat with visitors and see them on website log in to Smartsupp.

Warning: Shoper has a limitation of characters in the API field of 250 characters. When you use sign // in coding, the Shoper cannot read it, and it evaluates the code as non-functional. For example, to hide the chat widget via API, use the following code snippet and ensure it fits within Shoper's character limit: