Live chat

From ISPWiki
Jump to: navigation, search


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.


Make sure that port 3002 is open in the Firewall on the server, where BILLmanager is installed.

Attention! Saving a certificate chain on CentOS servers may cause issues with authenticating staff members in Live chat. To resolve the issue, delete the certificate chain, or update (install) nodejs from the official web-site (you don't need to upgrade nodejs version)

Attention! Debian 8 uses the standard nodejs package.You need to upgrade it to a new version (>= 6.13)

wget -O /root/ ''
sh /root/
apt-get install nodejs
cd /usr/local/mgr5/etc/scripts
npm install ejs

Database management system on a remote serverе

If database is disabled on the server, where you install chat module. You should create file etc/billmgr.conf.d/chat.conf with settings before plugin installation:

ChatDbHost localhost 
ChatDbUser billchat
ChatDbPassword dbpassword
ChatDbName billchat
ChatDbConnectionLimit 100
path ChatSslKey ../sslcert/chat.key
path ChatSslCert ../sslcert/chat.crt
ChatSecret {Произвольная строка}
ChatPort 3000
ChatUrl https://CHATSERVER:3000
ChatEmployeeName chatemployee
ChatEmployeePassword chatemployee_password

In this way module won't try to conncet to database during the installation, so it will be installed without errors.

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.

Chat domain

Note! A client area can run only on the domain name specified in Provider configuration form -- "Site URL".

If the chat's domain is specified in /etc/hosts, where it is assigned to IP, make sure ihttpd listens to


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


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.


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


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 (inside the BODY tag):

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

  • 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.

A certain code for your billing panel can be found in provider's settings.

Working place

To start a Live chat with your customers, you need to navigate to your "working place"

Go to the Dashboard -- "Open chat" or click "Open chat" in the main menu. For correct authorization, log in from the domain name that is specified in "Provider - Billing URL". For example, if is specified in the configuration form, you won't be able to log in to your working place from IP:1500/billmgr

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


  • 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


Use the command to view logs:

journalctl -u billchat

To view real-time logs, specify -f:

journalctl -u billchat -f

Synchronizing chat history with the billing system

The synchronization process starts along with the chat, every 15 minutes.

General scheme

Chat scheme.png