Skip to end of metadata
Go to start of metadata

Queue()

Synopsis

Queue a call for a call queue.

Description

In addition to transferring the call, a call may be parked and then picked up by another user.

This application will return to the dialplan if the queue does not exist, or any of the join options cause the caller to not enter the queue.

This application does not automatically answer and should be preceeded by an application such as Answer(), Progress(), or Ringing().

This application sets the following channel variable upon completion:

  • QUEUESTATUS - The status of the call as a text string.
    • TIMEOUT
    • FULL
    • JOINEMPTY
    • LEAVEEMPTY
    • JOINUNAVAIL
    • LEAVEUNAVAIL
    • CONTINUE

Syntax

Queue(queuename,options,URL,announceoverride,timeout,AGI,macro,gosub,rule,position)
Arguments
  • queuename
  • options
    • C - Mark all calls as "answered elsewhere" when cancelled.
    • c - Continue in the dialplan if the callee hangs up.
    • d - data-quality (modem) call (minimum delay).
    • h - Allow callee to hang up by pressing *.
    • H - Allow caller to hang up by pressing *.
    • n - No retries on the timeout; will exit this application and go to the next step.
    • i - Ignore call forward requests from queue members and do nothing when they are requested.
    • I - Asterisk will ignore any connected line update requests or any redirecting party update requests it may receive on this dial attempt.
    • r - Ring instead of playing MOH. Periodic Announcements are still made, if applicable.
    • R - Ring instead of playing MOH when a member channel is actually ringing.
    • t - Allow the called user to transfer the calling user.
    • T - Allow the calling user to transfer the call.
    • w - Allow the called user to write the conversation to disk via Monitor.
    • W - Allow the calling user to write the conversation to disk via Monitor.
    • k - Allow the called party to enable parking of the call by sending the DTMF sequence defined for call parking in features.conf.
    • K - Allow the calling party to enable parking of the call by sending the DTMF sequence defined for call parking in features.conf.
    • x - Allow the called user to write the conversation to disk via MixMonitor.
    • X - Allow the calling user to write the conversation to disk via MixMonitor.
  • URL - URL will be sent to the called party if the channel supports it.
  • announceoverride
  • timeout - Will cause the queue to fail out after a specified number of seconds, checked between each queues.conf timeout and retry cycle.
  • AGI - Will setup an AGI script to be executed on the calling party's channel once they are connected to a queue member.
  • macro - Will run a macro on the called party's channel (the queue member) once the parties are connected.
  • gosub - Will run a gosub on the called party's channel (the queue member) once the parties are connected.
  • rule - Will cause the queue's defaultrule to be overridden by the rule specified.
  • position - Attempt to enter the caller into the queue at the numerical position specified. 1 would attempt to enter the caller at the head of the queue, and 3 would attempt to place the caller third in the queue.

See Also

Import Version

This documentation was imported from Asterisk Version SVN-branch-1.8-r408447

  • No labels

2 Comments

  1. Is it possible put parameters when using the AGI argument?

    Something like this..
    Queue(queuename,,,,5,AGI(VARIABLE1,VARIABLE2))

    Thanks in advance.

    André Emerich

    1. The wiki is not meant for questions regarding deployment and configuration. As this page is automatically updated when the documentation for the Queue application is updated, any comments regarding its usage will be lost.

      If you have questions about deploying the Queue application, please e-mail the asterisk-users list.