Integrating QueueMetrics with a Fonality PBX

Version 0.4, Loway


Table of Contents

1. Installing QueueMetrics on a TrixboxPRO or PBXtra system
1.1. Call centers 101: the very basics
1.2. Requirements and deployment scenario
1.3. Known limitations
1.4. Open issues
2. Installation guide
2.1. Performing a basic QueueMetrics installation
2.2. Install Fonloader on the PBX
2.3. Configuring QueueMetrics
3. Frequently Asked Questions (FAQs)
3.1. Q1 - Can I install QueueMetrics on Windows?

Revision history:

All trademarks are the property of their respective owners.

1. Installing QueueMetrics on a TrixboxPRO or PBXtra system

This tutorial explains how to install a working QueueMetrics system on a Fonality TrixboxPRO or PBXtra system.

1.1. Call centers 101: the very basics

Before we start building a small call center, we have to focus a bit on the terminology:

  • A campaign is a set of calls that belong to the same scope, e.g. your technical support versus commercial support line are different campaigns, though they may be staffed by the same agents.
  • An inbound campaign is devoted to answering people calling in, while an outbound campaign is made up by agents dialing out. Call centers often mix inbound and outbound activities in order to optimize the use of available personnel.
  • A queue is the physical implementation of an inbound campaign. The queue receives calls and pipes them to the available agents according to a predefined logic (usually, FIFO for the calls and round-robin for the agents). In call center terminology, this functionality is often referred to as the ACD (Automated Call Distribution).
  • An agent is a person working at a call center. The agent is different from a casual user as an agent logs in and out, in order to tell the system when he is available or not. In this way, the ACD searching logic minimizes agent searching time, as it almost never has to ring up an agent who is not available.

An agent can be working on one or more queues: whenever he is available, all calls coming in to any queue he’s working on will be piped to him.

1.2. Requirements and deployment scenario

In the course of this tutorial, we will assume that you will be installing QueueMetrics on a different system from your main PBX; this scenario offers many advantages (the most important one being not loading the PBX when running very large reports) but requires a distinct physical or virtual server.

The following steps are required:

  • perform a basic installation of QueueMetrics and its database on a separate box
  • install a piece of software (Fonloader) on the PBX to send data to QM
  • configure QueueMetrics

As QueueMetrics is a complex piece of software, this tutorial only covers its installation in a Fonality environment. The main QueueMetrics manual applies for all that is not specified here, and it can be found at: http://queuemetrics.com/manual_list.jsp

1.3. Known limitations

The following known issues/limitations are present with the ciurrent version of the loader:

  • Audio listening: it is impossible to listen to recorded files on the Fonality server
  • No manager events: you cannot send commands to the PBX over QM
  • Agents page: logon-logoff buttons do not work
  • Logins: "teleworker" agent logins are not supported.
  • Queue exits: if a queue can terminate without routing a call to agents (e.g. because of a timeout) the PBX does not log this correctly, so such calls will linger on for a while in the realtime reports.

1.4. Open issues

The following issues will be fixed for this manual.

  • Time zones - setting QM to handle different time zones if not in EST.