Why Livezhat®?
A real time chat is the best solution for customer service and sales: a survey made by Northstar Research shows that customers prefer to use a real time chat rather than calling a toll-free phone number or writing an email when service is needed. Livezhat® is a complete real time chat service that is ready to use. You can serve your customers on your homepage, on Facebook or anywhere else on the web. The Livezhat® service is administered online with a web browser, so you can serve your customers anywhere. Livezhat has an extremely high level of security: did you know that the religious confession is one of the most protected articles in the Finnish law? We made the data security airtight, which meant that the church was able to use the Livezhat® service and take the priests online. You can now benefit from the same security level as well. Livezhat® is the most popular chat service in Finland. It is used by over three hundred organizations.Log on to Livezhat
You can log on to Livezhat with your email address and password on www.livezhat.com.
Back to top
First time user: Order the activation link for your new password by email
After your email address is added to the Livezhat service, you can order a password activation link by writing your address in the correct field and clicking Login on the page www.livezhat.com.
When you have clicked Log in, you will see the view shown in picture 2. Click ”You can do it here”.

After clicking ”You can do it here”, you will see the view shown in picture 3.

Write your email address in the right field and click Send. After this, you will receive an email shown in picture 5. Back to top
Click the password activation link in the email message
When you have received the email, you can order a new password by clicking ”this link”.
Back to top
Write the new password
When you have clicked the link shown in picture 5, you will see the view shown in picture 6. Now you can provide a new password. After filling out the form, click Change.
After clicking Change, you will see the view shown in picture 7. Your password has now been changed. If you are not able to change your password, it is possible that your email address is not registered or that you are logged on to the Livezhat service.

Login to Livezhat
Provide your email address and password on www.livezhat.com. (or in the view shown in picture 7).
Back to top
View after login
When you have logged on to Livezhat® with your email address and your password, you will see the view presented in the picture below. In our example, you can see five different chats. You can use one or more chats that are custom-made for you.
Back to top
Chats, the operator’s view

Back to top
Chat, the customer’s view

