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.
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.
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.
Step 2: Add the customized Kommunicate plugin to your website
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.
|appId||String||A unique application ID assigned to your Kommunicate account.|
|botIds||Array of strings||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||String||All conversations will have this title until the conversation gets assigned to the bot/agent. After conversation assignment, the conversation title will be the name of bot/agent whom the conversation is assigned.|
|preLeadCollection||Array of objects||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||String||This is your user’s/visiter's user ID. Kommunicate will generate a random ID if this is not defined.|
|userName||String||This is the display name of the user. Agents will identify users by this display name.|
|String||Email ID of the user. If not online, the user will be notified by fallback emails sent to this email ID.|
|onInit||Function||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.|
|attachment||Boolean||Default: true |
if you want to disable the attachment option in the chat widget, set this parameter to ‘false’.
|emojilibrary||Boolean||Default: false |
Emoticons library will be available in the chat widget if this parameter is set to true.
|locShare||Boolean||Default: false |
If you want to enable location sharing in the chat widget, set this parameter to true.
|msgTriggerTimeout||Integer||This will automatically start a conversation with a user after the user has spent a certain amount of time on your website and if the conversation has already been created before then last unread message notification will come. |
msgTriggerTimeout will open the conversation in below cases:
1. When a user comes to your website for the first time.
2. If a user has any unread message.
msgTriggerTimeout will not open the conversation if:
1. The last message is sent by the user and does not have any unread messages.
You can define the trigger time like this: "msgTriggerTimeout": 10000 (Note: the time is set in milliseconds).
Note: You have to set "automaticChatOpenOnNavigation" parameter to false as this option won't be compatible with msgTriggerTimeout.
|openConversationOnNewMessage||Boolean||Default: false |
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||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.
|popupWidget||Boolean||Default: false |
Setting this parameter to true will change the position of the “chat widget close button” which will now appear on the launcher icon itself, such that your users can open and close the chat widget from the same button. By default, when it is false, the close button appears at the top right corner of the chat widget.
Note: The custom launcher icon is not supported if this option is set to true.
|voiceInput||Boolean||Default: false |
set it true to enable the voice input.
This feature is only supported in Google chrome versions >= 33.0
|sessionTimeout||Integer||Default: null |
- This will automatically create a new user after a certain amount of time which you're passing for sessionTimeout parameter i.e. after a certain period of time if anyone else uses the same system then they are recreated as a new user and can’t access the chat history of the previous user.
- If you have set this parameter's value to X milliseconds than the new user will only get created if the user is starting afresh session and time difference between the first session and a new session is greater than sessionTimeout value.
- If the user is continuing the chat and sessionTimeout value is crossed, in that case, a new user won't get created until the user closes the tab.
- You can define the timeout time like this: "sessionTimeout": 10000 (Note: the time is set in milliseconds).
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: