

This directory contains example pieces of dialplan to be used in order to 
implement QueueMetrics' advanced functions (e.g. listening to ongoing calls,
agents logging on and off, setting call statuses, etc...)

Please note that the supplied dialplan examples are NOT "plug and play"; you 
must change them to suit your configuration!

In order to get started, first copy the dialplan example to your /etc/asterisk
and #include it in the master dialplan adding the following line at the bottom
of your extensions.conf:

#include extensions_queuemetrics.conf

The included file is made up of a context named [queuemetrics] where the
different functions are implemented. In order to run them, QueueMetrics
will originate a call through the Manager API or a call-file, will set
the correct variables and will jump to the required functionality. 

===========================================================================

Things you must change to suit your needs:
1. all telephone extensions in the example are relative to a context named 
"from-internal". This is the default on FreePBX based systems.
If your default endpoint context is called 'default' or 'agents' or whatever
else, you must edit the file manually.

============================================================================

The included file also has a context named queuedial (and other conxtexts named 
qm-queuedial, macro-queuedial-answer, macro-queuelog) that are useful to implement 
outbound calling in QueueMetrics with full event logging.

There is also a context named queuedial-loggedon that only lets logged-on agents
dial out and automatically detects the agent number.



Example files:
--------------
* extensions_queuemetrics.conf
This file will work with a plain vanilla, true-agents based call-center setup.

* extensions_queuemetrics_freepbx2.11
This file will work with FreePBX 2.11 allowing log-in and log-off procedure 
directly from the QueueMetrics agents page.
You should rename to extensions_queuemetrics.conf and copy to /etc/asterisk folder
replacing the existing one, if present. You then need to add the following 
line:

#include extensions_queuemetrics.conf 

in the /etc/extensions_custom.conf file provided by FreePBX.

You should enable the local channel rewriting in the configuration.properties file
setting the key

default.rewriteLocalChannels=true

Known limitations:
- When running in hotdesking mode is not possible to use the login/logout
procedure by phone
- When running in hotdesking mode is not possible to have overlapping agent's
code and extension numbers


---------------------------------------------------------
$Id: README.txt,v 1.5 2013/02/27 11:23:25 marcos Exp $

