Dynamic Routes Example configuration

Set the queue priority of callers, allowing "top" customers to receive a faster answer

Use case

Your customer help line has a single queue for calls. However, your customer database allows to identify the importance of customers. You would like to give a better level of service to some customers, so that their calls are answered on a priority basis.

This makes use of the queue priorities functionality. See here for details.

Database

In this example priority callers will be identified by their phone number (callerid column). The lookup will be configured to return the value from the priority column. A lookup value of "normal" will not change the queue priority. A lookup value of "top" will be used to set a priority of 1. Higher priority callers are answered before lower priority callers, so customer with a "top" priority will be answered before customers with a "normal" priority.

callerid	priority
12345678	normal
23456789	normal
34567890	top

The dynamic routing module does not actually create the database, table, user to access the database or grant permissions. These are assumed to existing already. If you need help setting up please follow Creating_a_MySQL_table_for_use_with_Dynamic_Routes this example.

Let's assume that you have created a table caller "customer_priority" in database "customer" and it has the columns "callerid" and "priority" as in the above table. Your sql lookup would be

SELECT priority FROM customer_priority WHERE callerid like '%[NUMBER]'

Dynamic Routes will substitute the [NUMBER] symbol for the incoming callerid if one is present.

We will also assume that the database is located on the localhost and that there is a user of "dr_user" and password "xxxxxxxx". If possible you should verify that you can connect to the database and execute a select query on the table, for example:

mysql -u dr_user -p
use customer
SELECT * FROM customer_priority;

Setup Instructions

1. It is assumed you already have a queue called "Customer Service". Set up a new Queue priority with a value of 1 to make it higher than the default value of 0

2. Setup a dynamic route in Freepbx (Menu Applications -> Dynamic Routes) with the following details:

Field name	Value
Dynamic Route Name	Customer priority
Dynamic Route Description	Sets the priority of callers before sending them to a queue
Enable DTMF Input	No
Announcement	None
Timeout	blank
Validation	blank
Invalid Retries	blank
Invalid Retry Recording	None
Invalid Recording	None
Invalid Destination	Do not set this value
Saved input varibale name	None
Saved result variable name	None
Source Type	MySQL
MySQL hostname	localhost
MySQL database	customer
MySQL username	dr_user
MySQL password	xxxxxxxx
MySQL query	SELECT priority FROM customer_priority WHERE callerid like '%[NUMBER]'
Default Destination	Queue: Customer Service
Dynamic Route Entries	Match: top; Destination: Queue Priorities - Top Priority Customers
	Match: normal; Destination: Queues - Customer Service

Here is a screen shot of the Dynamic Route configuration:

File:Dr page2a.png

3. Instead of setting your incoming route to the Customer Service Queue, set it to the Dynamic Route.

4. Make some test calls to try the configuration.