Live chat

From ISPWiki
Revision as of 19:07, 8 July 2016 by Ksenya (talk | contribs)
Jump to: navigation, search

Installation

In order to install a chat, navigate to "Integrations" --> "Modules"

After you have installed the chat, you will need to add SSL certificates. The chat is running via https. You can also configure departments at this step, see the information below.


Chat-certificate.png

Chat configuration

To start using the chat, you will need to configure a list of departments who will be able to work in chat, as well as list of staff members from those departments.

Departments

In order to configure departments, navigate to the Providers module --> Edit

Departments.png

1. Available departments - a list of all departments, for which the chat is available. It also includes incoming departments.

2. Incoming departments - a list of departments that receive chats from clients. Then, a staff member can forward the chat to one of the available departments.

Staff members

You should grant access to chat to every staff member from department.

Staff.png

The icon in the "Parameters" column indicates that a staff member can answer in Live chat.

Staff1.png

Adding live chat to your web-site

In order to add a live chat to your web-site, add two js-script into the page code:

<script type="text/javascript" src="https://BILLURL:3002/js/index.js"></script>
 
<script type="text/javascript">
   if (window.billChat)  {
       billChat.init({
           project: PROJECT_ID,
           lang: 'ru',
           backgroundColor: '#99c21c',
           borderColor: '#CCC',
           baseUrl: 'https://BILLURL:3002/'
       });
   }
</script>


  • BILLURL - URL of the billing panel or server where chat is located.
  • PROJECT_ID - project id in the billing panel (for BILLmanager Standard and Advanced it is always 1)
  • lang - client's interface language, e.g. en
  • backgroundColor - background color of client's interface.
  • borderColor - border color of client's interface.

Chat configuration file

The configuration file is located in /usr/local/mgr5/etc/billmgr.conf.d/chat.conf

ChatDbHost localhost

ChatDbUser chat

ChatDbPassword NfutsDB9Qq

ChatDbName chat

ChatDbConnectionLimit 100

path ChatSslKey ../sslcert/chat.key

path ChatSslCert ../sslcert/chat.crt

ChatSecret aqSL2VNvZM

ChatPort 3002

ChatUrl https://cent7:3002

ChatEmployeeName chatemployee

ChatEmployeePassword k9lxkHeMs2

Parameters:

  • ChatDb* - chat database configuration
  • path ChatSsl* - relative paths to files of SSL certificates
  • ChatPort - port number
  • ChatUrl - chat server URL
  • ChatEmployee* - staff member, which synchronizes chat history with the billing panel, and creates incoming messages from client.


Restart the billing panel to apply the changes:

killall core

Restarting chat server

Execute the following command in order to restart the chat server:

systemctl restart billchat.service

Logs

Use the command to view logs:

journalctl -u billchat

To view real-time logs, specify -f:

journalctl -u billchat -f

General scheme

Chat scheme.png