Back to top
Visitors
On the Visitors page, you see the current visitors on your page and you can start a chat with them if you like. You are provided with useful information about your customer, such as the page the customer is visiting, IP address, country and how much time the customer has spent on the current page.
Back to top
Settings [tab Own settings]
This page lets you change your chat’s general settings, such as language, time zone and notifications about new chat discussions. You can also manage blocked IP addresses on this page. Each device that is connected to the internet uses an IP address for identification. Only you can decide which IP addresses are blocked, and you can easily block an address while chatting, if your chat partner is behaving inappropriately. Usually it is useful to unblock the IP address a while after the incident, since it is possible that the person behaving badly has used Livezhat with other users on a shared IP address at a school or a company. If you block an IP address that is used by multiple customers, it is possible that you block many potential customer service opportunities as well.
Back to top
Settings [tab Manage]
If you have administrator rights, you can find the Manage tab on the Settings page (Picture 14). The fields under the heading Company allows you to define the email address the customer can contact when the operator is not online in Livezhat. This requires that this feature is turned on in the settings. The Operators box shows the settings for the chat operators. The name provided is the name that the customers will see on the chat. The last line on the list allows you to add new operators. Under the heading Zhats, you can define the chat settings. In this view, you choose the chat operators and you can specify all the predefined replies and automatic answers that are used during the chat. Next we will take a look on how to change the chat features. This is done by clicking Edit.
Back to top
Settings [tab Manage – change the chat’s features]
You can change the chat features by clicking the Edit link, found under the heading Zhats shown in picture 15. Please see the explanations under each picture.
Name: The Zhat’s name is specified for internal use so that the operators can choose the right chat.
Key: The key is important when using an embed code. An embed code is the program code in html-format that you use to put Livezhat on your company’s webpage or Facebook-page.
Operators on this zhat: this shows a list of all operators. You can choose operators separately for each chat.
Restrictions for number of active chats: should there appear more customer service situations than you can handle, it is probably best to restrict the number of discussions. An operator can effectively serve 1-3 discussions at a time. Here the default value 0 means an unrestricted number of discussions. You learn as you go whether it is necessary to limit the number of discussions. We recommend that in the beginning, you do not restrict the number of discussions and use the default value 0.
Contact when operators are offline: you can define whether the customer is able to send an email through the chat window when no operators are online. We recommend that you allow contact through email.
Forward chats received by email to company email address: please choose this alternative if you want the customer to be able to send an email through the chat window when no operators are online.
Operator can start the zhat: if you would like to surprise your customers by starting a customer service chat on your own initiative, please choose this alternative.
Function Operator can exclusively handle chat: the customer feels that the service provided during the customer service process is better, if the service is provided by a single operator from start to finish. If this function is turned on, there is a box in each chat window that can be ticked by the operator to show that he or she is handling the discussion in question. If the box is ticked, the other operators won’t even see the chat.
Track visitors: if this function is turned on, you can track real time information about the visitors on your page, such as their IP address and country.
Automatic answers: if your customers frequently ask similar questions, for example about the store’s opening hours, you can create automatic answers based on certain words such as ”store” and ”opening hours”. If an automatic answer is defined for the message in which the words ”store” and ”opening hours” occur, Livezhat automatically tells the customer the opening hours with a message that has been written in advance.
Show Browser and Operating System: should you choose to use this feature, you get information about which browser and operating system your customers use. This is usually a very useful feature.
Save discussion: by allowing this feature, the discussions are saved. When discussing confidential matters, we recommend that you do not save the discussions. In other cases, we recommend that you do use this feature.
Sending files to customers you can send files, such as offers or manuals, to customers if this feature is turned on.
Show IP addresses: if you use this feature, you will see your visitors’ IP addresses.
How many days to keep chats: If you need to make sure that the chat history is not saved for more than a month, for example, write 30 in this field.The default value 0 means that all chats are saved.
Welcome text: Your customer will see this welcome text when opening Livezhat. We have chosen to greet the customer with ”Hello, how can we assist you? Please write your contact details below, if you would like to receive more information on the phone.”
Livezhat’s style
Even though research shows that the customer does not really care about the appearance of the chat, you can change Livezhat’s appearance if you like. Instructions for this can be found under Zhats on the Settings tab. Click Edit to change the appearance. In the lower right corner of the window, you can find the link ”Edit chatbox style”. If you click this link, you can download the CSS file you need to change the style. You can edit the file with any word processing software.
Instructions for embedding Livezhat
It is easy to embed Livezhat and you only need basic skills in html, the language used to make internet pages. If the instructions seem complicated, please contact us. Our contact information can be found at the beginning.
Livezhat is loaded and ready to use
– with http connection:– with https connection:
– This alternative works for both connection types, but to be honest, we have not tested it sufficiently with the oldest web browsers.
Add Livezhat to your page with this:
parameters for addZefLivezhat invitation:
Obligatory parameters:
– companyId: the company’s id (can be found on the Settings page when logging on to the administrators Livezhat)
– zhatId: the zhat-id (can be found on the Settings page when logging on to the administrators Livezhat)
Optional parameters:
– autoshow: ”yes”, when you want the chatbox to always open when the operator is online. If you choose ”no” or if the parameter is missing, the chat is opened only when the page calls the function openLivezhat().
– theme: the css that provides the chat style (see chapter Embed Livezhat)
– hideOnClose :”yes” if you would like the whole chatbox to disappear when the customer closes the discussion. ”no” or empty: the chatbox minimizes on closing.
– embedElement: jquery selector (for example . chatDiv or #chatDiv osv) when the chat is added to the page’s contents. If this parameter is given, the chat is not opened in its own floating div or view, but it is shown on the page contents in the given element and empties this element from its other contents.
– lang: the language used in the chat’s default texts (for example: ”Operator not online”), “fi”, “en”, “sv”, “ee”, “ru”, etc.
– shownCallback: a function called upon when Livezhat has been shown.
All the parameters’ values are given within the ’parameter_value’, except for the function shownCallback.
Next we will take a look at Livezhat’s JavaScript interface.
Livezhat Javascript Interface
The JavaScript interface is available once the livezhat.js file has been loaded by the browser. Usually the file is placed in thesection of your document. Please note: Currently it’s not possible to load the file with JQuery script function.
This document describes the public functions that can be used when integrating Livezhat.
Start a new chat session:
function
openLivezhat();
description
Starts a new chat session at the server. If a chat session has already been started, the operator will be notified and the chat box will be opened (if hidden) but no new session will be started.
parameters
no parameters
return value
no return value
function
openLiveZhat(callback);
description
Starts a new chat session at the server. If a chat session has already been started, the operator will be notified and the chat box will be opened (if hidden) but no new session will be started. When the call to the server has been successfully finished and the chat session is open, the callback function will be called
parameters
callback function to call when the chat has been opened
return value
no return value
function
showLiveZhat(callback);
description
Shows the chat box for the user. Note! If the chat session is not open, no chat is yet opened. Only when the user types his/her first message, the chat session opens and the operator is notified. The optional callback parameter can be used to get notified when the chat is visible.
parameters
callback function to call when the chat has been opened
return value
no return value
function
setLivezhatParameter(paramName, paramValue);
description
Set integration parameter value. These values will be visible to the chat operator if configured from the chat settings page.
parameters
paramName – name of the parameter as entered in the chat setings
paramValue – value of the parameter
return value
no return value
function
setOnlineCallback(onlineCallback, offlineCallback);
description
Set function callbacks that will be called when the operator status has been queried from the server.
parameters
onlineCallback – function which will be called if the operator is online
offlineCallback – function which will be called if the operator is offline
return value
no return value
function
setOperatorText(componentId, onlineText, offlineText, emailText, busyText);
description
Set text to a component based on the operator status. The text will be set when the operator status has been queried from the server.
parameters
componentId – jquery selector of the component where the text will be set
onlineText – text that will be set to the component when the operator is online
offlineText – text that will be set to the component when the operator is offline
emailText – text that will be set to the component when the operator is offline and chat has been configured to accept emails
busyText – text that will be set to the component when the operator status is busy
Note! emailText and busyText parameters can be left out
return value
no return value
function
setStatusCallback(statusFunctionCallback);
description
Set callback function to handle operator status. The function will be called when the operator status has been received from the server. The callback function should accept one parameter which will include the operator status as text.
Possible statuses are:
‘online’ – operator is online and accepting chats
‘offline’ – operator is not online
‘email’ – operator is not online but chat is accepting emails
‘busy’ – operator is / operators are busy (maximum number of chats per operator reached)
parameters
statusFunctionCallback – function that Livezhat will call with the status
return value
no return value
function
startLivezhatOnlineChecking(onlineCallback, offlineCallback, busyCallback);
description
Start polling the operator status from livezhat server. After each poll, the corresponding callback function is called. This is useful in ajax application when the html host page doesn’t change often or in situation where users don’t navigate away from the page often.
parameters
onlineCallback – function that will be called if operator is online
offlineCallback – function that will be called if the operator is not online (offline or email status)
busyCallback – function that will be called if the operator is busy
return value
no return value