Installation

Overview

Kommunicate is live-chat and chatbots powered customer support software. Kommunicate allows you to add live chat on your website that enables you to chat with your website visitors and customers using a beautiful chat widget.

Installing Kommunicate is fast and easy. Just add a few lines of code in your website and you can start answering your support queries within a few minutes. Kommunicate can also be used with any of Website Builder.

Web installation

Step 1: Get the customized plugin script from Kommunicate dashboard

Create your account by signing up for Kommunicate. You can signup for free in Kommunicate. If you already have a Kommunicate account, log in to your account and go to the Install section and copy the script.

Or

You can copy the below script and replace required parameters manually.

Note: Use web server to view HTML files as real-time updates will not work if you directly open the HTML file in the browser.

Script

<script type="text/javascript">
    (function(d, m){

    /*---------------- Kommunicate settings start ----------------*/

     var kommunicateSettings = {
      "appId": appId,
      "conversationTitle":conversationTitle
      /*
      "onInit": function (){
        // paste your code here
      },
        "botIds":["bot1","bot2"]
      */
      };

    /*----------------- Kommunicate settings end ------------------*/

     var s = document.createElement("script");
      s.type = "text/javascript";
      s.async = true;
      s.src = "https://api.kommunicate.io/v2/kommunicate.app";
      var h = document.getElementsByTagName("head")[0];
      h.appendChild(s);
      window.kommunicate = m;
      m._globals = kommunicateSettings;
    })(document, window.kommunicate || {});
</script>

Step 2: Add the customized Kommunicate plugin to your website

We recommend adding the plugin script to your website template so that it automatically goes into each page of your website. Make sure to place Kommunicate plugin script before the closing Body tag.

You can customize the plugin by passing below parameters in the kommunicateSettings object. Visit Settings -> Install section in Kommunicate dashboard to get default values for your account.

Parameters	Descriptions
appId	A unique application ID assigned to your Kommunicate account.
botIds	You can add bots to any conversation by passing an array of bot IDs. Example array: "botIds":["bot1","bot2"]. Bot IDs will be visible in the Bot section in the dashboard if you have created any bot.
conversationTitle	All conversations will have this title.
preLeadCollection	This will enable lead collection in chat. Users will be asked to enter the name, email and phone number when they start a conversation.
userId	This is your user’s/visiter's user ID. Kommunicate will generate a random ID if this is not defined.
userName	This is the display name of the user. Agents will identify users by this display name.
email	Email ID of the user. If not online, the user will be notified by fallback emails sent to this email ID.
onInit	This function will be called after the chat plugin is initialized. Here, you can define the actions to be done after the plugin is initialized.
emojilibrary	Emoticons library will be available in the chat widget if this parameter is set to ‘true’.
locShare	If you want to enable location sharing in the chat widget, set this parameter to ‘true’.
msgTriggerTimeout	This will automatically start a conversation with a user after the user has spent a certain amount of time on your website. You can define the trigger time like this: "msgTriggerTimeout": 10000 (Note: the time is set in milliseconds).
openConversationOnNewMessage	If this parameter is set to ‘true’, the chat window will be opened whenever a new message comes in the chat widget. For more detail check openConversationOnNewMessage.
automaticChatOpenOnNavigation	Type: Boolean Default: false If the chat widget is open and the user navigates to some other section in the website or to some other tab, then keep the chat widget open with the current active conversation Note: Kommunicate.startConversation() method and msgTriggerTimeout option won't be compatible with this option.

Install on website builders or Content Management Systems (CMS)

We have written step by step instructions if you are using website builder tools or CMS for your website:

• Wordpress
• Squarespace
• Wix
• Shopify