{"id":2537,"date":"2025-04-27T19:45:23","date_gmt":"2025-04-27T19:45:23","guid":{"rendered":"https:\/\/wiki.xontel.com\/?post_type=manual_documentation&p=2537"},"modified":"2026-07-10T16:01:18","modified_gmt":"2026-07-10T16:01:18","slug":"queue","status":"publish","type":"manual_documentation","link":"https:\/\/wiki.xontel.com\/ar\/documentation\/pbx\/pbx-v-1-x-x\/pbx\/call-features\/queue\/","title":{"rendered":"Queue"},"content":{"rendered":"

The Queue section is used to manage call queues within the PBX system. Queues help distribute incoming calls to assigned agents or extensions based on the selected strategy, allowing calls to wait until an available agent can answer.
<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Add Queue<\/strong><\/p>\n\n\n\n

The Add Queue section is used to create a new call queue and define how incoming calls are distributed to assigned members.<\/p>\n\n\n\n

Basic<\/strong><\/p>\n\n\n\n

The Basic tab defines the primary queue configuration, including queue identity, agent behavior, call distribution, and member assignment.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Queue Title<\/strong>: Defines the name used to identify the queue.<\/p>\n\n\n\n

Queue Number<\/strong>: Defines the number used to access or route calls to the queue.<\/p>\n\n\n\n

CID Name Prefix<\/strong>: Adds a prefix to the caller ID name for calls delivered from the queue.<\/p>\n\n\n\n

Autofill<\/strong>: Allows the queue to distribute multiple waiting calls to available agents when supported.<\/p>\n\n\n\n

Strategy<\/strong>: Defines how calls are distributed to queue members.<\/p>\n\n\n\n

Skip Busy Agent<\/strong>: Prevents calls from being sent to agents who are currently busy.<\/p>\n\n\n\n

Join Announcement<\/strong>: Selects an announcement played to callers when they enter the queue.<\/p>\n\n\n\n

Music On Hold Type<\/strong>: Defines the hold audio played while callers wait in the queue.<\/p>\n\n\n\n

    \n
  • Default<\/strong>: Plays the default music on hold for this queue.<\/li>\n\n\n\n
  • MOH Only<\/strong>: Plays the selected music on hold playlist for this queue.<\/li>\n\n\n\n
  • Agent Ringing<\/strong>: Plays a ringing tone instead of music on hold while the caller waits.<\/li>\n<\/ul>\n\n\n\n

    Agent Timeout (s)<\/strong>: Defines how long an agent rings before the call is offered to another agent or retried.<\/p>\n\n\n\n

    Max Waiting Time (s)<\/strong>: Defines the maximum time a caller can remain waiting in the queue.<\/p>\n\n\n\n

    Retry (s)<\/strong>: Defines the delay before retrying available agents.<\/p>\n\n\n\n

    Wrap Up Time (s)<\/strong>: Defines the time reserved after a completed call before the agent receives another queue call.<\/p>\n\n\n\n

    Static Extensions<\/strong>: Defines the extensions assigned as queue members.<\/p>\n\n\n\n

    Failover Destination<\/strong>: Defines where calls are routed if the queue is not answered or the waiting limit is reached.<\/p>\n\n\n\n

    Caller Announcement<\/strong><\/p>\n\n\n\n

    The Caller Announcement tab is used to configure periodic announcements played to callers while they are waiting in the queue.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Periodic Announcement<\/strong>: Selects the announcement played to callers during the waiting period.<\/p>\n\n\n\n

    Repeat<\/strong>: Enables or disables repeated playback of the periodic announcement.<\/p>\n\n\n\n

    Repeat Timeout<\/strong>: Defines the interval between repeated announcements.<\/p>\n\n\n\n

    Capacity Options<\/strong><\/p>\n\n\n\n

    The Capacity Options tab is used to control queue capacity and caller entry behavior.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Max Callers<\/strong>: Defines the maximum number of callers allowed to wait in the queue.Set to \u201c0\u201d for unlimited callers.<\/p>\n\n\n\n

    Join Empty<\/strong>: This option determines whether new callers will be admitted to the queue when no agents are available. The available options include:<\/p>\n\n\n\n

      \n
    • Yes<\/strong>: Always allows the caller to join the queue.<\/li>\n\n\n\n
    • Strict<\/strong>: Allows callers to join the queue only if agents are available or currently ringing another call. If no agents can answer, the caller will not be admitted.<\/li>\n\n\n\n
    • Ultra Strict<\/strong>: Similar to “Strict,” but more stringent. A queue member must be available to answer immediately, meaning agents who are currently engaged or ringing for another call are considered unavailable.<\/li>\n\n\n\n
    • No<\/strong>: Callers will not be admitted if all agents are paused, in an invalid state, or have penalty values less than the QUEUE_MAX_PENALTY<\/code> (if not defined in the FreePBX dialplan).<\/li>\n\n\n\n
    • Loose<\/strong>: Similar to “No,” but callers will be admitted if paused agents are available to answer.<\/li>\n<\/ul>\n\n\n\n

      Leave When Empty<\/strong>: Determines whether callers should be exited from the queue when it appears no agents are available to take the call. The options include:<\/p>\n\n\n\n

        \n
      • Yes<\/strong>: Callers will exit the queue if all agents are paused, in an invalid state, or have penalty values less than the QUEUE_MAX_PENALTY<\/code>.<\/li>\n\n\n\n
      • Strict<\/strong>: Same as “Yes,” but more strict. If no agent can answer, the caller will leave the queue. If agents are engaged with other calls, the caller will remain in the queue.<\/li>\n\n\n\n
      • Ultra Strict<\/strong>: Similar to “Strict,” but more stringent. Callers will leave the queue if no agent is available to answer the call immediately, even if other agents are available but currently busy.<\/li>\n\n\n\n
      • Loose<\/strong>: Similar to “Yes,” but callers will remain in the queue if paused agents could potentially become available.<\/li>\n\n\n\n
      • No<\/strong>: Callers will never leave the queue until the maximum wait time has expired.<\/li>\n<\/ul>\n\n\n\n

        <\/p>","protected":false},"author":1,"featured_media":0,"parent":2525,"menu_order":0,"template":"","manualdocumentationcategory":[16],"manual_doc_tag":[],"class_list":["post-2537","manual_documentation","type-manual_documentation","status-publish","hentry","manualdocumentationcategory-xontel-doc"],"_links":{"self":[{"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/manual_documentation\/2537","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/manual_documentation"}],"about":[{"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/types\/manual_documentation"}],"author":[{"embeddable":true,"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":11,"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/manual_documentation\/2537\/revisions"}],"predecessor-version":[{"id":9119,"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/manual_documentation\/2537\/revisions\/9119"}],"up":[{"embeddable":true,"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/manual_documentation\/2525"}],"wp:attachment":[{"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/media?parent=2537"}],"wp:term":[{"taxonomy":"manualdocumentationcategory","embeddable":true,"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/manualdocumentationcategory?post=2537"},{"taxonomy":"manual_doc_tag","embeddable":true,"href":"https:\/\/wiki.xontel.com\/ar\/wp-json\/wp\/v2\/manual_doc_tag?post=2537"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}