dedayoa / qpanel

Dashboard for Queues in Asterisk and FreeSWITCH. app_queue panel for Asterisk and mod_callcenter in FreeSWITCH

Qpanel

Qpanel is dashboard for Queues 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 2.6, 2.7, 3.4
• Flask 0.10+
• Asterisk 1.4+ and enabled manager or FreeSWITCH and connection permission to Event Socket Library.

The feature to scheduler reset stats a queue is required Redis Redis >= 2.6.0

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 ofor 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

    freeswitch = True ; Use FreeSWITCH as backend. Use mod_callcenter

If you used a CentOS 5.X or Elastix check how to install Python 2.6 and Flask

1. Clone this repository

 git clone -b stable  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

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

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 master branch

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

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 :)