Synopsis:

 Dynamically adds queue members

Description:

  AddQueueMember(queuename[|interface][|penalty]):

Dynamically adds interface to an existing queue (i.e. the interface "logs on" to the queue, as an agent does with AgentCallbackLogin).

If the interface is already in the queue and there exists an n+101 priority
then it will then jump to this priority. Otherwise it will return an error.

Notice: AddQueueMember action does not produce any output to queue_log. To solve this refer to http://lists.digium.com/pipermail/asterisk-dev/2005-February/009615.html. A more comprehensive solution, tested with the QueueMetrics log ananlyzer, is presented at http://astrecipes.net/?n=100.
Also see this patch that adds a new QueLog command http://bugs.digium.com/view.php?id=7368

There is a patch for app_queue that allows AddQueueMember and RemoveQueueMember to create log entries - http://bugs.digium.com/view.php?id=7736

Return codes

Returns -1 if there is an error.

Once run, this also sets a variable of AQMSTATUS which is set to one of the following:

• ADDED
• MEMBERALREADY
• NOSUCHQUEUE

 

Example:

  AddQueueMember(techsupport|SIP/3000)

Using just AddQueueMember(<queuename>) will add the caller device to the members.
- <queuename> is the name of the queue in queues.conf

See also

• Asterisk cmd RemoveQueueMember: Dynamically removes queue members (agent)
• Asterisk cmd PauseQueueMember
• Asterisk cmd UnpauseQueueMember
• Asterisk config queues.conf
• Asterisk call queues
• OrderlyQ - Extension to Asterisk Queues that lets callers hang up, then call back without losing their place.
• Asterisk Queue Information

---

Asterisk | Applications | Functions | Variables | Expressions | Asterisk FAQ