roramirez/qpanel

The Dashboard for Queues/CallCenter in Asterisk and FreeSWITCH

Overview

QPanel is a panel for queues on Asterisk and FreeSWITCH, powerful and simple monitor in realtime:

• General resume for calls. Abandoned, Incoming, Answer time and Waiting time.
• Show information on detail by queue.
• Show agents status if these are free, busy or unavailable.
• Pause reason and time to agents.
• Percent of abandoned calls.
• Allows rename the queue name or hide in case if required not show a determined queue.
• Show callers by queue with the priority and wait time.
• Spy, Whisper and Barge for agents on queues.
• Show service level of queues
• Hangup incomming calls
• Authentication Access.
• Simple configuration. Just use Asterisk manager.
• Multi languages availables: English, Spanish, German, Russian and Portuguese.
• Written on Python.
• Responsive design.
• Opensource by MIT licence.

Also you can use a API of QPanel for data query related to queues

Requirement

• Python 3.6+
• Asterisk 1.4+ and enabled manager or FreeSWITCH and connection permission to Event Socket Library.

The feature to scheduler reset stats for the queues is required Redis >= 3.0.0. If you run the QPanel as service (WSGI) you need reset stats using the script run-worker.py in supervisord or other process control system.

Asterisk

On /etc/asterisk/manager.conf do you set command permission for read and write, example:

    [qpanel]
    secret = mi_super_secret_password
    read = command
    write = command,originate,call,agent

AMI options

• originate for spy, whisper and barge.
• call feature hangup calls.
• agent remove agents from the queues.

Some features maybe not included in your Asterisk version. In the patch directory you can find the patchs for add more powerfull to the QPanel.

Freeswitch

The feature realtime counter for answered and abandoned calls in a queues if not included in your FreeSWITCH version. In the patch directory you can find the patch

You can configure a freeswitch section for your config.ini file like

    [freeswitch]
    host = 127.0.0.1
    port = 8021
    password = ClueCon

In general section set config

    ; Use FreeSWITCH as backend. Use mod_callcenter
    freeswitch = True

To use a FreeSWITCH need install SWIG. In system Debian base run

 apt-get install swig
 pip install -r requirements/fs.txt

1. Clone this repository

 git clone https://github.com/roramirez/qpanel.git

2. Install dependencies

 $ pip install -r requirements.txt

If dont have pip in your system. For install

Debian and Ubuntu

sudo apt-get install python-pip

Fedora

sudo yum install python-pip

Get Javascript, CSS and external web libraries

Is necessary have installed Node.

   npm install

3. Go and prepair environment

 cd qpanel
 cp samples/config.ini-dist config.ini

Edit config.ini file with Manager Asterisk parameters

Note: Can set the absolute path for configuration file in an enviroment variable called QPANEL_CONFIG_FILE.

4.- Translations

 pybabel compile -d qpanel/translations

5.- Run and relax

   python app.py

Go url of machine http://IP:5000

If you want run QPanel like a service, see the samples configurations files. There are a example for use with uWSGI + NGINX

QueueLog Stats for Asterisk

You could use the stats for queue of Asterisk from QueueLog. If need more informacion about this go Stats, Realtime and other things or see the section [queue_log] of the sample configuration file

New features?

If you like new features or something is wrong please open a issue

If you want check the development version get checkout of develop branch

git clone -b develop https://github.com/roramirez/qpanel.git

Updating source new in a release

Go the QPanel directory

    cd qpanel

Get the new code

    git pull

Update dependencies

    pip install -r requirements.txt
    npm install

Notes

Errors

pip update

For error in instalation process of requirements. UserWarning: python_requires requires setuptools version > 24.3 pip install --upgrade setuptool

How to contribute

• Fork the project
• Create a feature branch (git checkout -b my-feature)
• Add your files changed (git add file_change1 file_change2, etc..)
• Commit your changes (git commit -m "add my feature")
• Push to the branch (git push origin my-feature)
• Create a pull request

Happy coding :)