> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringingo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Create a Call Queue

> Hold inbound callers in a Ringingo queue and distribute them to available agents using ring strategy, timeouts, and priorities.

Call Queues hold inbound callers in a waiting pool until an agent becomes available. The queue plays hold music or comfort messages and distributes callers to agents based on the configured algorithm.

<Steps>
  <Step title="Navigate to Call Queue">
    Go to **Incoming Rules → Call Queue** in the left sidebar menu.
  </Step>

  <Step title="Create a new Call Queue">
    Click **+ Create Call Queue**.
  </Step>

  <Step title="Fill in the core settings">
    | Field                          | Description                                                                                                                                                                              |
    | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Name (required)                | A unique identifier (e.g. "Support-Queue", "Sales-Q1").                                                                                                                                  |
    | Strategy (required)            | The agent selection algorithm: **Round Robin** (rotating sequence), **Least Recent** (agent idle longest), **Ring All** (all ring simultaneously), or **Linear** (fixed priority order). |
    | Welcome Prompt                 | Audio played once when the caller enters the queue. Select from Settings → Audio Prompts.                                                                                                |
    | Call Waiting Prompt (required) | The recurring audio or hold music played while the caller waits.                                                                                                                         |
    | Call Queue Timeout             | Maximum seconds a caller can wait before being routed to the fallback destination. If blank, callers wait indefinitely.                                                                  |
    | Agent Timeout                  | Seconds an agent's device rings before moving to the next available agent.                                                                                                               |
    | Call Mode                      | Set to PBX for standard SIP-based call routing.                                                                                                                                          |
    | Status                         | Enable to activate immediately.                                                                                                                                                          |
  </Step>

  <Step title="Assign agents">
    In the **Extension** section, assign agents:

    | Field          | Description                                                                     |
    | -------------- | ------------------------------------------------------------------------------- |
    | Extension Name | A display label for this agent slot (optional).                                 |
    | SIP Device     | The specific registered SIP device for the agent.                               |
    | Position       | The agent's position number for ordered strategies.                             |
    | Level          | The priority tier within the queue. Lower-level agents are offered calls first. |
  </Step>

  <Step title="Add more agents and save">
    Click **+ Add More** to add additional agents. Click **Save**.
  </Step>
</Steps>

<Warning>
  Always configure a fallback destination for Call Queues. If the queue fills to its maximum capacity or the timeout expires, callers with no fallback destination are being disconnected.
</Warning>

<Tip>
  For a well-functioning queue, ensure at least 3 to 5 agents are assigned. A single-agent queue creates a single point of failure.
</Tip>