Toggle navigation

Asterisk Base Queues

The Asterisk Base Queues module is meant to be used for managing your queues from inside Odoo.

Global Queues Settings

The global Queues settings are available at PBX -> Settings -> Queues. They allow to change globally the way your queues are set up. The settings are split up in three categories:

Call Recording Settings: Are used to manage the way the calls are recorded from inside the queue.

Member Settings: contain global settings that are used for managing the members’ activity from within the queues

Queue Settings: the settings that apply to the queues themselves.

Every field from within the settings has a help message attached to it, that is visible when the mouse cursor is hovering over the field’s label. Sensible default values have been selected for the settings. Please be aware that changing the values might break OdooPBX functionality, for example changing the Call Recording Monitor Type from MixMonitor to Monitor will disable call recording imports into Odoo for the queues.

Queue Settings

You can create a new queue by going to PBX -> Applications -> Queues and clicking on the Create button. To create a queue, fill in its Name and Exten fields.

When you click on the Options tab, additional options of the queue are available. The most important options are:


  • ringall: ring all available channels until one answers (default)
  • roundrobin: take turns ringing each available interface (depreciated in 1.4, use rrmemory)
  • leastrecent: ring interface which was least recently called by this queue
  • fewestcalls: ring the one with fewest completed calls from this queue
  • random: ring random interface
  • rrmemory: round robin with memory, remember where we left off last ring pass
  • linear: Rings interfaces in the order they are listed in the configuration file. Dynamic members will be rung in the order in which they were added. (new in 1.6)
  • wrandom: Rings a random interface, but uses the agent’s penalty as a weight (new in 1.6)

Ring in Use: If checked, the queue won’t call devices that are busy

Joinempty: Specifies if an incoming call can join the queue when no members are available

Max length: The maximum number of people waiting in the line. By default it’s infinite

Adding and removing queue members

Before adding a Odoo user to the queue, check if in the Queues tab of the user the Queue Interface parameter is set correctly. The queue interface must include the channel technology and data for creating the outbound channel. For example, SIP/1234 or PJSIP/1234.

There are two ways of adding or removing the queue’s members: either by means of static or dynamic members.

A static queue member is permanently attached to the queue by the means of configuration files. To add a static member, open the queue and click on the Edit button. On the Static table click on Add a line and select the one or multiple users you need to add to the queue. You can remove the users from the queue by clicking on the Delete button on the right side of every user.

After all the changes are performed, click on the Save button and after that on Apply Changes. The generated configuration will then be delivered and applied by reloading Asterisk.

Managing dynamic users is done dynamically by using Asterisk’s APIs. Every user has the possibility of joining a queue by clicking on the Join button for the queue. After joining, he or she can also leave the queue by clicking on the Leave button. The administrators can also add and remove dynamic users as well by using an interface similar to the one for static users.