Viciboard, A Free Dashboard For Vicidial®

Unable to find a solution that satisfied a client's need, I created this dashboard for Vicidial that anyone can use.

My name is Burk Morrison. I'm a Vicidial consultant, installer, and customizer. I built this responsive (responsive meaning it'll format itself for your desktop, tablet, or smartphone) dashboard for Vicidial, it's open-source and available on GitHub. It shows you cool stuff like how many agents are logged in, how many calls they've taken (all with graphs that update every few seconds), and more. Additionally, ViciBoard caches its results, so if you have multiple managers running multiple ViciBoards across all their devices, everything will remain fast and responsive (without bringing your server to its knees).

ViciBoard can secure itself using your existing Vicidial usernames and passwords if you check the "Use Vicidial Auth?" checkbox in ViciBoard's settings page!

Installation is free:

Step 1: Get root access to one of your Vicidial servers. It needs to be a server that serves webpages to your agents.

Step 2: Navigate to the directory that serves up webpages from your server. For a server installed with the Vicibox Server ISO, I'd use "cd /srv/www/htdocs".

Step 3: You might get a nasty SSL error unless you update all the certificates in your server. Thankfully, it's pretty easy to do: "zypper install ca-certificates{,-cacert,-mozilla}".

Step 4: Clone ViciBoard into a directory: "git clone https://github.com/bmorrison/ViciBoard.git viciboard".

Step 5: Grant permissions to allow ViciBoard to write its caching files: "chmod 777 -R viciboard".

Step 6: Navigate to this directory using your web browser. Your new ViciBoard should load into the browser window: "http://YOUR_SERVER_IP/viciboard/index.php".

Step 7: Click the "Settings" button and make your changes as need. Usually it's simply whether you'd like to use Vicidial's user authentication and your refresh rate. You shouldn't need to change anything in the (optional) boxes.

Step 8: Navigate back to the Dashboard page, and click the orange "Reset Stats" button to kick everything off.

Step 9: Enjoy!

Extra Credit: Want your ViciBoard to collect data even when someone isn't viewing it? Simply add this line to the server's crontab ("crontab -e"): "*/5 * * * * /usr/bin/curl --silent http://localhost/viciboard/rolling_agent_stats.php > /dev/null 2>&1"

Note: ViciBoard needs several hours to populate all the data it uses to display its graphs. I imagine there are going to be better ways to collate this information, too. As time goes on and I make improvements to ViciBoard, hopefully it'll get better!

Questions? Please drop me a line and I’ll do my best to answer them.